27 Mart 2025'ten itibaren AOSP'yi derlemek ve AOSP'ye katkıda bulunmak için aosp-main yerine android-latest-release kullanmanızı öneririz. Daha fazla bilgi için AOSP'de yapılan değişiklikler başlıklı makaleyi inceleyin.
Ultra HDR
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Android 14, JPEG_R resim biçimini kullanarak Ultra HDR sıkıştırılmış resimler çekmeyi destekler. Bu biçim, SDR JPEG resimleriyle geriye dönük uyumludur ve içeriğin HDR olarak oluşturulmasını destekler.
Ultra HDR biçimi spesifikasyonu hakkında ayrıntılı bilgi için Ultra HDR Resim Biçimi v1.0 başlıklı makaleyi inceleyin.
Uygulama
Bu bölümde, Ultra HDR özelliğinin nasıl uygulanacağı açıklanmaktadır.
Referans uygulama
AOSP kamera çerçevesi ve kamera hizmeti, referans Ultra HDR uygulaması içerir.
Kamera çerçevesindeki referans işlevine ek olarak, kamera HAL'inde Ultra HDR'yi uygulayabilir ve diğer kamera HAL çıkış akışlarıyla aynı şekilde JPEG_R çıkışı için destek reklamı yapabilirsiniz. Bu senaryoda kamera HAL'i, gerekli kurtarma haritasını ve Ultra HDR spesifikasyonu tarafından tanımlanan nihai JPEG_Rresmi oluşturmalıdır.
Nihai çıkışı cihaz donanımına ve yazılım özelliklerine göre optimize edebilir ve ayarlayabilirsiniz.
Uygulama seçenekleri
Cihaz üreticileri, cihazları için aşağıdaki Ultra HDR desteği seviyelerine karar verebilir:
- En az: Bu yapılandırmada, kamera hizmeti karma yayın işlevi aracılığıyla Ultra HDR çıkışı varsayılan olarak devre dışıdır.
JpegRCompositeStream referans uygulamasını etkinleştirmek için ro.camera.enableCompositeAPI0JpegR sistem özelliğini true olarak ayarlayın. Tüm işlemler ve kodlama yazılımda gerçekleştirildiği için bu seçenek, gecikmenin artmasına ve performansın düşmesine neden olabilir.
- Orta: Bu seçenekte
JpegRCompositeStream uygulaması, temel resim olarak HAL tarafından sağlanan bir SDR JPEG dosyası ve kurtarma haritasını hesaplamak için bir P010 çerçevesi kullanır. Bu seçenek, veri yolunda yazılım işleme içerir ancak minimum seçeneğe kıyasla nispeten küçüktür.
- Geniş: Kamera HAL'i,
JPEG_R çıkış akışının reklamını yapar ve bu akışı doğrudan destekler. Bu seçenek, cihaz üreticilerinin cihaza özel optimizasyonlar uygulamasına olanak tanır ve önemli görüntü kalitesi iyileştirmeleri sağlayabilir.
JpegRCompositeStream uygulamasını devre dışı bırakmak için ro.camera.disableJpegR derleme özelliğini true olarak ayarlayın. Bu derleme özelliği ayarlanmamışsa veya false olarak ayarlanmışsa Ultra HDR, 10 bit çıkış özelliğini ve eşzamanlı 10 ve 8 bit yakalamayı destekleyen cihazlarda JpegRCompositeStream aracılığıyla varsayılan olarak etkinleştirilir.
Doğrulama
Cihazınızda Ultra HDR özelliğini doğrulamak için aşağıdaki testleri çalıştırın.
CTS testleri
ITS testleri
Manuel testler
Manuel testler yapmak için JPEG_R resim biçimini kullanarak Ultra HDR'nin yapılandırılması ve yakalanması için destek içeren Ultra HDR resim yakalama örnek uygulamasını kullanın.
Bu sayfadaki içerik ve kod örnekleri, İçerik Lisansı sayfasında açıklanan lisanslara tabidir. Java ve OpenJDK, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-26 UTC.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-07-26 UTC."],[],[],null,["# Ultra HDR\n\nAndroid 14 provides support for capturing Ultra HDR\ncompressed images using the\n[`JPEG_R`](https://developer.android.com/reference/kotlin/android/graphics/ImageFormat#jpeg_r)\nimage format. This format is backward compatible with SDR JPEG images and\nsupports HDR rendering of content.\nFor details about the Ultra HDR format specification, see\n[Ultra HDR Image Format v1.0](https://developer.android.com/guide/topics/media/hdr-image-format).\n\nImplementation\n--------------\n\nThis section describes how to implement the Ultra HDR feature.\n\n### Reference implementation\n\nThe AOSP camera framework and camera service includes a reference Ultra HDR\nimplementation.\n\nIn addition to the reference functionality in the camera framework, you can\nimplement Ultra HDR within the camera HAL and advertise support for `JPEG_R`\noutput in the same way as other camera HAL output streams. In this scenario,\nthe camera HAL must generate the necessary recovery map and the final `JPEG_R`\nimage as defined by the\n[Ultra HDR specification](https://developer.android.com/guide/topics/media/hdr-image-format#introduction).\nYou can optimize and tune the final output depending on the device hardware\nand software capabilities.\n\n### Implementation options\n\nDevice manufacturers can decide on the following levels of Ultra HDR support for\ntheir devices:\n\n- **Minimal:** In this configuration, Ultra HDR output through the camera service composite stream functionality is disabled by default. To enable the `JpegRCompositeStream` reference implementation, set the `ro.camera.enableCompositeAPI0JpegR` system property to `true`. Because all processes and encoding is performed in software, this option can result in increased latency and decreased performance.\n- **Moderate:** With this option, the `JpegRCompositeStream` implementation uses a HAL-provided SDR JPEG file as a base image and a P010 frame to calculate a recovery map. This option involves software processing within the data path but is relatively minor compared to the minimal option.\n- **Extensive:** The camera HAL advertises and supports the `JPEG_R` output stream directly. This option lets device manufacturers implement device-specific optimizations and can provide significant image quality improvements.\n\nTo disable the `JpegRCompositeStream` implementation, set the\n`ro.camera.disableJpegR` build property to `true`. If this build property isn't\nset or is set to `false`, Ultra HDR is enabled by default through\n`JpegRCompositeStream` on devices supporting\n[10-bit output capability](https://developer.android.com/reference/android/hardware/camera2/CameraMetadata#REQUEST_AVAILABLE_CAPABILITIES_DYNAMIC_RANGE_TEN_BIT)\nand\n[concurrent 10 and 8-bit capture](https://developer.android.com/reference/android/hardware/camera2/params/DynamicRangeProfiles#getProfileCaptureRequestConstraints(long)).\n\nValidation\n----------\n\nTo validate the Ultra HDR feature on your device, run the following tests.\n\n### CTS tests\n\n- [`ImageReaderTest.java#testImageReaderBuilderWithBLOBAndJpegR`](https://android.googlesource.com/platform/cts/+/refs/heads/android16-release/tests/camera/src/android/hardware/camera2/cts/ImageReaderTest.java#815)\n- [`ImageReaderTest.java#testJpegR`](https://android.googlesource.com/platform/cts/+/refs/heads/android16-release/tests/camera/src/android/hardware/camera2/cts/ImageReaderTest.java#503)\n- [`ImageReaderTest.java#testJpegRDisplayP3`](https://android.googlesource.com/platform/cts/+/refs/heads/android16-release/tests/camera/src/android/hardware/camera2/cts/ImageReaderTest.java#526)\n- [`PerformanceTest.java#testSingleCapture`](https://android.googlesource.com/platform/cts/+/refs/heads/android16-release/tests/camera/src/android/hardware/camera2/cts/PerformanceTest.java#313)\n- [`StillCaptureTest.java# testJpegRCapture`](https://android.googlesource.com/platform/cts/+/refs/heads/android16-release/tests/camera/src/android/hardware/camera2/cts/StillCaptureTest.java#192)\n\n### ITS tests\n\n- [`scene4#test_aspect_ratio_and_crop`](https://android.googlesource.com/platform/cts/+/refs/heads/android16-release/apps/CameraITS/tests/scene4/test_aspect_ratio_and_crop.py)\n\n### Manual tests\n\nTo perform manual tests, use the\n[sample implementation for Ultra HDR image capture](https://github.com/android/platform-samples/pull/56),\nwhich includes support for the configuration and capture of Ultra HDR using the\n`JPEG_R` image format."]]
