Utilisez l'action resize pour mettre à l'échelle les images selon une largeur, une hauteur ou un pourcentage spécifique. Cette fonction s'avère utile lorsque votre plateforme ou application exige des dimensions d'image précises, par exemple pour les photos de profil, les vignettes ou les ressources adaptées à différentes densités d'écran.
La fonction de modification d'images d'Alibaba Cloud CDN, la fonction de modification d'images de DCDN et la fonction Image Processing (IMG) d'Object Storage Service (OSS) sont trois fonctionnalités distinctes et ne peuvent pas être utilisées de manière interchangeable.
La modification d'images est gratuite jusqu'à nouvel ordre.
La conversion entre formats d'image (par exemple, de JPEG vers WebP ou de PNG vers WebP) peut générer un fichier plus volumineux, car chaque format utilise des algorithmes de compression différents. Pour réduire la taille du fichier de sortie, définissez le paramètre quality afin de diminuer la qualité de l'image.
Limites
L'action
resizeréduit uniquement la taille des images. Si les dimensions cibles dépassent celles de l'original, l'image est renvoyée sans modification.Si vous attribuez une valeur négative à n'importe quel paramètre, l'image reste inchangée.
Le nombre total de pixels de l'image de sortie ne doit pas excéder 16 777 216 pixels.
Paramètres
Action : resize
| Paramètre | Nom complet | Description | Valeurs valides |
|---|---|---|---|
w |
Width | Largeur cible en pixels. | Entier. Valeur par défaut : 0. |
h |
Height | Hauteur cible en pixels. | Entier. |
l |
Longer side | Longueur cible du côté le plus long. | Entier. |
s |
Shorter side | Longueur cible du côté le plus court. | Entier. |
fw et fh |
Fixed width and height | Largeur et hauteur cibles auxquelles vous souhaitez redimensionner l'image. | Entier. |
p |
Percentage | Taille cible exprimée en pourcentage des dimensions d'origine. Le rapport d'aspect est conservé. | Entier, [0, 100]. |
Exemples
Tous les exemples utilisent image_process=resize comme paramètre de requête pour appliquer l'action resize.
| Scénario | Exemple d'URL |
|---|---|
| Réduire à 80 % de la taille d'origine | example.com/image01.png?image_process=resize,p_80 |
| Redimensionner uniquement si le fichier atteint au moins 1 024 000 octets | example.com/image01.png?image_process=resize,l_200/threshold,1024000 |
| Redimensionner selon le côté le plus long (200 px) | example.com/image01.png?image_process=resize,l_200 |
| Redimensionner selon le côté le plus court (200 px) | example.com/image01.png?image_process=resize,s_200 |
| Redimensionner selon la largeur (200 px) | example.com/image01.png?image_process=resize,w_200 |
| Redimensionner selon la hauteur (200 px) | example.com/image01.png?image_process=resize,h_200 |
| Redimensionner à une largeur et une hauteur exactes (200 x 200 px) | example.com/image01.png?image_process=resize,fw_200,fh_200 |
Dans l'exemple de redimensionnement conditionnel, le paramètre threshold indique la taille de fichier minimale en octets. Le redimensionnement de l'image n'a lieu que si sa taille atteint ou dépasse ce seuil. Ajustez la valeur selon vos besoins.