From 77e073fcf861354cc2197c930a9f3ccbfee4bb41 Mon Sep 17 00:00:00 2001
From: Shuzhen Wang
We define the expected processing pipeline below. For consistency * across devices, this is always the case with TRANSFORM_MATRIX.
- *When either FULL or HIGH_QUALITY is used, the camera device may + *
When either FAST or HIGH_QUALITY is used, the camera device may * do additional processing but ACAMERA_COLOR_CORRECTION_GAINS and * ACAMERA_COLOR_CORRECTION_TRANSFORM will still be provided by the * camera device (in the results) and be roughly correct.
@@ -1734,6 +1734,77 @@ typedef enum acamera_metadata_tag { */ ACAMERA_CONTROL_AF_SCENE_CHANGE = // byte (acamera_metadata_enum_android_control_af_scene_change_t) ACAMERA_CONTROL_START + 42, + /** + *The list of bokeh modes that are supported by this camera device, and each bokeh mode's + * maximum streaming (non-stall) size with bokeh effect.
+ * + *Type: int32[3*n]
+ * + *This tag may appear in: + *
For OFF mode, the camera behaves normally with no bokeh effect.
+ *For STILL_CAPTURE mode, the maximum streaming dimension specifies the limit under which + * bokeh is effective when capture intent is PREVIEW. Note that when capture intent is + * PREVIEW, the bokeh effect may not be as high quality compared to STILL_CAPTURE intent + * in order to maintain reasonable frame rate. The maximum streaming dimension must be one + * of the YUV_420_888 or PRIVATE resolutions in availableStreamConfigurations, or (0, 0) + * if preview bokeh is not supported. If the application configures a stream larger than + * the maximum streaming dimension, bokeh effect may not be applied for this stream for + * PREVIEW intent.
+ *For CONTINUOUS mode, the maximum streaming dimension specifies the limit under which + * bokeh is effective. This dimension must be one of the YUV_420_888 or PRIVATE resolutions + * in availableStreamConfigurations, and if the sensor maximum resolution is larger than or + * equal to 1080p, the maximum streaming dimension must be at least 1080p. If the + * application configures a stream with larger dimension, the stream may not have bokeh + * effect applied.
+ */ + ACAMERA_CONTROL_AVAILABLE_BOKEH_CAPABILITIES = // int32[3*n] + ACAMERA_CONTROL_START + 43, + /** + *Whether bokeh mode is enabled for a particular capture request.
+ * + *Type: byte (acamera_metadata_enum_android_control_bokeh_mode_t)
+ * + *This tag may appear in: + *
With bokeh mode, the camera device may blur out the parts of scene that are not in + * focus, creating a bokeh (or shallow depth of field) effect for people or objects.
+ *When set to STILL_CAPTURE bokeh mode with STILL_CAPTURE capture intent, due to the extra + * processing needed for high quality bokeh effect, the stall may be longer than when + * capture intent is not STILL_CAPTURE.
+ *When set to STILL_CAPTURE bokeh mode with PREVIEW capture intent,
+ *When set to CONTINUOUS mode, configured streams dimension should not exceed this mode's + * maximum streaming dimension in order to have bokeh effect applied. Bokeh effect may not + * be available for streams larger than the maximum streaming dimension.
+ *Switching between different bokeh modes may involve reconfiguration of the camera + * pipeline, resulting in long latency. The application should check this key against the + * available session keys queried via + * {@link ACameraManager_getCameraCharacteristics }.
+ *When bokeh mode is on, the camera device may override certain control parameters, such as + * reduce frame rate or use face priority scene mode, to achieve best power and quality + * tradeoffs. When turned on, AE, AWB, and AF run in auto modes, and only the mandatory + * stream combinations of LIMITED hardware level are guaranteed.
+ *For a logical multi-camera, bokeh may be implemented by stereo vision from sub-cameras + * with different field of view. As a result, when bokeh mode is enabled, the camera device + * may override android.scaler.CropRegion, and the field of view will be smaller than when + * bokeh mode is off.
+ */ + ACAMERA_CONTROL_BOKEH_MODE = // byte (acamera_metadata_enum_android_control_bokeh_mode_t) + ACAMERA_CONTROL_START + 44, ACAMERA_CONTROL_END, /** @@ -7002,6 +7073,31 @@ typedef enum acamera_metadata_enum_acamera_control_af_scene_change { } acamera_metadata_enum_android_control_af_scene_change_t; +// ACAMERA_CONTROL_BOKEH_MODE +typedef enum acamera_metadata_enum_acamera_control_bokeh_mode { + /** + *Bokeh mode is disabled.
+ */ + ACAMERA_CONTROL_BOKEH_MODE_OFF = 0, + + /** + *High quality bokeh mode is enabled for all non-raw streams (including YUV, + * JPEG, and IMPLEMENTATION_DEFINED) when capture intent is STILL_CAPTURE. Due to the + * extra image processing, this mode may introduce additional stall to non-raw streams. + * This mode should be used in high quality still capture use case.
+ */ + ACAMERA_CONTROL_BOKEH_MODE_STILL_CAPTURE = 1, + + /** + *Bokeh effect must not slow down capture rate relative to sensor raw output, + * and the effect is applied to all processed streams no larger than the maximum + * streaming dimension. This mode should be used if performance and power are a + * priority, such as video recording.
+ */ + ACAMERA_CONTROL_BOKEH_MODE_CONTINUOUS = 2, + +} acamera_metadata_enum_android_control_bokeh_mode_t; + // ACAMERA_EDGE_MODE