Visualizza immagini Ultra HDR

Il formato immagine Ultra HDR consente alle immagini di memorizzare più informazioni sull'intensità della luce, con un risultato di ombre e alte luci più dettagliate e colori più intensi. Android supporta le immagini Ultra HDR a partire da Android 14 (livello API 34). Se la tua app è in esecuzione su queste versioni, è importante configurarla per visualizzare correttamente queste immagini. D'altra parte, se la tua app non mostra immagini Ultra HDR, puoi risparmiare risorse del dispositivo disattivando la visualizzazione Ultra HDR. In questa pagina viene spiegato come verificare se la grafica supporta Ultra HDR e come visualizzarla correttamente.

Verificare la presenza di una mappa dei profitti

Le immagini Ultra HDR contengono una mappa di guadagno. La mappa del guadagno viene utilizzata per determinare l'aumento della luminosità di ciascun pixel dell'immagine. Per verificare se un'immagine è in formato Ultra HDR, converti l'immagine o l'elemento Drawable in un Bitmap e chiama Bitmap.hasGainMap() (disponibile da Android 14) per verificare se ha una mappa di guadagno.

Configurare la finestra per visualizzare Ultra HDR

Per visualizzare le immagini Ultra HDR con l'intera gamma dinamica, imposta la modalità di colore della finestra su ActivityInfo.COLOR_MODE_HDR. A tale scopo, chiama il metodo setColorMode() della finestra. Queste API sono disponibili da Android 8; tuttavia, le immagini non vengono visualizzate in Ultra HDR, a meno che sul dispositivo non sia installato Android 14 o versioni successive.

Riassumendo

Il seguente codice mostra l'intera procedura. Questo codice presuppone che un'immagine sia caricata in un bitmap e controlla se l'immagine ha una mappa di guadagno. In questo caso, il codice imposta la modalità di colore della finestra su COLOR_MODE_HDR. Se l'immagine non ha una mappa di guadagno, il codice imposta la finestra sulla modalità di colore predefinita.

Kotlin

val bitmap = /* Get Bitmap from Image Resource */
binding.imageContainer.setImageBitmap(bitmap)

// Set color mode of the activity to the correct color mode.
requireActivity().window.colorMode =
   if (bitmap.hasGainmap()) ActivityInfo.COLOR_MODE_HDR else ActivityInfo.COLOR_MODE_DEFAULT

Java

final Bitmap bitmap = /* Get Bitmap from Image Resource */
binding.imageContainer.setImageBitmap(bitmap);

// Set color mode of the activity to the correct color mode.
int colorMode = ActivityInfo.COLOR_MODE_DEFAULT;
if (bitmap.hasGainmap()) colorMode = ActivityInfo.COLOR_MODE_HDR;
requireActivity().getWindow().setColorMode(colorMode);

Risorse aggiuntive

Per scoprire di più sulle immagini Ultra HDR, consulta le seguenti risorse aggiuntive: