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 zapewnia obsługę zdjęć ultra HDR już od wersji 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 go lub obiekt rysowalny na Bitmap i wywołaj Bitmap.hasGainMap() (dostępny od Androida 14) w celu sprawdzenia, czy ma 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 na urządzeniach z Androidem 8, ale zdjęcia nie są wyświetlane w trybie ultra HDR, chyba że na urządzeniu działa Android 14 lub nowszy.

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: