DocumentazioneExperience Cloud KCS

Dynamic Media di AEM: mantieni le proporzioni durante il ridimensionamento delle immagini

Ultimo aggiornamento: 29 luglio 2026

Questo articolo spiega come garantire che la consegna delle immagini Dynamic Media di Adobe Experience Manager mantenga le proporzioni originali quando si ridimensionano le immagini utilizzando i parametri di larghezza e altezza.

Descrizione description

Ambiente

Adobe Experience Manager Dynamic Media (tutte le versioni)

Sintomi

Quando si distribuiscono le immagini tramite l’endpoint OpenAPI Dynamic Media e si specificano sia i parametri di query width che quelli height, l’immagine restituita non mantiene le proporzioni originali. Al contrario, l’immagine di output viene forzata in un quadrato o utilizza la dimensione più piccola sia per la larghezza che per l’altezza, con conseguente dimensionamento imprevisto. Ciò si verifica anche quando le dimensioni originali della risorsa non sono quadrate.

Esempio:

  • Dimensioni risorsa originale: 2336 × 2400 (immagine/webp)
  • Richieste e risultati osservati:
  • ?width=1000 → 1000 × 1000
  • ?height=1000 → 1000 × 1000
  • ?width=1000&height=500 → 500 × 500
  • ?width=1500&height=500 → 500 × 500

Comportamento previsto: L’immagine deve essere ridimensionata per adattarsi al riquadro di delimitazione richiesto mantenendo le proporzioni originali (ad esempio: 2336 × 2400 ridimensionate in modo proporzionale per adattarsi a 1000 × 500).

Comportamento osservato: l’output dell’immagine è quadrato o non corrisponde alle proporzioni previste, indipendentemente dalle dimensioni originali.

Riferimenti:

Risoluzione resolution

Per risolvere il problema, segui i passaggi seguenti:

  1. Rivedi l’URL di consegna dell’immagine e assicurati di specificare i parametri width e height desiderati.

  2. Per mantenere le proporzioni originali e adattare l’immagine al riquadro di delimitazione richiesto, aggiungi il parametro fit=contain all’URL di consegna.

  3. Verifica l’URL aggiornato in un browser o in un client API. L’immagine restituita deve ora rientrare nelle dimensioni specificate mantenendo le proporzioni originali (ad esempio: 487 × 500 per un’immagine 2336 × 2400 ridimensionata per rientrare in 1000 × 500).

  4. Fai riferimento alla documentazione ufficiale per ulteriori dettagli sui parametri supportati:

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