Wyświetlaj obrazy ultra HDR

Format obrazu ultra HDR pozwala przechowywać więcej informacji o intensywności światła, co skutkuje bardziej szczegółowymi podświetleniami i cięciami oraz bardziej intensywnymi kolorami. Android obsługuje obrazy w ultra HDR od wersji Android 14 (poziom API 34). Jeśli Twoja aplikacja działa na tych wersjach, musisz skonfigurować ją tak, aby prawidłowo wyświetlać te obrazy. Jeśli jednak aplikacja nie wyświetla obrazów w ultra HDR, możesz oszczędzać zasoby urządzenia, nie włączając wyświetlania w ultra HDR. Na tej stronie wyjaśniamy, jak sprawdzić, czy grafika obsługuje tryb Ultra HDR, oraz jak ją prawidłowo wyświetlić.

Sprawdzanie, czy istnieje mapa wzmocnienia

Zdjęcia w formacie ultra HDR zawierają mapę wzmocnienia. Mapa wzmocnienia służy do określenia zwiększonej jasności każdego piksela na obrazie. Aby sprawdzić, czy obraz jest w formacie Ultra HDR, przekonwertuj obraz lub obiekt rysowany na obraz Bitmap i wywołaj funkcję Bitmap.hasGainMap() (dostępną od Androida 14), aby sprawdzić, czy zawiera on mapę wzmocnienia.

Konfigurowanie okna w celu wyświetlania obrazu w formacie Ultra HDR

Aby wyświetlać obrazy w trybie Ultra HDR z pełnym zakresem dynamicznym, ustaw tryb kolorów okna na ActivityInfo.COLOR_MODE_HDR. W tym celu wywołaj metodę setColorMode() okna. (te interfejsy API są dostępne od Androida 8, ale obrazy nie są wyświetlane w ultra HDR, chyba że urządzenie ma Androida 14 lub nowszą wersję).

Podsumowanie

Poniżej znajdziesz kod, który pokazuje cały proces. Ten kod zakłada, że obraz jest wczytany do mapy bitowej, i sprawdza, czy obraz ma mapę wzmocnienia. Jeśli tak, kod zmienia tryb kolorów okna na COLOR_MODE_HDR. Jeśli obraz nie ma mapy wzmocnienia, kod przełącza okno do domyślnego trybu kolorów.

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);

Dodatkowe materiały

Więcej informacji o obrazach w ultra HDR znajdziesz w tych materiałach: