CaptureResult.ScalerRawCropRegion Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
The region of the sensor that corresponds to the RAW read out for this capture when the stream use case of a RAW stream is set to CROPPED_RAW.
[Android.Runtime.Register("SCALER_RAW_CROP_REGION", ApiSince=34)]
public static Android.Hardware.Camera2.CaptureResult.Key ScalerRawCropRegion { get; }[<Android.Runtime.Register("SCALER_RAW_CROP_REGION", ApiSince=34)>]
static member ScalerRawCropRegion : Android.Hardware.Camera2.CaptureResult.KeyProperty Value
The region of the sensor that corresponds to the RAW read out for this capture when the stream use case of a RAW stream is set to CROPPED_RAW.
- Attributes
Remarks
The region of the sensor that corresponds to the RAW read out for this capture when the stream use case of a RAW stream is set to CROPPED_RAW.
The coordinate system follows that of android.sensor.info.preCorrectionActiveArraySize.
This CaptureResult key will be set when the corresponding CaptureRequest has a RAW target with stream use case set to CameraMetadata.SCALER_AVAILABLE_STREAM_USE_CASES_CROPPED_RAW, otherwise it will be null. The value of this key specifies the region of the sensor used for the RAW capture and can be used to calculate the corresponding field of view of RAW streams. This field of view will always be >= field of view for (processed) non-RAW streams for the capture. Note: The region specified may not necessarily be centered.
For example: Assume a camera device has a pre correction active array size of {0, 0, 1500, 2000}. If the RAW_CROP_REGION is {500, 375, 1500, 1125}, that corresponds to a centered crop of 1/4th of the full field of view RAW stream.
The metadata keys which describe properties of RAW frames: android.statistics.hotPixelMap; android.statistics.lensShadingCorrectionMap; android.lens.distortion; android.lens.poseTranslation; android.lens.poseRotation; android.lens.distortion; android.lens.intrinsicCalibration
should be interpreted in the effective after raw crop field-of-view coordinate system. In this coordinate system, {android.sensor.info.preCorrectionActiveArraySize.left, android.sensor.info.preCorrectionActiveArraySize.top} corresponds to the top left corner of the cropped RAW frame and {android.sensor.info.preCorrectionActiveArraySize.right, android.sensor.info.preCorrectionActiveArraySize.bottom} corresponds to the bottom right corner. Client applications must use the values of the keys in the CaptureResult metadata if present.
Crop regions android.scaler.cropRegion, AE/AWB/AF regions and face coordinates still use the android.sensor.info.activeArraySize coordinate system as usual.
Units: Pixel coordinates relative to android.sensor.info.activeArraySize or android.sensor.info.preCorrectionActiveArraySize 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.SCALER_RAW_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.