HDR
What is HDR?​
HDR ("High Dynamic Range") is a capture mode that captures colors in a much wider range, allowing for much better details and brighter colors.
Photo HDR​
Photo HDR is accomplished by running three captures instead of one, an underexposed photo, a normal photo, and an overexposed photo. Then, these images are fused together to create darker darks and brighter brights.
Video HDR​
Video HDR is accomplished by using a 10-bit HDR pixel format with custom configuration on the hardware sensor that allows for capturing wider color ranges.
- On iOS, this uses the
kCVPixelFormatType_420YpCbCr10BiPlanarVideoRange
Pixel Format. - On Android, this uses the Dynamic Range Format
HLG10
,HDR10
orDOLBY_VISION_10B_HDR_OEM
.
If true 10-bit Video HDR is not available, the OS will sometimes fall back to EDR ("Extended Dynamic Range"), which, similar to how Photo HDR works, just doubles the video frame rate to capture one longer-exposed frame and one shorter exposed frame.
Using HDR​
To enable HDR capture, you need to select a format (see "Camera Formats") that supports HDR capture:
- Hooks API
- Imperative API
const format = useCameraFormat(device, [
{ photoHdr: true },
{ videoHdr: true },
])
const format = getCameraFormat(device, [
{ photoHdr: true },
{ videoHdr: true },
])
Then, pass the format
to the Camera and enable the videoHdr
/photoHdr
props if it is supported:
const format = ...
return (
<Camera
{...props}
format={format}
videoHdr={format.supportsVideoHdr}
photoHdr={format.supportsPhotoHdr}
/>
)
Now, all captures (takePhoto(..)
and startRecording(..)
) will be configured to use HDR.