Język

CaptureResult.LogicalMultiCameraActivePhysicalSensorCropRegion Property

Definition

The current region of the active physical sensor that will be read out for this capture.

[Android.Runtime.Register("LOGICAL_MULTI_CAMERA_ACTIVE_PHYSICAL_SENSOR_CROP_REGION", ApiSince=35)]
public static Android.Hardware.Camera2.CaptureResult.Key LogicalMultiCameraActivePhysicalSensorCropRegion { get; }
[<Android.Runtime.Register("LOGICAL_MULTI_CAMERA_ACTIVE_PHYSICAL_SENSOR_CROP_REGION", ApiSince=35)>]
static member LogicalMultiCameraActivePhysicalSensorCropRegion : Android.Hardware.Camera2.CaptureResult.Key

Property Value

The current region of the active physical sensor that will be read out for this capture.

Attributes

Remarks

The current region of the active physical sensor that will be read out for this capture.

This capture result matches with android.scaler.cropRegion on non-logical single camera sensor devices. In case of logical cameras that can switch between several physical devices in response to android.control.zoomRatio, this capture result will not behave like android.scaler.cropRegion and android.control.zoomRatio, where the combination of both reflects the effective zoom and crop of the logical camera output. Instead, this capture result value will describe the zoom and crop of the active physical device. Some examples of when the value of this capture result will change include switches between different physical lenses, switches between regular and maximum resolution pixel mode and going through the device digital or optical range. This capture result is similar to android.scaler.cropRegion with respect to distortion correction. When the distortion correction mode is OFF, the coordinate system follows android.sensor.info.preCorrectionActiveArraySize, with (0, 0) being the top-left pixel of the pre-correction active array. When the distortion correction mode is not OFF, the coordinate system follows android.sensor.info.activeArraySize, with (0, 0) being the top-left pixel of the active array.

For camera devices with the CameraMetadata.REQUEST_AVAILABLE_CAPABILITIES_ULTRA_HIGH_RESOLUTION_SENSOR capability or devices where CameraCharacteristics.getAvailableCaptureRequestKeys lists android.sensor.pixelMode, the current active physical device android.sensor.info.activeArraySizeMaximumResolution / android.sensor.info.preCorrectionActiveArraySizeMaximumResolution must be used as the coordinate system for requests where android.sensor.pixelMode is set to CameraMetadata.SENSOR_PIXEL_MODE_MAXIMUM_RESOLUTION.

Units: Pixel coordinates relative to android.sensor.info.activeArraySize or android.sensor.info.preCorrectionActiveArraySize of the currently android.logicalMultiCamera.activePhysicalId depending on distortion correction capability and mode

Optional - The value for this key may be null on some devices.

Android reference for android.hardware.camera2.CaptureResult.LOGICAL_MULTI_CAMERA_ACTIVE_PHYSICAL_SENSOR_CROP_REGION.

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