PhotoOutputOptions

interface PhotoOutputOptions

Configuration options for a CameraPhotoOutput.

See

• CameraPhotoOutput
• usePhotoOutput(...)

Properties

containerFormat

containerFormat: TargetPhotoContainerFormat

Specifies the TargetPhotoContainerFormat to shoot the Photo in.

previewImageTargetSize?

optional previewImageTargetSize: Size

When this is set to a specific Size, a ready to display Image will be delivered just before the resulting Photo is available.

Preview Image delivery requires additional processing, so this is disabled by default.

If this is undefined (the default), no preview Image will be supplied.

It is recommended to set this to a Size that is as low as possible to avoid unnecessary overhead.

See

CapturePhotoCallbacks.onPreviewImageAvailable

Default

undefined

quality

quality: number

Defines the compression quality for processed photo formats.

The value must be within the normalized range from 0.0 to 1.0, where 1.0 is the highest quality and 0.0 is the strongest compression.

RAW photo formats such as 'dng' ignore this option.

Default

0.9 in usePhotoOutput(...)

qualityPrioritization

qualityPrioritization: QualityPrioritization

Specifies the balance between speed or image quality for the photo capture pipeline.

The currently selected CameraDevice must support QualityPrioritization 'speed' (see supportsSpeedQualityPrioritization), otherwise an error will be thrown.

See

CameraDevice.supportsSpeedQualityPrioritization

targetResolution

targetResolution: Size

The target Photo Resolution to use.

Discussion

The CameraSession will negotiate all output targetResolutions and constraints (such as HDR, FPS, etc) in a CameraSessionConfig to finalize the Resolution used for the Output. This is therefore merely a resolution target, and may not be exactly met.

If the given targetResolution cannot be met exactly, its aspect ratio (computed by Size.width / Size.height) will be prioritized over pixel count.