울트라 HDR 이미지 표시

울트라 HDR 이미지 형식을 사용하면 이미지에 빛의 강도에 관한 더 많은 정보를 저장할 수 있으므로 더 자세한 하이라이트와 그림자, 더 강렬한 색상을 얻을 수 있습니다. Android는 Android 14 (API 수준 34)부터 울트라 HDR 이미지를 지원합니다. 앱이 이러한 버전에서 실행되는 경우 이러한 이미지를 올바르게 표시하도록 앱을 구성하는 것이 중요합니다. 반면에 앱에서 울트라 HDR 이미지를 표시하지 않는 경우 울트라 HDR 디스플레이를 사용 설정하지 않으면 기기 리소스를 절약할 수 있습니다. 이 페이지에서는 그래픽이 울트라 HDR을 지원하는지 확인하는 방법과 올바르게 표시하는 방법을 설명합니다.

이득 맵이 있는지 확인

울트라 HDR 이미지에는 이득 맵이 포함됩니다. 이득 맵은 이미지의 각 픽셀의 밝기 증가를 결정하는 데 사용됩니다. 이미지가 울트라 HDR 형식인지 확인하려면 이미지 또는 드로어블을 Bitmap로 변환하고 Bitmap.hasGainMap()(Android 14부터 사용 가능)를 호출하여 이득 맵이 있는지 확인합니다.

울트라 HDR을 표시하도록 창 구성

전체 다이내믹 레인지로 울트라 HDR 이미지를 표시하려면 창의 색상 모드를 ActivityInfo.COLOR_MODE_HDR로 설정합니다. 창의 setColorMode() 메서드를 호출하면 됩니다. (이러한 API는 Android 8부터 사용할 수 있지만 기기에서 Android 14 이상을 실행하지 않는 한 이미지가 Ultra HDR로 표시되지 않습니다.)

종합적으로 살펴보기

다음 코드는 전체 프로세스를 보여줍니다. 이 코드는 이미지가 비트맵에 로드되었다고 가정하고 이미지에 이득 맵이 있는지 확인합니다. true이면 코드가 창의 색상 모드를 COLOR_MODE_HDR로 전환합니다. 이미지에 이득 맵이 없으면 코드가 창을 기본 색상 모드로 전환합니다.

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

추가 리소스

울트라 HDR 이미지에 관해 자세히 알아보려면 다음 추가 리소스를 참고하세요.