相机散焦是一种浅景深效果,通过模糊场景的部分,使它们不在焦点上。在移动设备上的相机上,利用从两个相机的立体视觉或从单个相机的双光电二极管(pd)获得的深度信息来实现散景。
从Android 11开始,Android平台支持散景实现,并提供api使该功能可用于第三方应用程序。
实现
要使相机散景功能在您的设备上可用,请执行以下操作:
广告ANDROID_CONTROL_AVAILABLE_EXTENDED_SCENE_MODE_MAX_SIZES:
该标记采用三整数元组数组的格式,每个元组的格式为{mode, maxWidth, maxHeight}。除了{ANDROID_CONTROL_EXTENDED_SCENE_MODE_DISABLED, 0,0},相机HAL还必须列出ANDROID_CONTROL_EXTENDED_SCENE_MODE_BOKEH_STILL_CAPTURE和ANDROID_CONTROL_EXTENDED_SCENE_MODE_BOKEH_CONTINUOUS模式中的一个或两个,以及它们对应的最大流大小。
广告ANDROID_CONTROL_AVAILABLE_EXTENDED_SCENE_MODE_ZOOM_RATIO_RANGES:
这个标签的格式是{minZoomRatio, maxZoomRatio}数组,它包含了一个已启用的扩展场景模式的所有缩放比范围,顺序与ANDROID_CONTROL_AVAILABLE_EXTENDED_SCENE_MODE_MAX_SIZES相同。缩放范围为[1.0,1.0]意味着不支持缩放。
在ANDROID_CONTROL_AVAILABLE_MODES中填充ANDROID_CONTROL_USE_EXTENDED_SCENE_MODE。
应用程序要触发散景功能,必须将ANDROID_CONTROL_MODE设置为ANDROID_CONTROL_USE_EXTENDED_SCENE_MODE,并将ANDROID_CONTROL_EXTENDED_SCENE_MODE设置为支持的扩展场景模式之一。注意,由于立体计算,实现bokeh可能会导致额外的内存消耗。
如果支持的扩展场景模式不能应用于每一帧,并且在启用/禁用时导致了意外的延迟,请在ANDROID_REQUEST_AVAILABLE_SESSION_KEYS中包含ANDROID_CONTROL_EXTENDED_SCENE_MODE。同时,实现icameraddevicesession::isReconfigurationRequired()方法来避免对不需要重新配置的扩展场景模式进行重新配置。
验证
要在设备上验证散景特性,请运行以下CTS、VTS和CTS验证器测试:
CtsCameraTestCases
VtsHalCameraProviderV2_4TargetTest
CTS验证器中的CameraBokehTest