Lingua

InfoSupportedHardwareLevel Enum

Definition

Enumerates values returned by the Full, Legacy, and Limited members.

public enum InfoSupportedHardwareLevel
type InfoSupportedHardwareLevel = 
Inheritance
InfoSupportedHardwareLevel

Fields

Name Value Description
Limited 0

This camera device does not have enough capabilities to qualify as a FULL device or better.

Only the stream configurations listed in the LEGACY and LIMITED tables in the documentation are guaranteed to be supported.

All LIMITED devices support the BACKWARDS_COMPATIBLE capability, indicating basic support for color image capture. The only exception is that the device may alternatively support only the DEPTH_OUTPUT capability, if it can only output depth measurements and not color images.

LIMITED devices and above require the use of android.control.aePrecaptureTrigger to lock exposure metering (and calculate flash power, for cameras with flash) before capturing a high-quality still image.

A LIMITED device that only lists the BACKWARDS_COMPATIBLE capability is only required to support full-automatic operation and post-processing (OFF is not supported for android.control.aeMode, android.control.afMode, or android.control.awbMode)

Additional capabilities may optionally be supported by a LIMITED-level device, and can be checked for in android.request.availableCapabilities.

Android reference for android.hardware.camera2.CameraMetadata.INFO_SUPPORTED_HARDWARE_LEVEL_LIMITED.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Full 1

This camera device is capable of supporting advanced imaging applications.

The stream configurations listed in the FULL, LEGACY and LIMITED tables in the documentation are guaranteed to be supported.

A FULL device will support below capabilities: BURST_CAPTURE capability (android.request.availableCapabilities contains BURST_CAPTURE); Per frame control (android.sync.maxLatency == PER_FRAME_CONTROL); Manual sensor control (android.request.availableCapabilities contains MANUAL_SENSOR); Manual post-processing control (android.request.availableCapabilities contains MANUAL_POST_PROCESSING); The required exposure time range defined in android.sensor.info.exposureTimeRange; The required maxFrameDuration defined in android.sensor.info.maxFrameDuration

Note: Pre-API level 23, FULL devices also supported arbitrary cropping region (android.scaler.croppingType == FREEFORM); this requirement was relaxed in API level 23, and FULL devices may only support CENTERED cropping.

Android reference for android.hardware.camera2.CameraMetadata.INFO_SUPPORTED_HARDWARE_LEVEL_FULL.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Legacy 2

This camera device is running in backward compatibility mode.

Only the stream configurations listed in the LEGACY table in the documentation are supported.

A LEGACY device does not support per-frame control, manual sensor control, manual post-processing, arbitrary cropping regions, and has relaxed performance constraints. No additional capabilities beyond BACKWARD_COMPATIBLE will ever be listed by a LEGACY device in android.request.availableCapabilities.

In addition, the android.control.aePrecaptureTrigger is not functional on LEGACY devices. Instead, every request that includes a JPEG-format output target is treated as triggering a still capture, internally executing a precapture trigger. This may fire the flash for flash power metering during precapture, and then fire the flash for the final capture, if a flash is available on the device and the AE mode is set to enable the flash.

Devices that initially shipped with Android version Q or newer will not include any LEGACY-level devices.

Android reference for android.hardware.camera2.CameraMetadata.INFO_SUPPORTED_HARDWARE_LEVEL_LEGACY.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

I3 3

This camera device is capable of YUV reprocessing and RAW data capture, in addition to FULL-level capabilities.

The stream configurations listed in the LEVEL_3, RAW, FULL, LEGACY and LIMITED tables in the documentation are guaranteed to be supported.

The following additional capabilities are guaranteed to be supported: YUV_REPROCESSING capability (android.request.availableCapabilities contains YUV_REPROCESSING); RAW capability (android.request.availableCapabilities contains RAW)

Android reference for android.hardware.camera2.CameraMetadata.INFO_SUPPORTED_HARDWARE_LEVEL_3.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

External 4

This camera device is backed by an external camera connected to this Android device.

The device has capability identical to a LIMITED level device, with the following exceptions: The device may not report lens/sensor related information such as; android.lens.focalLength; android.lens.info.hyperfocalDistance; android.sensor.info.physicalSize; android.sensor.info.whiteLevel; android.sensor.blackLevelPattern; android.sensor.info.colorFilterArrangement; android.sensor.rollingShutterSkew; The device will report 0 for android.sensor.orientation; The device has less guarantee on stable framerate, as the framerate partly depends on the external camera being used

Android reference for android.hardware.camera2.CameraMetadata.INFO_SUPPORTED_HARDWARE_LEVEL_EXTERNAL.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Remarks

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to