DocumentationExperience Cloud KCS

AEM Dynamic Media : conserver les proportions lors du redimensionnement des images

Dernière mise à jour : 29 juillet 2026

Cet article explique comment s’assurer que la diffusion d’images Dynamic Media Adobe Experience Manager conserve les proportions d’origine lors du redimensionnement des images à l’aide des paramètres de largeur et de hauteur.

Description description

Environnement

Adobe Experience Manager Dynamic Media (toutes les versions)

Symptômes

Lors de la diffusion d’images via le point d’entrée OpenAPI Dynamic Media et de la spécification des paramètres de requête width et height, l’image renvoyée ne conserve pas les proportions d’origine. Au lieu de cela, l’image de sortie est forcée à un carré ou utilise la plus petite dimension pour la largeur et la hauteur, ce qui entraîne un dimensionnement inattendu. Cela se produit même lorsque les dimensions d’origine de la ressource ne sont pas carrées.

Exemple :

  • Dimensions d’origine de la ressource : 2 336 × 2 400 (image/webp)
  • Demandes et résultats observés :
  • ?width=1000 → 1 000 × 1 000
  • ?height=1000 → 1 000 × 1 000
  • ?width=1000&height=500 → 500 × 500
  • ?width=1500&height=500 → 500 × 500

Comportement attendu : l’image doit être redimensionnée pour s’adapter à la zone englobante demandée tout en conservant les proportions d’origine (par exemple : 2 336 × 2 400 mises à l’échelle proportionnellement pour s’adapter à la zone comprise entre 1 000 × 500).

Comportement observé : la sortie d’image est carrée ou ne correspond pas aux proportions attendues, quelles que soient les dimensions d’origine.

Références:

Résolution resolution

Suivez les étapes ci-dessous pour résoudre le problème :

  1. Vérifiez l’URL de diffusion de l’image et assurez-vous de spécifier les paramètres de width et de height souhaités.

  2. Pour conserver les proportions d’origine et faire tenir l’image dans le cadre de sélection demandé, ajoutez le paramètre fit=contain à l’URL de diffusion.

  3. Testez l’URL mise à jour dans un navigateur ou un client API. L’image renvoyée doit maintenant tenir dans les dimensions spécifiées tout en conservant son format d’origine (par exemple : 487 × 500 pour une image de 2 336 × 2 400 mise à l’échelle pour tenir dans une plage de 1 000 × 500).

  4. Pour plus d’informations sur les paramètres pris en charge, consultez la documentation officielle :

recommendation-more-help
experience-cloud-kcs-help-kbarticles