第38讲 通过CropRegion控制Zoom缩放 - Android Camera2 API

本讲是Android Camera专题系列的第38讲，我们介绍Android Camera2 API专题的通过CropRegion控制Zoom缩放。

更多资源：

Android Zoom简介

Zoom就是对画面进行放大或缩小功能，分为光学变焦(Optical Zoom)和数字变焦(Digital Zoom)两种

如何查询当前Camera支持的Zoom能力

通过Crop Region控制Digital Zoom

CaptureRequest#SCALER_CROP_REGION用于控制digital zoom的

Crop Region坐标系

不支持android.distortionCorrection.mode

• Left,top = [0, 0], Right,bottom = [android.sensor.info.activeArraySize]

支持android.distortionCorrection.mode

• distortion correction mode 是OFF
  • Left,top=[0,0], Right bottom = [android.sensor.info.preCorrectionActiveArraySize]
• distortion correction mode 是非OFF
  • Left,top=[0,0], Right bottom = [android.sensor.info.activeArraySize]

对于支持ULTRA_HIGH_RESOLUTION_SENSOR的Camera设备，当android.sensor.pixelMode设置为SENSOR_PIXEL_MODE_MAXIMUM_RESOLUTION，参考坐标系要相应地修改为activeArraySizeMaximumResolution和preCorrectionActiveArraySizeMaximumResolution.

Crop Region应用的时机点

Crop region应用于raw转其他颜色空间(比如yuv)时,因此对raw buffer不生效

Crop Region与输出流间的裁剪规则

当crop region的宽高比与stream size的宽高比不一致时,会发生裁减

• 如果crop region是4:3，那么4:3的stream能看到所有画面, 16:9的stream会出现垂直方向上的裁减

• 如果crop region是16:9，那么16:9的stream能看到所有画面,4:3的stream会出现水平方向上的裁减

Crop Region裁减规则说明

• 假设camera device的active array size为(2000,1500)，且支持FREEFORM的crop

  • Active array size: 2000×1500 (3 MP, 4:3 aspect ratio)
  • Output stream #1: 640×480 (VGA, 4:3 aspect ratio)

  • Output stream #2: 1280×720 (720p, 16:9 aspect ratio)

Case #1: 4:3 crop region with 2x digital zoom

• Crop region: Rect(500, 375, 1500, 1125) // (left, top, right, bottom)
  • 640×480 stream: (500, 375, 1500, 1125) (与 crop region相等)
  • 280×720 stream: (500, 469, 1500, 1031) (垂直裁剪)

Case #2: 16:9 crop region with ~1.5x digital zoom

• Crop region: Rect(500, 375, 1833, 1125)
  • 1280×720 stream: (500, 375, 1833, 1125) (与 crop region相等)
  • 640×480 stream: (666, 375, 1666, 1125) (水平裁剪)

Case #3: 1:1 crop region with ~2.6x digital zoom

• Crop region: Rect(500, 375, 1250, 1125)
  • 640×480 stream: (500, 469, 1250, 1031) (垂直裁剪)

  • 1280×720 stream: (500, 543, 1250, 957) (垂直裁剪)

Case #4: Replace 640×480 stream with 1024×1024 stream, with 4:3 crop region

• Crop region: Rect(500, 375, 1500, 1125)
  • 1024×1024 stream: (625, 375, 1375, 1125) (水平裁剪)

  • 1280×720 stream: (500, 469, 1500, 1031) (垂直裁剪)

Crop Region精度控制

由于硬件限制或者一些对齐要求，上层在CaptureRequest里面设置的crop region可能会被Camera HAL做微调，最终实际生效的Crop region会在CaptureResult中体现。

Crop Region与Sensor输出大小关系

Crop region大小不会影响到Sensor输出大小，Sensor输出不同的Size都会被mapping到Active array size上来进行计算；这里Active array size仅表示当前sensor mode下sensor输出的全尺寸，并不是sensor输出大小

Crop Region与Zoom Ratio

从API Level 30开始，在Logical multicam中强烈建议通过CONTROL_ZOOM_RATIO来控制Zoom，因为该控制方式会结合光学变焦和数字变焦的能力，甚至可以缩小到1倍zoom以下

• 通过CONTROL_ZOOM_RATIO控制Zoom时，Crop region设置为默认active array size即可

本文链接：http://so.lmcjl.com/news/16273/