A partire dal 27 marzo 2025, ti consigliamo di utilizzare android-latest-release
anziché aosp-main
per compilare e contribuire ad AOSP. Per ulteriori informazioni, vedi Modifiche ad AOSP.
Ultra HDR
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Android 14 supporta l'acquisizione di immagini Ultra HDR compresse utilizzando il formato immagine JPEG_R
. Questo formato è compatibile con le immagini JPEG SDR e supporta il rendering HDR dei contenuti.
Per informazioni dettagliate sulla specifica del formato Ultra HDR, consulta
Ultra HDR Image Format v1.0.
Implementazione
Questa sezione descrive come implementare la funzionalità Ultra HDR.
Implementazione di riferimento
Il framework e il servizio della fotocamera AOSP includono un'implementazione di riferimento Ultra HDR.
Oltre alla funzionalità di riferimento nel framework della fotocamera, puoi implementare Ultra HDR all'interno dell'HAL della fotocamera e pubblicizzare il supporto per l'output JPEG_R
allo stesso modo di altri stream di output dell'HAL della fotocamera. In questo scenario,
l'HAL della fotocamera deve generare la mappa di recupero necessaria e l'immagine JPEG_R
finale come definito dalla
specifica Ultra HDR.
Puoi ottimizzare e regolare l'output finale in base alle funzionalità hardware e software del dispositivo.
Opzioni di implementazione
I produttori di dispositivi possono decidere i seguenti livelli di supporto Ultra HDR per i propri dispositivi:
- Minima:in questa configurazione, l'uscita Ultra HDR tramite la funzionalità di stream composito del servizio di assistenza della videocamera è disattivata per impostazione predefinita. Per attivare l'implementazione di riferimento
JpegRCompositeStream
, imposta la proprietà di sistema ro.camera.enableCompositeAPI0JpegR
su true
. Poiché tutte le operazioni e la codifica vengono eseguite in software, questa opzione può comportare un aumento della latenza e una diminuzione delle prestazioni.
- Moderata: con questa opzione, l'implementazione di
JpegRCompositeStream
utilizza un file JPEG SDR fornito da HAL come immagine di base e un frame P010 per calcolare una mappa di recupero. Questa opzione richiede l'elaborazione del software all'interno del percorso dati, ma è relativamente ridotta rispetto all'opzione minima.
- Estensive: l'HAL della fotocamera pubblicizza e supporta direttamente lo stream di output
JPEG_R
. Questa opzione consente ai produttori di dispositivi di implementare ottimizzazioni specifiche per il dispositivo e può offrire notevoli miglioramenti alla qualità delle immagini.
Per disattivare l'implementazione di JpegRCompositeStream
, imposta la proprietà di compilazione ro.camera.disableJpegR
su true
. Se questa proprietà di build non è impostata o è impostata su false
, Ultra HDR è attivato per impostazione predefinita tramite JpegRCompositeStream
sui dispositivi che supportano la funzionalità di output a 10 bit e la acquisizione simultanea a 10 e 8 bit.
Convalida
Per convalidare la funzionalità Ultra HDR sul tuo dispositivo, esegui i seguenti test.
Test CTS
Test ITS
Test manuali
Per eseguire test manuali, utilizza l'implementazione di esempio per l'acquisizione di immagini Ultra HDR, che include il supporto per la configurazione e l'acquisizione di Ultra HDR utilizzando il formato immagine JPEG_R
.
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Ultimo aggiornamento 2025-07-26 UTC.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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."]]