| /* |
| * Copyright (C) 2015 The Android Open Source Project |
| * |
| * Licensed under the Apache License, Version 2.0 (the "License"); |
| * you may not use this file except in compliance with the License. |
| * You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| |
| /** |
| * @addtogroup Camera |
| * @{ |
| */ |
| |
| /** |
| * @file NdkCameraMetadataTags.h |
| */ |
| |
| /* |
| * This file defines an NDK API. |
| * Do not remove methods. |
| * Do not change method signatures. |
| * Do not change the value of constants. |
| * Do not change the size of any of the classes defined in here. |
| * Do not reference types that are not part of the NDK. |
| * Do not #include files that aren't part of the NDK. |
| */ |
| |
| #ifndef _NDK_CAMERA_METADATA_TAGS_H |
| #define _NDK_CAMERA_METADATA_TAGS_H |
| |
| typedef enum acamera_metadata_section { |
| ACAMERA_COLOR_CORRECTION, |
| ACAMERA_CONTROL, |
| ACAMERA_DEMOSAIC, |
| ACAMERA_EDGE, |
| ACAMERA_FLASH, |
| ACAMERA_FLASH_INFO, |
| ACAMERA_HOT_PIXEL, |
| ACAMERA_JPEG, |
| ACAMERA_LENS, |
| ACAMERA_LENS_INFO, |
| ACAMERA_NOISE_REDUCTION, |
| ACAMERA_QUIRKS, |
| ACAMERA_REQUEST, |
| ACAMERA_SCALER, |
| ACAMERA_SENSOR, |
| ACAMERA_SENSOR_INFO, |
| ACAMERA_SHADING, |
| ACAMERA_STATISTICS, |
| ACAMERA_STATISTICS_INFO, |
| ACAMERA_TONEMAP, |
| ACAMERA_LED, |
| ACAMERA_INFO, |
| ACAMERA_BLACK_LEVEL, |
| ACAMERA_SYNC, |
| ACAMERA_REPROCESS, |
| ACAMERA_DEPTH, |
| ACAMERA_SECTION_COUNT, |
| |
| ACAMERA_VENDOR = 0x8000 |
| } acamera_metadata_section_t; |
| |
| /** |
| * Hierarchy positions in enum space. |
| */ |
| typedef enum acamera_metadata_section_start { |
| ACAMERA_COLOR_CORRECTION_START = ACAMERA_COLOR_CORRECTION << 16, |
| ACAMERA_CONTROL_START = ACAMERA_CONTROL << 16, |
| ACAMERA_DEMOSAIC_START = ACAMERA_DEMOSAIC << 16, |
| ACAMERA_EDGE_START = ACAMERA_EDGE << 16, |
| ACAMERA_FLASH_START = ACAMERA_FLASH << 16, |
| ACAMERA_FLASH_INFO_START = ACAMERA_FLASH_INFO << 16, |
| ACAMERA_HOT_PIXEL_START = ACAMERA_HOT_PIXEL << 16, |
| ACAMERA_JPEG_START = ACAMERA_JPEG << 16, |
| ACAMERA_LENS_START = ACAMERA_LENS << 16, |
| ACAMERA_LENS_INFO_START = ACAMERA_LENS_INFO << 16, |
| ACAMERA_NOISE_REDUCTION_START = ACAMERA_NOISE_REDUCTION << 16, |
| ACAMERA_QUIRKS_START = ACAMERA_QUIRKS << 16, |
| ACAMERA_REQUEST_START = ACAMERA_REQUEST << 16, |
| ACAMERA_SCALER_START = ACAMERA_SCALER << 16, |
| ACAMERA_SENSOR_START = ACAMERA_SENSOR << 16, |
| ACAMERA_SENSOR_INFO_START = ACAMERA_SENSOR_INFO << 16, |
| ACAMERA_SHADING_START = ACAMERA_SHADING << 16, |
| ACAMERA_STATISTICS_START = ACAMERA_STATISTICS << 16, |
| ACAMERA_STATISTICS_INFO_START = ACAMERA_STATISTICS_INFO << 16, |
| ACAMERA_TONEMAP_START = ACAMERA_TONEMAP << 16, |
| ACAMERA_LED_START = ACAMERA_LED << 16, |
| ACAMERA_INFO_START = ACAMERA_INFO << 16, |
| ACAMERA_BLACK_LEVEL_START = ACAMERA_BLACK_LEVEL << 16, |
| ACAMERA_SYNC_START = ACAMERA_SYNC << 16, |
| ACAMERA_REPROCESS_START = ACAMERA_REPROCESS << 16, |
| ACAMERA_DEPTH_START = ACAMERA_DEPTH << 16, |
| ACAMERA_VENDOR_START = ACAMERA_VENDOR << 16 |
| } acamera_metadata_section_start_t; |
| |
| /** |
| * Main enum for camera metadata tags. |
| */ |
| typedef enum acamera_metadata_tag { |
| /** |
| * <p>The mode control selects how the image data is converted from the |
| * sensor's native color into linear sRGB color.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>When auto-white balance (AWB) is enabled with ACAMERA_CONTROL_AWB_MODE, this |
| * control is overridden by the AWB routine. When AWB is disabled, the |
| * application controls how the color mapping is performed.</p> |
| * <p>We define the expected processing pipeline below. For consistency |
| * across devices, this is always the case with TRANSFORM_MATRIX.</p> |
| * <p>When either FULL 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.</p> |
| * <p>Switching to TRANSFORM_MATRIX and using the data provided from |
| * FAST or HIGH_QUALITY will yield a picture with the same white point |
| * as what was produced by the camera device in the earlier frame.</p> |
| * <p>The expected processing pipeline is as follows:</p> |
| * <p><img alt="White balance processing pipeline" src="../images/camera2/metadata/android.colorCorrection.mode/processing_pipeline.png" /></p> |
| * <p>The white balance is encoded by two values, a 4-channel white-balance |
| * gain vector (applied in the Bayer domain), and a 3x3 color transform |
| * matrix (applied after demosaic).</p> |
| * <p>The 4-channel white-balance gains are defined as:</p> |
| * <pre><code>ACAMERA_COLOR_CORRECTION_GAINS = [ R G_even G_odd B ] |
| * </code></pre> |
| * <p>where <code>G_even</code> is the gain for green pixels on even rows of the |
| * output, and <code>G_odd</code> is the gain for green pixels on the odd rows. |
| * These may be identical for a given camera device implementation; if |
| * the camera device does not support a separate gain for even/odd green |
| * channels, it will use the <code>G_even</code> value, and write <code>G_odd</code> equal to |
| * <code>G_even</code> in the output result metadata.</p> |
| * <p>The matrices for color transforms are defined as a 9-entry vector:</p> |
| * <pre><code>ACAMERA_COLOR_CORRECTION_TRANSFORM = [ I0 I1 I2 I3 I4 I5 I6 I7 I8 ] |
| * </code></pre> |
| * <p>which define a transform from input sensor colors, <code>P_in = [ r g b ]</code>, |
| * to output linear sRGB, <code>P_out = [ r' g' b' ]</code>,</p> |
| * <p>with colors as follows:</p> |
| * <pre><code>r' = I0r + I1g + I2b |
| * g' = I3r + I4g + I5b |
| * b' = I6r + I7g + I8b |
| * </code></pre> |
| * <p>Both the input and output value ranges must match. Overflow/underflow |
| * values are clipped to fit within the range.</p> |
| * |
| * @see ACAMERA_COLOR_CORRECTION_GAINS |
| * @see ACAMERA_COLOR_CORRECTION_TRANSFORM |
| * @see ACAMERA_CONTROL_AWB_MODE |
| */ |
| ACAMERA_COLOR_CORRECTION_MODE = // byte (enum) |
| ACAMERA_COLOR_CORRECTION_START, |
| /** |
| * <p>A color transform matrix to use to transform |
| * from sensor RGB color space to output linear sRGB color space.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>This matrix is either set by the camera device when the request |
| * ACAMERA_COLOR_CORRECTION_MODE is not TRANSFORM_MATRIX, or |
| * directly by the application in the request when the |
| * ACAMERA_COLOR_CORRECTION_MODE is TRANSFORM_MATRIX.</p> |
| * <p>In the latter case, the camera device may round the matrix to account |
| * for precision issues; the final rounded matrix should be reported back |
| * in this matrix result metadata. The transform should keep the magnitude |
| * of the output color values within <code>[0, 1.0]</code> (assuming input color |
| * values is within the normalized range <code>[0, 1.0]</code>), or clipping may occur.</p> |
| * <p>The valid range of each matrix element varies on different devices, but |
| * values within [-1.5, 3.0] are guaranteed not to be clipped.</p> |
| * |
| * @see ACAMERA_COLOR_CORRECTION_MODE |
| */ |
| ACAMERA_COLOR_CORRECTION_TRANSFORM = // rational[3*3] |
| ACAMERA_COLOR_CORRECTION_START + 1, |
| /** |
| * <p>Gains applying to Bayer raw color channels for |
| * white-balance.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>These per-channel gains are either set by the camera device |
| * when the request ACAMERA_COLOR_CORRECTION_MODE is not |
| * TRANSFORM_MATRIX, or directly by the application in the |
| * request when the ACAMERA_COLOR_CORRECTION_MODE is |
| * TRANSFORM_MATRIX.</p> |
| * <p>The gains in the result metadata are the gains actually |
| * applied by the camera device to the current frame.</p> |
| * <p>The valid range of gains varies on different devices, but gains |
| * between [1.0, 3.0] are guaranteed not to be clipped. Even if a given |
| * device allows gains below 1.0, this is usually not recommended because |
| * this can create color artifacts.</p> |
| * |
| * @see ACAMERA_COLOR_CORRECTION_MODE |
| */ |
| ACAMERA_COLOR_CORRECTION_GAINS = // float[4] |
| ACAMERA_COLOR_CORRECTION_START + 2, |
| /** |
| * <p>Mode of operation for the chromatic aberration correction algorithm.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>Chromatic (color) aberration is caused by the fact that different wavelengths of light |
| * can not focus on the same point after exiting from the lens. This metadata defines |
| * the high level control of chromatic aberration correction algorithm, which aims to |
| * minimize the chromatic artifacts that may occur along the object boundaries in an |
| * image.</p> |
| * <p>FAST/HIGH_QUALITY both mean that camera device determined aberration |
| * correction will be applied. HIGH_QUALITY mode indicates that the camera device will |
| * use the highest-quality aberration correction algorithms, even if it slows down |
| * capture rate. FAST means the camera device will not slow down capture rate when |
| * applying aberration correction.</p> |
| * <p>LEGACY devices will always be in FAST mode.</p> |
| */ |
| ACAMERA_COLOR_CORRECTION_ABERRATION_MODE = // byte (enum) |
| ACAMERA_COLOR_CORRECTION_START + 3, |
| /** |
| * <p>List of aberration correction modes for ACAMERA_COLOR_CORRECTION_ABERRATION_MODE that are |
| * supported by this camera device.</p> |
| * |
| * @see ACAMERA_COLOR_CORRECTION_ABERRATION_MODE |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>This key lists the valid modes for ACAMERA_COLOR_CORRECTION_ABERRATION_MODE. If no |
| * aberration correction modes are available for a device, this list will solely include |
| * OFF mode. All camera devices will support either OFF or FAST mode.</p> |
| * <p>Camera devices that support the MANUAL_POST_PROCESSING capability will always list |
| * OFF mode. This includes all FULL level devices.</p> |
| * <p>LEGACY devices will always only support FAST mode.</p> |
| * |
| * @see ACAMERA_COLOR_CORRECTION_ABERRATION_MODE |
| */ |
| ACAMERA_COLOR_CORRECTION_AVAILABLE_ABERRATION_MODES = // byte[n] |
| ACAMERA_COLOR_CORRECTION_START + 4, |
| ACAMERA_COLOR_CORRECTION_END, |
| |
| /** |
| * <p>The desired setting for the camera device's auto-exposure |
| * algorithm's antibanding compensation.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>Some kinds of lighting fixtures, such as some fluorescent |
| * lights, flicker at the rate of the power supply frequency |
| * (60Hz or 50Hz, depending on country). While this is |
| * typically not noticeable to a person, it can be visible to |
| * a camera device. If a camera sets its exposure time to the |
| * wrong value, the flicker may become visible in the |
| * viewfinder as flicker or in a final captured image, as a |
| * set of variable-brightness bands across the image.</p> |
| * <p>Therefore, the auto-exposure routines of camera devices |
| * include antibanding routines that ensure that the chosen |
| * exposure value will not cause such banding. The choice of |
| * exposure time depends on the rate of flicker, which the |
| * camera device can detect automatically, or the expected |
| * rate can be selected by the application using this |
| * control.</p> |
| * <p>A given camera device may not support all of the possible |
| * options for the antibanding mode. The |
| * ACAMERA_CONTROL_AE_AVAILABLE_ANTIBANDING_MODES key contains |
| * the available modes for a given camera device.</p> |
| * <p>AUTO mode is the default if it is available on given |
| * camera device. When AUTO mode is not available, the |
| * default will be either 50HZ or 60HZ, and both 50HZ |
| * and 60HZ will be available.</p> |
| * <p>If manual exposure control is enabled (by setting |
| * ACAMERA_CONTROL_AE_MODE or ACAMERA_CONTROL_MODE to OFF), |
| * then this setting has no effect, and the application must |
| * ensure it selects exposure times that do not cause banding |
| * issues. The ACAMERA_STATISTICS_SCENE_FLICKER key can assist |
| * the application in this.</p> |
| * |
| * @see ACAMERA_CONTROL_AE_AVAILABLE_ANTIBANDING_MODES |
| * @see ACAMERA_CONTROL_AE_MODE |
| * @see ACAMERA_CONTROL_MODE |
| * @see ACAMERA_STATISTICS_SCENE_FLICKER |
| */ |
| ACAMERA_CONTROL_AE_ANTIBANDING_MODE = // byte (enum) |
| ACAMERA_CONTROL_START, |
| /** |
| * <p>Adjustment to auto-exposure (AE) target image |
| * brightness.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>The adjustment is measured as a count of steps, with the |
| * step size defined by ACAMERA_CONTROL_AE_COMPENSATION_STEP and the |
| * allowed range by ACAMERA_CONTROL_AE_COMPENSATION_RANGE.</p> |
| * <p>For example, if the exposure value (EV) step is 0.333, '6' |
| * will mean an exposure compensation of +2 EV; -3 will mean an |
| * exposure compensation of -1 EV. One EV represents a doubling |
| * of image brightness. Note that this control will only be |
| * effective if ACAMERA_CONTROL_AE_MODE <code>!=</code> OFF. This control |
| * will take effect even when ACAMERA_CONTROL_AE_LOCK <code>== true</code>.</p> |
| * <p>In the event of exposure compensation value being changed, camera device |
| * may take several frames to reach the newly requested exposure target. |
| * During that time, ACAMERA_CONTROL_AE_STATE field will be in the SEARCHING |
| * state. Once the new exposure target is reached, ACAMERA_CONTROL_AE_STATE will |
| * change from SEARCHING to either CONVERGED, LOCKED (if AE lock is enabled), or |
| * FLASH_REQUIRED (if the scene is too dark for still capture).</p> |
| * |
| * @see ACAMERA_CONTROL_AE_COMPENSATION_RANGE |
| * @see ACAMERA_CONTROL_AE_COMPENSATION_STEP |
| * @see ACAMERA_CONTROL_AE_LOCK |
| * @see ACAMERA_CONTROL_AE_MODE |
| * @see ACAMERA_CONTROL_AE_STATE |
| */ |
| ACAMERA_CONTROL_AE_EXPOSURE_COMPENSATION = // int32 |
| ACAMERA_CONTROL_START + 1, |
| /** |
| * <p>Whether auto-exposure (AE) is currently locked to its latest |
| * calculated values.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>When set to <code>true</code> (ON), the AE algorithm is locked to its latest parameters, |
| * and will not change exposure settings until the lock is set to <code>false</code> (OFF).</p> |
| * <p>Note that even when AE is locked, the flash may be fired if |
| * the ACAMERA_CONTROL_AE_MODE is ON_AUTO_FLASH / |
| * ON_ALWAYS_FLASH / ON_AUTO_FLASH_REDEYE.</p> |
| * <p>When ACAMERA_CONTROL_AE_EXPOSURE_COMPENSATION is changed, even if the AE lock |
| * is ON, the camera device will still adjust its exposure value.</p> |
| * <p>If AE precapture is triggered (see ACAMERA_CONTROL_AE_PRECAPTURE_TRIGGER) |
| * when AE is already locked, the camera device will not change the exposure time |
| * (ACAMERA_SENSOR_EXPOSURE_TIME) and sensitivity (ACAMERA_SENSOR_SENSITIVITY) |
| * parameters. The flash may be fired if the ACAMERA_CONTROL_AE_MODE |
| * is ON_AUTO_FLASH/ON_AUTO_FLASH_REDEYE and the scene is too dark. If the |
| * ACAMERA_CONTROL_AE_MODE is ON_ALWAYS_FLASH, the scene may become overexposed. |
| * Similarly, AE precapture trigger CANCEL has no effect when AE is already locked.</p> |
| * <p>When an AE precapture sequence is triggered, AE unlock will not be able to unlock |
| * the AE if AE is locked by the camera device internally during precapture metering |
| * sequence In other words, submitting requests with AE unlock has no effect for an |
| * ongoing precapture metering sequence. Otherwise, the precapture metering sequence |
| * will never succeed in a sequence of preview requests where AE lock is always set |
| * to <code>false</code>.</p> |
| * <p>Since the camera device has a pipeline of in-flight requests, the settings that |
| * get locked do not necessarily correspond to the settings that were present in the |
| * latest capture result received from the camera device, since additional captures |
| * and AE updates may have occurred even before the result was sent out. If an |
| * application is switching between automatic and manual control and wishes to eliminate |
| * any flicker during the switch, the following procedure is recommended:</p> |
| * <ol> |
| * <li>Starting in auto-AE mode:</li> |
| * <li>Lock AE</li> |
| * <li>Wait for the first result to be output that has the AE locked</li> |
| * <li>Copy exposure settings from that result into a request, set the request to manual AE</li> |
| * <li>Submit the capture request, proceed to run manual AE as desired.</li> |
| * </ol> |
| * <p>See ACAMERA_CONTROL_AE_STATE for AE lock related state transition details.</p> |
| * |
| * @see ACAMERA_CONTROL_AE_EXPOSURE_COMPENSATION |
| * @see ACAMERA_CONTROL_AE_MODE |
| * @see ACAMERA_CONTROL_AE_PRECAPTURE_TRIGGER |
| * @see ACAMERA_CONTROL_AE_STATE |
| * @see ACAMERA_SENSOR_EXPOSURE_TIME |
| * @see ACAMERA_SENSOR_SENSITIVITY |
| */ |
| ACAMERA_CONTROL_AE_LOCK = // byte (enum) |
| ACAMERA_CONTROL_START + 2, |
| /** |
| * <p>The desired mode for the camera device's |
| * auto-exposure routine.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>This control is only effective if ACAMERA_CONTROL_MODE is |
| * AUTO.</p> |
| * <p>When set to any of the ON modes, the camera device's |
| * auto-exposure routine is enabled, overriding the |
| * application's selected exposure time, sensor sensitivity, |
| * and frame duration (ACAMERA_SENSOR_EXPOSURE_TIME, |
| * ACAMERA_SENSOR_SENSITIVITY, and |
| * ACAMERA_SENSOR_FRAME_DURATION). If one of the FLASH modes |
| * is selected, the camera device's flash unit controls are |
| * also overridden.</p> |
| * <p>The FLASH modes are only available if the camera device |
| * has a flash unit (ACAMERA_FLASH_INFO_AVAILABLE is <code>true</code>).</p> |
| * <p>If flash TORCH mode is desired, this field must be set to |
| * ON or OFF, and ACAMERA_FLASH_MODE set to TORCH.</p> |
| * <p>When set to any of the ON modes, the values chosen by the |
| * camera device auto-exposure routine for the overridden |
| * fields for a given capture will be available in its |
| * CaptureResult.</p> |
| * |
| * @see ACAMERA_CONTROL_MODE |
| * @see ACAMERA_FLASH_INFO_AVAILABLE |
| * @see ACAMERA_FLASH_MODE |
| * @see ACAMERA_SENSOR_EXPOSURE_TIME |
| * @see ACAMERA_SENSOR_FRAME_DURATION |
| * @see ACAMERA_SENSOR_SENSITIVITY |
| */ |
| ACAMERA_CONTROL_AE_MODE = // byte (enum) |
| ACAMERA_CONTROL_START + 3, |
| /** |
| * <p>List of metering areas to use for auto-exposure adjustment.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>Not available if android.control.maxRegionsAe is 0. |
| * Otherwise will always be present.</p> |
| * <p>The maximum number of regions supported by the device is determined by the value |
| * of android.control.maxRegionsAe.</p> |
| * <p>The data representation is int[5 * area_count]. |
| * Every five elements represent a metering region of (xmin, ymin, xmax, ymax, weight). |
| * The rectangle is defined to be inclusive on xmin and ymin, but exclusive on xmax and |
| * ymax.</p> |
| * <p>The coordinate system is based on the active pixel array, |
| * with (0,0) being the top-left pixel in the active pixel array, and |
| * (ACAMERA_SENSOR_INFO_ACTIVE_ARRAY_SIZE.width - 1, |
| * ACAMERA_SENSOR_INFO_ACTIVE_ARRAY_SIZE.height - 1) being the |
| * bottom-right pixel in the active pixel array.</p> |
| * <p>The weight must be within <code>[0, 1000]</code>, and represents a weight |
| * for every pixel in the area. This means that a large metering area |
| * with the same weight as a smaller area will have more effect in |
| * the metering result. Metering areas can partially overlap and the |
| * camera device will add the weights in the overlap region.</p> |
| * <p>The weights are relative to weights of other exposure metering regions, so if only one |
| * region is used, all non-zero weights will have the same effect. A region with 0 |
| * weight is ignored.</p> |
| * <p>If all regions have 0 weight, then no specific metering area needs to be used by the |
| * camera device.</p> |
| * <p>If the metering region is outside the used ACAMERA_SCALER_CROP_REGION returned in |
| * capture result metadata, the camera device will ignore the sections outside the crop |
| * region and output only the intersection rectangle as the metering region in the result |
| * metadata. If the region is entirely outside the crop region, it will be ignored and |
| * not reported in the result metadata.</p> |
| * |
| * @see ACAMERA_SCALER_CROP_REGION |
| * @see ACAMERA_SENSOR_INFO_ACTIVE_ARRAY_SIZE |
| */ |
| ACAMERA_CONTROL_AE_REGIONS = // int32[5*area_count] |
| ACAMERA_CONTROL_START + 4, |
| /** |
| * <p>Range over which the auto-exposure routine can |
| * adjust the capture frame rate to maintain good |
| * exposure.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>Only constrains auto-exposure (AE) algorithm, not |
| * manual control of ACAMERA_SENSOR_EXPOSURE_TIME and |
| * ACAMERA_SENSOR_FRAME_DURATION.</p> |
| * |
| * @see ACAMERA_SENSOR_EXPOSURE_TIME |
| * @see ACAMERA_SENSOR_FRAME_DURATION |
| */ |
| ACAMERA_CONTROL_AE_TARGET_FPS_RANGE = // int32[2] |
| ACAMERA_CONTROL_START + 5, |
| /** |
| * <p>Whether the camera device will trigger a precapture |
| * metering sequence when it processes this request.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>This entry is normally set to IDLE, or is not |
| * included at all in the request settings. When included and |
| * set to START, the camera device will trigger the auto-exposure (AE) |
| * precapture metering sequence.</p> |
| * <p>When set to CANCEL, the camera device will cancel any active |
| * precapture metering trigger, and return to its initial AE state. |
| * If a precapture metering sequence is already completed, and the camera |
| * device has implicitly locked the AE for subsequent still capture, the |
| * CANCEL trigger will unlock the AE and return to its initial AE state.</p> |
| * <p>The precapture sequence should be triggered before starting a |
| * high-quality still capture for final metering decisions to |
| * be made, and for firing pre-capture flash pulses to estimate |
| * scene brightness and required final capture flash power, when |
| * the flash is enabled.</p> |
| * <p>Normally, this entry should be set to START for only a |
| * single request, and the application should wait until the |
| * sequence completes before starting a new one.</p> |
| * <p>When a precapture metering sequence is finished, the camera device |
| * may lock the auto-exposure routine internally to be able to accurately expose the |
| * subsequent still capture image (<code>ACAMERA_CONTROL_CAPTURE_INTENT == STILL_CAPTURE</code>). |
| * For this case, the AE may not resume normal scan if no subsequent still capture is |
| * submitted. To ensure that the AE routine restarts normal scan, the application should |
| * submit a request with <code>ACAMERA_CONTROL_AE_LOCK == true</code>, followed by a request |
| * with <code>ACAMERA_CONTROL_AE_LOCK == false</code>, if the application decides not to submit a |
| * still capture request after the precapture sequence completes. Alternatively, for |
| * API level 23 or newer devices, the CANCEL can be used to unlock the camera device |
| * internally locked AE if the application doesn't submit a still capture request after |
| * the AE precapture trigger. Note that, the CANCEL was added in API level 23, and must not |
| * be used in devices that have earlier API levels.</p> |
| * <p>The exact effect of auto-exposure (AE) precapture trigger |
| * depends on the current AE mode and state; see |
| * ACAMERA_CONTROL_AE_STATE for AE precapture state transition |
| * details.</p> |
| * <p>On LEGACY-level devices, the precapture trigger is not supported; |
| * capturing a high-resolution JPEG image will automatically trigger a |
| * precapture sequence before the high-resolution capture, including |
| * potentially firing a pre-capture flash.</p> |
| * <p>Using the precapture trigger and the auto-focus trigger ACAMERA_CONTROL_AF_TRIGGER |
| * simultaneously is allowed. However, since these triggers often require cooperation between |
| * the auto-focus and auto-exposure routines (for example, the may need to be enabled for a |
| * focus sweep), the camera device may delay acting on a later trigger until the previous |
| * trigger has been fully handled. This may lead to longer intervals between the trigger and |
| * changes to ACAMERA_CONTROL_AE_STATE indicating the start of the precapture sequence, for |
| * example.</p> |
| * <p>If both the precapture and the auto-focus trigger are activated on the same request, then |
| * the camera device will complete them in the optimal order for that device.</p> |
| * |
| * @see ACAMERA_CONTROL_AE_LOCK |
| * @see ACAMERA_CONTROL_AE_STATE |
| * @see ACAMERA_CONTROL_AF_TRIGGER |
| * @see ACAMERA_CONTROL_CAPTURE_INTENT |
| */ |
| ACAMERA_CONTROL_AE_PRECAPTURE_TRIGGER = // byte (enum) |
| ACAMERA_CONTROL_START + 6, |
| /** |
| * <p>Whether auto-focus (AF) is currently enabled, and what |
| * mode it is set to.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>Only effective if ACAMERA_CONTROL_MODE = AUTO and the lens is not fixed focus |
| * (i.e. <code>ACAMERA_LENS_INFO_MINIMUM_FOCUS_DISTANCE > 0</code>). Also note that |
| * when ACAMERA_CONTROL_AE_MODE is OFF, the behavior of AF is device |
| * dependent. It is recommended to lock AF by using ACAMERA_CONTROL_AF_TRIGGER before |
| * setting ACAMERA_CONTROL_AE_MODE to OFF, or set AF mode to OFF when AE is OFF.</p> |
| * <p>If the lens is controlled by the camera device auto-focus algorithm, |
| * the camera device will report the current AF status in ACAMERA_CONTROL_AF_STATE |
| * in result metadata.</p> |
| * |
| * @see ACAMERA_CONTROL_AE_MODE |
| * @see ACAMERA_CONTROL_AF_STATE |
| * @see ACAMERA_CONTROL_AF_TRIGGER |
| * @see ACAMERA_CONTROL_MODE |
| * @see ACAMERA_LENS_INFO_MINIMUM_FOCUS_DISTANCE |
| */ |
| ACAMERA_CONTROL_AF_MODE = // byte (enum) |
| ACAMERA_CONTROL_START + 7, |
| /** |
| * <p>List of metering areas to use for auto-focus.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>Not available if android.control.maxRegionsAf is 0. |
| * Otherwise will always be present.</p> |
| * <p>The maximum number of focus areas supported by the device is determined by the value |
| * of android.control.maxRegionsAf.</p> |
| * <p>The data representation is int[5 * area_count]. |
| * Every five elements represent a metering region of (xmin, ymin, xmax, ymax, weight). |
| * The rectangle is defined to be inclusive on xmin and ymin, but exclusive on xmax and |
| * ymax.</p> |
| * <p>The coordinate system is based on the active pixel array, |
| * with (0,0) being the top-left pixel in the active pixel array, and |
| * (ACAMERA_SENSOR_INFO_ACTIVE_ARRAY_SIZE.width - 1, |
| * ACAMERA_SENSOR_INFO_ACTIVE_ARRAY_SIZE.height - 1) being the |
| * bottom-right pixel in the active pixel array.</p> |
| * <p>The weight must be within <code>[0, 1000]</code>, and represents a weight |
| * for every pixel in the area. This means that a large metering area |
| * with the same weight as a smaller area will have more effect in |
| * the metering result. Metering areas can partially overlap and the |
| * camera device will add the weights in the overlap region.</p> |
| * <p>The weights are relative to weights of other metering regions, so if only one region |
| * is used, all non-zero weights will have the same effect. A region with 0 weight is |
| * ignored.</p> |
| * <p>If all regions have 0 weight, then no specific metering area needs to be used by the |
| * camera device.</p> |
| * <p>If the metering region is outside the used ACAMERA_SCALER_CROP_REGION returned in |
| * capture result metadata, the camera device will ignore the sections outside the crop |
| * region and output only the intersection rectangle as the metering region in the result |
| * metadata. If the region is entirely outside the crop region, it will be ignored and |
| * not reported in the result metadata.</p> |
| * |
| * @see ACAMERA_SCALER_CROP_REGION |
| * @see ACAMERA_SENSOR_INFO_ACTIVE_ARRAY_SIZE |
| */ |
| ACAMERA_CONTROL_AF_REGIONS = // int32[5*area_count] |
| ACAMERA_CONTROL_START + 8, |
| /** |
| * <p>Whether the camera device will trigger autofocus for this request.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>This entry is normally set to IDLE, or is not |
| * included at all in the request settings.</p> |
| * <p>When included and set to START, the camera device will trigger the |
| * autofocus algorithm. If autofocus is disabled, this trigger has no effect.</p> |
| * <p>When set to CANCEL, the camera device will cancel any active trigger, |
| * and return to its initial AF state.</p> |
| * <p>Generally, applications should set this entry to START or CANCEL for only a |
| * single capture, and then return it to IDLE (or not set at all). Specifying |
| * START for multiple captures in a row means restarting the AF operation over |
| * and over again.</p> |
| * <p>See ACAMERA_CONTROL_AF_STATE for what the trigger means for each AF mode.</p> |
| * <p>Using the autofocus trigger and the precapture trigger ACAMERA_CONTROL_AE_PRECAPTURE_TRIGGER |
| * simultaneously is allowed. However, since these triggers often require cooperation between |
| * the auto-focus and auto-exposure routines (for example, the may need to be enabled for a |
| * focus sweep), the camera device may delay acting on a later trigger until the previous |
| * trigger has been fully handled. This may lead to longer intervals between the trigger and |
| * changes to ACAMERA_CONTROL_AF_STATE, for example.</p> |
| * |
| * @see ACAMERA_CONTROL_AE_PRECAPTURE_TRIGGER |
| * @see ACAMERA_CONTROL_AF_STATE |
| */ |
| ACAMERA_CONTROL_AF_TRIGGER = // byte (enum) |
| ACAMERA_CONTROL_START + 9, |
| /** |
| * <p>Whether auto-white balance (AWB) is currently locked to its |
| * latest calculated values.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>When set to <code>true</code> (ON), the AWB algorithm is locked to its latest parameters, |
| * and will not change color balance settings until the lock is set to <code>false</code> (OFF).</p> |
| * <p>Since the camera device has a pipeline of in-flight requests, the settings that |
| * get locked do not necessarily correspond to the settings that were present in the |
| * latest capture result received from the camera device, since additional captures |
| * and AWB updates may have occurred even before the result was sent out. If an |
| * application is switching between automatic and manual control and wishes to eliminate |
| * any flicker during the switch, the following procedure is recommended:</p> |
| * <ol> |
| * <li>Starting in auto-AWB mode:</li> |
| * <li>Lock AWB</li> |
| * <li>Wait for the first result to be output that has the AWB locked</li> |
| * <li>Copy AWB settings from that result into a request, set the request to manual AWB</li> |
| * <li>Submit the capture request, proceed to run manual AWB as desired.</li> |
| * </ol> |
| * <p>Note that AWB lock is only meaningful when |
| * ACAMERA_CONTROL_AWB_MODE is in the AUTO mode; in other modes, |
| * AWB is already fixed to a specific setting.</p> |
| * <p>Some LEGACY devices may not support ON; the value is then overridden to OFF.</p> |
| * |
| * @see ACAMERA_CONTROL_AWB_MODE |
| */ |
| ACAMERA_CONTROL_AWB_LOCK = // byte (enum) |
| ACAMERA_CONTROL_START + 10, |
| /** |
| * <p>Whether auto-white balance (AWB) is currently setting the color |
| * transform fields, and what its illumination target |
| * is.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>This control is only effective if ACAMERA_CONTROL_MODE is AUTO.</p> |
| * <p>When set to the ON mode, the camera device's auto-white balance |
| * routine is enabled, overriding the application's selected |
| * ACAMERA_COLOR_CORRECTION_TRANSFORM, ACAMERA_COLOR_CORRECTION_GAINS and |
| * ACAMERA_COLOR_CORRECTION_MODE. Note that when ACAMERA_CONTROL_AE_MODE |
| * is OFF, the behavior of AWB is device dependent. It is recommened to |
| * also set AWB mode to OFF or lock AWB by using ACAMERA_CONTROL_AWB_LOCK before |
| * setting AE mode to OFF.</p> |
| * <p>When set to the OFF mode, the camera device's auto-white balance |
| * routine is disabled. The application manually controls the white |
| * balance by ACAMERA_COLOR_CORRECTION_TRANSFORM, ACAMERA_COLOR_CORRECTION_GAINS |
| * and ACAMERA_COLOR_CORRECTION_MODE.</p> |
| * <p>When set to any other modes, the camera device's auto-white |
| * balance routine is disabled. The camera device uses each |
| * particular illumination target for white balance |
| * adjustment. The application's values for |
| * ACAMERA_COLOR_CORRECTION_TRANSFORM, |
| * ACAMERA_COLOR_CORRECTION_GAINS and |
| * ACAMERA_COLOR_CORRECTION_MODE are ignored.</p> |
| * |
| * @see ACAMERA_COLOR_CORRECTION_GAINS |
| * @see ACAMERA_COLOR_CORRECTION_MODE |
| * @see ACAMERA_COLOR_CORRECTION_TRANSFORM |
| * @see ACAMERA_CONTROL_AE_MODE |
| * @see ACAMERA_CONTROL_AWB_LOCK |
| * @see ACAMERA_CONTROL_MODE |
| */ |
| ACAMERA_CONTROL_AWB_MODE = // byte (enum) |
| ACAMERA_CONTROL_START + 11, |
| /** |
| * <p>List of metering areas to use for auto-white-balance illuminant |
| * estimation.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>Not available if android.control.maxRegionsAwb is 0. |
| * Otherwise will always be present.</p> |
| * <p>The maximum number of regions supported by the device is determined by the value |
| * of android.control.maxRegionsAwb.</p> |
| * <p>The data representation is int[5 * area_count]. |
| * Every five elements represent a metering region of (xmin, ymin, xmax, ymax, weight). |
| * The rectangle is defined to be inclusive on xmin and ymin, but exclusive on xmax and |
| * ymax.</p> |
| * <p>The coordinate system is based on the active pixel array, |
| * with (0,0) being the top-left pixel in the active pixel array, and |
| * (ACAMERA_SENSOR_INFO_ACTIVE_ARRAY_SIZE.width - 1, |
| * ACAMERA_SENSOR_INFO_ACTIVE_ARRAY_SIZE.height - 1) being the |
| * bottom-right pixel in the active pixel array.</p> |
| * <p>The weight must range from 0 to 1000, and represents a weight |
| * for every pixel in the area. This means that a large metering area |
| * with the same weight as a smaller area will have more effect in |
| * the metering result. Metering areas can partially overlap and the |
| * camera device will add the weights in the overlap region.</p> |
| * <p>The weights are relative to weights of other white balance metering regions, so if |
| * only one region is used, all non-zero weights will have the same effect. A region with |
| * 0 weight is ignored.</p> |
| * <p>If all regions have 0 weight, then no specific metering area needs to be used by the |
| * camera device.</p> |
| * <p>If the metering region is outside the used ACAMERA_SCALER_CROP_REGION returned in |
| * capture result metadata, the camera device will ignore the sections outside the crop |
| * region and output only the intersection rectangle as the metering region in the result |
| * metadata. If the region is entirely outside the crop region, it will be ignored and |
| * not reported in the result metadata.</p> |
| * |
| * @see ACAMERA_SCALER_CROP_REGION |
| * @see ACAMERA_SENSOR_INFO_ACTIVE_ARRAY_SIZE |
| */ |
| ACAMERA_CONTROL_AWB_REGIONS = // int32[5*area_count] |
| ACAMERA_CONTROL_START + 12, |
| /** |
| * <p>Information to the camera device 3A (auto-exposure, |
| * auto-focus, auto-white balance) routines about the purpose |
| * of this capture, to help the camera device to decide optimal 3A |
| * strategy.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>This control (except for MANUAL) is only effective if |
| * <code>ACAMERA_CONTROL_MODE != OFF</code> and any 3A routine is active.</p> |
| * <p>ZERO_SHUTTER_LAG will be supported if ACAMERA_REQUEST_AVAILABLE_CAPABILITIES |
| * contains PRIVATE_REPROCESSING or YUV_REPROCESSING. MANUAL will be supported if |
| * ACAMERA_REQUEST_AVAILABLE_CAPABILITIES contains MANUAL_SENSOR. Other intent values are |
| * always supported.</p> |
| * |
| * @see ACAMERA_CONTROL_MODE |
| * @see ACAMERA_REQUEST_AVAILABLE_CAPABILITIES |
| */ |
| ACAMERA_CONTROL_CAPTURE_INTENT = // byte (enum) |
| ACAMERA_CONTROL_START + 13, |
| /** |
| * <p>A special color effect to apply.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>When this mode is set, a color effect will be applied |
| * to images produced by the camera device. The interpretation |
| * and implementation of these color effects is left to the |
| * implementor of the camera device, and should not be |
| * depended on to be consistent (or present) across all |
| * devices.</p> |
| */ |
| ACAMERA_CONTROL_EFFECT_MODE = // byte (enum) |
| ACAMERA_CONTROL_START + 14, |
| /** |
| * <p>Overall mode of 3A (auto-exposure, auto-white-balance, auto-focus) control |
| * routines.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>This is a top-level 3A control switch. When set to OFF, all 3A control |
| * by the camera device is disabled. The application must set the fields for |
| * capture parameters itself.</p> |
| * <p>When set to AUTO, the individual algorithm controls in |
| * ACAMERA_CONTROL_* are in effect, such as ACAMERA_CONTROL_AF_MODE.</p> |
| * <p>When set to USE_SCENE_MODE, the individual controls in |
| * ACAMERA_CONTROL_* are mostly disabled, and the camera device implements |
| * one of the scene mode settings (such as ACTION, SUNSET, or PARTY) |
| * as it wishes. The camera device scene mode 3A settings are provided by |
| * capture results {@link ACameraMetadata} from |
| * {@link ACameraCaptureSession_captureCallback_result}.</p> |
| * <p>When set to OFF_KEEP_STATE, it is similar to OFF mode, the only difference |
| * is that this frame will not be used by camera device background 3A statistics |
| * update, as if this frame is never captured. This mode can be used in the scenario |
| * where the application doesn't want a 3A manual control capture to affect |
| * the subsequent auto 3A capture results.</p> |
| * |
| * @see ACAMERA_CONTROL_AF_MODE |
| */ |
| ACAMERA_CONTROL_MODE = // byte (enum) |
| ACAMERA_CONTROL_START + 15, |
| /** |
| * <p>Control for which scene mode is currently active.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>Scene modes are custom camera modes optimized for a certain set of conditions and |
| * capture settings.</p> |
| * <p>This is the mode that that is active when |
| * <code>ACAMERA_CONTROL_MODE == USE_SCENE_MODE</code>. Aside from FACE_PRIORITY, these modes will |
| * disable ACAMERA_CONTROL_AE_MODE, ACAMERA_CONTROL_AWB_MODE, and ACAMERA_CONTROL_AF_MODE |
| * while in use.</p> |
| * <p>The interpretation and implementation of these scene modes is left |
| * to the implementor of the camera device. Their behavior will not be |
| * consistent across all devices, and any given device may only implement |
| * a subset of these modes.</p> |
| * |
| * @see ACAMERA_CONTROL_AE_MODE |
| * @see ACAMERA_CONTROL_AF_MODE |
| * @see ACAMERA_CONTROL_AWB_MODE |
| * @see ACAMERA_CONTROL_MODE |
| */ |
| ACAMERA_CONTROL_SCENE_MODE = // byte (enum) |
| ACAMERA_CONTROL_START + 16, |
| /** |
| * <p>Whether video stabilization is |
| * active.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>Video stabilization automatically warps images from |
| * the camera in order to stabilize motion between consecutive frames.</p> |
| * <p>If enabled, video stabilization can modify the |
| * ACAMERA_SCALER_CROP_REGION to keep the video stream stabilized.</p> |
| * <p>Switching between different video stabilization modes may take several |
| * frames to initialize, the camera device will report the current mode |
| * in capture result metadata. For example, When "ON" mode is requested, |
| * the video stabilization modes in the first several capture results may |
| * still be "OFF", and it will become "ON" when the initialization is |
| * done.</p> |
| * <p>In addition, not all recording sizes or frame rates may be supported for |
| * stabilization by a device that reports stabilization support. It is guaranteed |
| * that an output targeting a MediaRecorder or MediaCodec will be stabilized if |
| * the recording resolution is less than or equal to 1920 x 1080 (width less than |
| * or equal to 1920, height less than or equal to 1080), and the recording |
| * frame rate is less than or equal to 30fps. At other sizes, the CaptureResult |
| * ACAMERA_CONTROL_VIDEO_STABILIZATION_MODE field will return |
| * OFF if the recording output is not stabilized, or if there are no output |
| * Surface types that can be stabilized.</p> |
| * <p>If a camera device supports both this mode and OIS |
| * (ACAMERA_LENS_OPTICAL_STABILIZATION_MODE), turning both modes on may |
| * produce undesirable interaction, so it is recommended not to enable |
| * both at the same time.</p> |
| * |
| * @see ACAMERA_CONTROL_VIDEO_STABILIZATION_MODE |
| * @see ACAMERA_LENS_OPTICAL_STABILIZATION_MODE |
| * @see ACAMERA_SCALER_CROP_REGION |
| */ |
| ACAMERA_CONTROL_VIDEO_STABILIZATION_MODE = // byte (enum) |
| ACAMERA_CONTROL_START + 17, |
| /** |
| * <p>List of auto-exposure antibanding modes for ACAMERA_CONTROL_AE_ANTIBANDING_MODE that are |
| * supported by this camera device.</p> |
| * |
| * @see ACAMERA_CONTROL_AE_ANTIBANDING_MODE |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>Not all of the auto-exposure anti-banding modes may be |
| * supported by a given camera device. This field lists the |
| * valid anti-banding modes that the application may request |
| * for this camera device with the |
| * ACAMERA_CONTROL_AE_ANTIBANDING_MODE control.</p> |
| * |
| * @see ACAMERA_CONTROL_AE_ANTIBANDING_MODE |
| */ |
| ACAMERA_CONTROL_AE_AVAILABLE_ANTIBANDING_MODES = // byte[n] |
| ACAMERA_CONTROL_START + 18, |
| /** |
| * <p>List of auto-exposure modes for ACAMERA_CONTROL_AE_MODE that are supported by this camera |
| * device.</p> |
| * |
| * @see ACAMERA_CONTROL_AE_MODE |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>Not all the auto-exposure modes may be supported by a |
| * given camera device, especially if no flash unit is |
| * available. This entry lists the valid modes for |
| * ACAMERA_CONTROL_AE_MODE for this camera device.</p> |
| * <p>All camera devices support ON, and all camera devices with flash |
| * units support ON_AUTO_FLASH and ON_ALWAYS_FLASH.</p> |
| * <p>FULL mode camera devices always support OFF mode, |
| * which enables application control of camera exposure time, |
| * sensitivity, and frame duration.</p> |
| * <p>LEGACY mode camera devices never support OFF mode. |
| * LIMITED mode devices support OFF if they support the MANUAL_SENSOR |
| * capability.</p> |
| * |
| * @see ACAMERA_CONTROL_AE_MODE |
| */ |
| ACAMERA_CONTROL_AE_AVAILABLE_MODES = // byte[n] |
| ACAMERA_CONTROL_START + 19, |
| /** |
| * <p>List of frame rate ranges for ACAMERA_CONTROL_AE_TARGET_FPS_RANGE supported by |
| * this camera device.</p> |
| * |
| * @see ACAMERA_CONTROL_AE_TARGET_FPS_RANGE |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>For devices at the LEGACY level or above:</p> |
| * <ul> |
| * <li> |
| * <p>For constant-framerate recording, for each normal |
| * <a href="https://developer.android.com/reference/android/media/CamcorderProfile.html">CamcorderProfile</a>, that is, a |
| * <a href="https://developer.android.com/reference/android/media/CamcorderProfile.html">CamcorderProfile</a> that has |
| * <a href="https://developer.android.com/reference/android/media/CamcorderProfile.html#quality">quality</a> |
| * in the range [ |
| * <a href="https://developer.android.com/reference/android/media/CamcorderProfile.html#QUALITY_LOW">QUALITY_LOW</a>, |
| * <a href="https://developer.android.com/reference/android/media/CamcorderProfile.html#QUALITY_2160P">QUALITY_2160P</a>], |
| * if the profile is supported by the device and has |
| * <a href="https://developer.android.com/reference/android/media/CamcorderProfile.html#videoFrameRate">videoFrameRate</a> |
| * <code>x</code>, this list will always include (<code>x</code>,<code>x</code>).</p> |
| * </li> |
| * <li> |
| * <p>Also, a camera device must either not support any |
| * <a href="https://developer.android.com/reference/android/media/CamcorderProfile.html">CamcorderProfile</a>, |
| * or support at least one |
| * normal <a href="https://developer.android.com/reference/android/media/CamcorderProfile.html">CamcorderProfile</a> |
| * that has |
| * <a href="https://developer.android.com/reference/android/media/CamcorderProfile.html#videoFrameRate">videoFrameRate</a> <code>x</code> >= 24.</p> |
| * </li> |
| * </ul> |
| * <p>For devices at the LIMITED level or above:</p> |
| * <ul> |
| * <li>For YUV_420_888 burst capture use case, this list will always include (<code>min</code>, <code>max</code>) |
| * and (<code>max</code>, <code>max</code>) where <code>min</code> <= 15 and <code>max</code> = the maximum output frame rate of the |
| * maximum YUV_420_888 output size.</li> |
| * </ul> |
| */ |
| ACAMERA_CONTROL_AE_AVAILABLE_TARGET_FPS_RANGES = // int32[2*n] |
| ACAMERA_CONTROL_START + 20, |
| /** |
| * <p>Maximum and minimum exposure compensation values for |
| * ACAMERA_CONTROL_AE_EXPOSURE_COMPENSATION, in counts of ACAMERA_CONTROL_AE_COMPENSATION_STEP, |
| * that are supported by this camera device.</p> |
| * |
| * @see ACAMERA_CONTROL_AE_COMPENSATION_STEP |
| * @see ACAMERA_CONTROL_AE_EXPOSURE_COMPENSATION |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>None</p> |
| */ |
| ACAMERA_CONTROL_AE_COMPENSATION_RANGE = // int32[2] |
| ACAMERA_CONTROL_START + 21, |
| /** |
| * <p>Smallest step by which the exposure compensation |
| * can be changed.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>This is the unit for ACAMERA_CONTROL_AE_EXPOSURE_COMPENSATION. For example, if this key has |
| * a value of <code>1/2</code>, then a setting of <code>-2</code> for ACAMERA_CONTROL_AE_EXPOSURE_COMPENSATION means |
| * that the target EV offset for the auto-exposure routine is -1 EV.</p> |
| * <p>One unit of EV compensation changes the brightness of the captured image by a factor |
| * of two. +1 EV doubles the image brightness, while -1 EV halves the image brightness.</p> |
| * |
| * @see ACAMERA_CONTROL_AE_EXPOSURE_COMPENSATION |
| */ |
| ACAMERA_CONTROL_AE_COMPENSATION_STEP = // rational |
| ACAMERA_CONTROL_START + 22, |
| /** |
| * <p>List of auto-focus (AF) modes for ACAMERA_CONTROL_AF_MODE that are |
| * supported by this camera device.</p> |
| * |
| * @see ACAMERA_CONTROL_AF_MODE |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>Not all the auto-focus modes may be supported by a |
| * given camera device. This entry lists the valid modes for |
| * ACAMERA_CONTROL_AF_MODE for this camera device.</p> |
| * <p>All LIMITED and FULL mode camera devices will support OFF mode, and all |
| * camera devices with adjustable focuser units |
| * (<code>ACAMERA_LENS_INFO_MINIMUM_FOCUS_DISTANCE > 0</code>) will support AUTO mode.</p> |
| * <p>LEGACY devices will support OFF mode only if they support |
| * focusing to infinity (by also setting ACAMERA_LENS_FOCUS_DISTANCE to |
| * <code>0.0f</code>).</p> |
| * |
| * @see ACAMERA_CONTROL_AF_MODE |
| * @see ACAMERA_LENS_FOCUS_DISTANCE |
| * @see ACAMERA_LENS_INFO_MINIMUM_FOCUS_DISTANCE |
| */ |
| ACAMERA_CONTROL_AF_AVAILABLE_MODES = // byte[n] |
| ACAMERA_CONTROL_START + 23, |
| /** |
| * <p>List of color effects for ACAMERA_CONTROL_EFFECT_MODE that are supported by this camera |
| * device.</p> |
| * |
| * @see ACAMERA_CONTROL_EFFECT_MODE |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>This list contains the color effect modes that can be applied to |
| * images produced by the camera device. |
| * Implementations are not expected to be consistent across all devices. |
| * If no color effect modes are available for a device, this will only list |
| * OFF.</p> |
| * <p>A color effect will only be applied if |
| * ACAMERA_CONTROL_MODE != OFF. OFF is always included in this list.</p> |
| * <p>This control has no effect on the operation of other control routines such |
| * as auto-exposure, white balance, or focus.</p> |
| * |
| * @see ACAMERA_CONTROL_MODE |
| */ |
| ACAMERA_CONTROL_AVAILABLE_EFFECTS = // byte[n] |
| ACAMERA_CONTROL_START + 24, |
| /** |
| * <p>List of scene modes for ACAMERA_CONTROL_SCENE_MODE that are supported by this camera |
| * device.</p> |
| * |
| * @see ACAMERA_CONTROL_SCENE_MODE |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>This list contains scene modes that can be set for the camera device. |
| * Only scene modes that have been fully implemented for the |
| * camera device may be included here. Implementations are not expected |
| * to be consistent across all devices.</p> |
| * <p>If no scene modes are supported by the camera device, this |
| * will be set to DISABLED. Otherwise DISABLED will not be listed.</p> |
| * <p>FACE_PRIORITY is always listed if face detection is |
| * supported (i.e.<code>ACAMERA_STATISTICS_INFO_MAX_FACE_COUNT > |
| * 0</code>).</p> |
| * |
| * @see ACAMERA_STATISTICS_INFO_MAX_FACE_COUNT |
| */ |
| ACAMERA_CONTROL_AVAILABLE_SCENE_MODES = // byte[n] |
| ACAMERA_CONTROL_START + 25, |
| /** |
| * <p>List of video stabilization modes for ACAMERA_CONTROL_VIDEO_STABILIZATION_MODE |
| * that are supported by this camera device.</p> |
| * |
| * @see ACAMERA_CONTROL_VIDEO_STABILIZATION_MODE |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>OFF will always be listed.</p> |
| */ |
| ACAMERA_CONTROL_AVAILABLE_VIDEO_STABILIZATION_MODES = // byte[n] |
| ACAMERA_CONTROL_START + 26, |
| /** |
| * <p>List of auto-white-balance modes for ACAMERA_CONTROL_AWB_MODE that are supported by this |
| * camera device.</p> |
| * |
| * @see ACAMERA_CONTROL_AWB_MODE |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>Not all the auto-white-balance modes may be supported by a |
| * given camera device. This entry lists the valid modes for |
| * ACAMERA_CONTROL_AWB_MODE for this camera device.</p> |
| * <p>All camera devices will support ON mode.</p> |
| * <p>Camera devices that support the MANUAL_POST_PROCESSING capability will always support OFF |
| * mode, which enables application control of white balance, by using |
| * ACAMERA_COLOR_CORRECTION_TRANSFORM and ACAMERA_COLOR_CORRECTION_GAINS(ACAMERA_COLOR_CORRECTION_MODE must be set to TRANSFORM_MATRIX). This includes all FULL |
| * mode camera devices.</p> |
| * |
| * @see ACAMERA_COLOR_CORRECTION_GAINS |
| * @see ACAMERA_COLOR_CORRECTION_MODE |
| * @see ACAMERA_COLOR_CORRECTION_TRANSFORM |
| * @see ACAMERA_CONTROL_AWB_MODE |
| */ |
| ACAMERA_CONTROL_AWB_AVAILABLE_MODES = // byte[n] |
| ACAMERA_CONTROL_START + 27, |
| /** |
| * <p>List of the maximum number of regions that can be used for metering in |
| * auto-exposure (AE), auto-white balance (AWB), and auto-focus (AF); |
| * this corresponds to the the maximum number of elements in |
| * ACAMERA_CONTROL_AE_REGIONS, ACAMERA_CONTROL_AWB_REGIONS, |
| * and ACAMERA_CONTROL_AF_REGIONS.</p> |
| * |
| * @see ACAMERA_CONTROL_AE_REGIONS |
| * @see ACAMERA_CONTROL_AF_REGIONS |
| * @see ACAMERA_CONTROL_AWB_REGIONS |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>None</p> |
| */ |
| ACAMERA_CONTROL_MAX_REGIONS = // int32[3] |
| ACAMERA_CONTROL_START + 28, |
| /** |
| * <p>Current state of the auto-exposure (AE) algorithm.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * </ul> |
| * |
| * <p>Switching between or enabling AE modes (ACAMERA_CONTROL_AE_MODE) always |
| * resets the AE state to INACTIVE. Similarly, switching between ACAMERA_CONTROL_MODE, |
| * or ACAMERA_CONTROL_SCENE_MODE if <code>ACAMERA_CONTROL_MODE == USE_SCENE_MODE</code> resets all |
| * the algorithm states to INACTIVE.</p> |
| * <p>The camera device can do several state transitions between two results, if it is |
| * allowed by the state transition table. For example: INACTIVE may never actually be |
| * seen in a result.</p> |
| * <p>The state in the result is the state for this image (in sync with this image): if |
| * AE state becomes CONVERGED, then the image data associated with this result should |
| * be good to use.</p> |
| * <p>Below are state transition tables for different AE modes.</p> |
| * <p>State | Transition Cause | New State | Notes |
| * :------------:|:----------------:|:---------:|:-----------------------: |
| * INACTIVE | | INACTIVE | Camera device auto exposure algorithm is disabled</p> |
| * <p>When ACAMERA_CONTROL_AE_MODE is AE_MODE_ON_*:</p> |
| * <p>State | Transition Cause | New State | Notes |
| * :-------------:|:--------------------------------------------:|:--------------:|:-----------------: |
| * INACTIVE | Camera device initiates AE scan | SEARCHING | Values changing |
| * INACTIVE | ACAMERA_CONTROL_AE_LOCK is ON | LOCKED | Values locked |
| * SEARCHING | Camera device finishes AE scan | CONVERGED | Good values, not changing |
| * SEARCHING | Camera device finishes AE scan | FLASH_REQUIRED | Converged but too dark w/o flash |
| * SEARCHING | ACAMERA_CONTROL_AE_LOCK is ON | LOCKED | Values locked |
| * CONVERGED | Camera device initiates AE scan | SEARCHING | Values changing |
| * CONVERGED | ACAMERA_CONTROL_AE_LOCK is ON | LOCKED | Values locked |
| * FLASH_REQUIRED | Camera device initiates AE scan | SEARCHING | Values changing |
| * FLASH_REQUIRED | ACAMERA_CONTROL_AE_LOCK is ON | LOCKED | Values locked |
| * LOCKED | ACAMERA_CONTROL_AE_LOCK is OFF | SEARCHING | Values not good after unlock |
| * LOCKED | ACAMERA_CONTROL_AE_LOCK is OFF | CONVERGED | Values good after unlock |
| * LOCKED | ACAMERA_CONTROL_AE_LOCK is OFF | FLASH_REQUIRED | Exposure good, but too dark |
| * PRECAPTURE | Sequence done. ACAMERA_CONTROL_AE_LOCK is OFF | CONVERGED | Ready for high-quality capture |
| * PRECAPTURE | Sequence done. ACAMERA_CONTROL_AE_LOCK is ON | LOCKED | Ready for high-quality capture |
| * LOCKED | aeLock is ON and aePrecaptureTrigger is START | LOCKED | Precapture trigger is ignored when AE is already locked |
| * LOCKED | aeLock is ON and aePrecaptureTrigger is CANCEL| LOCKED | Precapture trigger is ignored when AE is already locked |
| * Any state (excluding LOCKED) | ACAMERA_CONTROL_AE_PRECAPTURE_TRIGGER is START | PRECAPTURE | Start AE precapture metering sequence |
| * Any state (excluding LOCKED) | ACAMERA_CONTROL_AE_PRECAPTURE_TRIGGER is CANCEL| INACTIVE | Currently active precapture metering sequence is canceled</p> |
| * <p>For the above table, the camera device may skip reporting any state changes that happen |
| * without application intervention (i.e. mode switch, trigger, locking). Any state that |
| * can be skipped in that manner is called a transient state.</p> |
| * <p>For example, for above AE modes (AE_MODE_ON_*), in addition to the state transitions |
| * listed in above table, it is also legal for the camera device to skip one or more |
| * transient states between two results. See below table for examples:</p> |
| * <p>State | Transition Cause | New State | Notes |
| * :-------------:|:-----------------------------------------------------------:|:--------------:|:-----------------: |
| * INACTIVE | Camera device finished AE scan | CONVERGED | Values are already good, transient states are skipped by camera device. |
| * Any state (excluding LOCKED) | ACAMERA_CONTROL_AE_PRECAPTURE_TRIGGER is START, sequence done | FLASH_REQUIRED | Converged but too dark w/o flash after a precapture sequence, transient states are skipped by camera device. |
| * Any state (excluding LOCKED) | ACAMERA_CONTROL_AE_PRECAPTURE_TRIGGER is START, sequence done | CONVERGED | Converged after a precapture sequence, transient states are skipped by camera device. |
| * Any state (excluding LOCKED) | ACAMERA_CONTROL_AE_PRECAPTURE_TRIGGER is CANCEL, converged | FLASH_REQUIRED | Converged but too dark w/o flash after a precapture sequence is canceled, transient states are skipped by camera device. |
| * Any state (excluding LOCKED) | ACAMERA_CONTROL_AE_PRECAPTURE_TRIGGER is CANCEL, converged | CONVERGED | Converged after a precapture sequenceis canceled, transient states are skipped by camera device. |
| * CONVERGED | Camera device finished AE scan | FLASH_REQUIRED | Converged but too dark w/o flash after a new scan, transient states are skipped by camera device. |
| * FLASH_REQUIRED | Camera device finished AE scan | CONVERGED | Converged after a new scan, transient states are skipped by camera device.</p> |
| * |
| * @see ACAMERA_CONTROL_AE_LOCK |
| * @see ACAMERA_CONTROL_AE_MODE |
| * @see ACAMERA_CONTROL_AE_PRECAPTURE_TRIGGER |
| * @see ACAMERA_CONTROL_MODE |
| * @see ACAMERA_CONTROL_SCENE_MODE |
| */ |
| ACAMERA_CONTROL_AE_STATE = // byte (enum) |
| ACAMERA_CONTROL_START + 31, |
| /** |
| * <p>Current state of auto-focus (AF) algorithm.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * </ul> |
| * |
| * <p>Switching between or enabling AF modes (ACAMERA_CONTROL_AF_MODE) always |
| * resets the AF state to INACTIVE. Similarly, switching between ACAMERA_CONTROL_MODE, |
| * or ACAMERA_CONTROL_SCENE_MODE if <code>ACAMERA_CONTROL_MODE == USE_SCENE_MODE</code> resets all |
| * the algorithm states to INACTIVE.</p> |
| * <p>The camera device can do several state transitions between two results, if it is |
| * allowed by the state transition table. For example: INACTIVE may never actually be |
| * seen in a result.</p> |
| * <p>The state in the result is the state for this image (in sync with this image): if |
| * AF state becomes FOCUSED, then the image data associated with this result should |
| * be sharp.</p> |
| * <p>Below are state transition tables for different AF modes.</p> |
| * <p>When ACAMERA_CONTROL_AF_MODE is AF_MODE_OFF or AF_MODE_EDOF:</p> |
| * <p>State | Transition Cause | New State | Notes |
| * :------------:|:----------------:|:---------:|:-----------: |
| * INACTIVE | | INACTIVE | Never changes</p> |
| * <p>When ACAMERA_CONTROL_AF_MODE is AF_MODE_AUTO or AF_MODE_MACRO:</p> |
| * <p>State | Transition Cause | New State | Notes |
| * :-----------------:|:----------------:|:------------------:|:--------------: |
| * INACTIVE | AF_TRIGGER | ACTIVE_SCAN | Start AF sweep, Lens now moving |
| * ACTIVE_SCAN | AF sweep done | FOCUSED_LOCKED | Focused, Lens now locked |
| * ACTIVE_SCAN | AF sweep done | NOT_FOCUSED_LOCKED | Not focused, Lens now locked |
| * ACTIVE_SCAN | AF_CANCEL | INACTIVE | Cancel/reset AF, Lens now locked |
| * FOCUSED_LOCKED | AF_CANCEL | INACTIVE | Cancel/reset AF |
| * FOCUSED_LOCKED | AF_TRIGGER | ACTIVE_SCAN | Start new sweep, Lens now moving |
| * NOT_FOCUSED_LOCKED | AF_CANCEL | INACTIVE | Cancel/reset AF |
| * NOT_FOCUSED_LOCKED | AF_TRIGGER | ACTIVE_SCAN | Start new sweep, Lens now moving |
| * Any state | Mode change | INACTIVE |</p> |
| * <p>For the above table, the camera device may skip reporting any state changes that happen |
| * without application intervention (i.e. mode switch, trigger, locking). Any state that |
| * can be skipped in that manner is called a transient state.</p> |
| * <p>For example, for these AF modes (AF_MODE_AUTO and AF_MODE_MACRO), in addition to the |
| * state transitions listed in above table, it is also legal for the camera device to skip |
| * one or more transient states between two results. See below table for examples:</p> |
| * <p>State | Transition Cause | New State | Notes |
| * :-----------------:|:----------------:|:------------------:|:--------------: |
| * INACTIVE | AF_TRIGGER | FOCUSED_LOCKED | Focus is already good or good after a scan, lens is now locked. |
| * INACTIVE | AF_TRIGGER | NOT_FOCUSED_LOCKED | Focus failed after a scan, lens is now locked. |
| * FOCUSED_LOCKED | AF_TRIGGER | FOCUSED_LOCKED | Focus is already good or good after a scan, lens is now locked. |
| * NOT_FOCUSED_LOCKED | AF_TRIGGER | FOCUSED_LOCKED | Focus is good after a scan, lens is not locked.</p> |
| * <p>When ACAMERA_CONTROL_AF_MODE is AF_MODE_CONTINUOUS_VIDEO:</p> |
| * <p>State | Transition Cause | New State | Notes |
| * :-----------------:|:-----------------------------------:|:------------------:|:--------------: |
| * INACTIVE | Camera device initiates new scan | PASSIVE_SCAN | Start AF scan, Lens now moving |
| * INACTIVE | AF_TRIGGER | NOT_FOCUSED_LOCKED | AF state query, Lens now locked |
| * PASSIVE_SCAN | Camera device completes current scan| PASSIVE_FOCUSED | End AF scan, Lens now locked |
| * PASSIVE_SCAN | Camera device fails current scan | PASSIVE_UNFOCUSED | End AF scan, Lens now locked |
| * PASSIVE_SCAN | AF_TRIGGER | FOCUSED_LOCKED | Immediate transition, if focus is good. Lens now locked |
| * PASSIVE_SCAN | AF_TRIGGER | NOT_FOCUSED_LOCKED | Immediate transition, if focus is bad. Lens now locked |
| * PASSIVE_SCAN | AF_CANCEL | INACTIVE | Reset lens position, Lens now locked |
| * PASSIVE_FOCUSED | Camera device initiates new scan | PASSIVE_SCAN | Start AF scan, Lens now moving |
| * PASSIVE_UNFOCUSED | Camera device initiates new scan | PASSIVE_SCAN | Start AF scan, Lens now moving |
| * PASSIVE_FOCUSED | AF_TRIGGER | FOCUSED_LOCKED | Immediate transition, lens now locked |
| * PASSIVE_UNFOCUSED | AF_TRIGGER | NOT_FOCUSED_LOCKED | Immediate transition, lens now locked |
| * FOCUSED_LOCKED | AF_TRIGGER | FOCUSED_LOCKED | No effect |
| * FOCUSED_LOCKED | AF_CANCEL | INACTIVE | Restart AF scan |
| * NOT_FOCUSED_LOCKED | AF_TRIGGER | NOT_FOCUSED_LOCKED | No effect |
| * NOT_FOCUSED_LOCKED | AF_CANCEL | INACTIVE | Restart AF scan</p> |
| * <p>When ACAMERA_CONTROL_AF_MODE is AF_MODE_CONTINUOUS_PICTURE:</p> |
| * <p>State | Transition Cause | New State | Notes |
| * :-----------------:|:------------------------------------:|:------------------:|:--------------: |
| * INACTIVE | Camera device initiates new scan | PASSIVE_SCAN | Start AF scan, Lens now moving |
| * INACTIVE | AF_TRIGGER | NOT_FOCUSED_LOCKED | AF state query, Lens now locked |
| * PASSIVE_SCAN | Camera device completes current scan | PASSIVE_FOCUSED | End AF scan, Lens now locked |
| * PASSIVE_SCAN | Camera device fails current scan | PASSIVE_UNFOCUSED | End AF scan, Lens now locked |
| * PASSIVE_SCAN | AF_TRIGGER | FOCUSED_LOCKED | Eventual transition once the focus is good. Lens now locked |
| * PASSIVE_SCAN | AF_TRIGGER | NOT_FOCUSED_LOCKED | Eventual transition if cannot find focus. Lens now locked |
| * PASSIVE_SCAN | AF_CANCEL | INACTIVE | Reset lens position, Lens now locked |
| * PASSIVE_FOCUSED | Camera device initiates new scan | PASSIVE_SCAN | Start AF scan, Lens now moving |
| * PASSIVE_UNFOCUSED | Camera device initiates new scan | PASSIVE_SCAN | Start AF scan, Lens now moving |
| * PASSIVE_FOCUSED | AF_TRIGGER | FOCUSED_LOCKED | Immediate trans. Lens now locked |
| * PASSIVE_UNFOCUSED | AF_TRIGGER | NOT_FOCUSED_LOCKED | Immediate trans. Lens now locked |
| * FOCUSED_LOCKED | AF_TRIGGER | FOCUSED_LOCKED | No effect |
| * FOCUSED_LOCKED | AF_CANCEL | INACTIVE | Restart AF scan |
| * NOT_FOCUSED_LOCKED | AF_TRIGGER | NOT_FOCUSED_LOCKED | No effect |
| * NOT_FOCUSED_LOCKED | AF_CANCEL | INACTIVE | Restart AF scan</p> |
| * <p>When switch between AF_MODE_CONTINUOUS_* (CAF modes) and AF_MODE_AUTO/AF_MODE_MACRO |
| * (AUTO modes), the initial INACTIVE or PASSIVE_SCAN states may be skipped by the |
| * camera device. When a trigger is included in a mode switch request, the trigger |
| * will be evaluated in the context of the new mode in the request. |
| * See below table for examples:</p> |
| * <p>State | Transition Cause | New State | Notes |
| * :-----------:|:--------------------------------------:|:----------------------------------------:|:--------------: |
| * any state | CAF-->AUTO mode switch | INACTIVE | Mode switch without trigger, initial state must be INACTIVE |
| * any state | CAF-->AUTO mode switch with AF_TRIGGER | trigger-reachable states from INACTIVE | Mode switch with trigger, INACTIVE is skipped |
| * any state | AUTO-->CAF mode switch | passively reachable states from INACTIVE | Mode switch without trigger, passive transient state is skipped</p> |
| * |
| * @see ACAMERA_CONTROL_AF_MODE |
| * @see ACAMERA_CONTROL_MODE |
| * @see ACAMERA_CONTROL_SCENE_MODE |
| */ |
| ACAMERA_CONTROL_AF_STATE = // byte (enum) |
| ACAMERA_CONTROL_START + 32, |
| /** |
| * <p>Current state of auto-white balance (AWB) algorithm.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * </ul> |
| * |
| * <p>Switching between or enabling AWB modes (ACAMERA_CONTROL_AWB_MODE) always |
| * resets the AWB state to INACTIVE. Similarly, switching between ACAMERA_CONTROL_MODE, |
| * or ACAMERA_CONTROL_SCENE_MODE if <code>ACAMERA_CONTROL_MODE == USE_SCENE_MODE</code> resets all |
| * the algorithm states to INACTIVE.</p> |
| * <p>The camera device can do several state transitions between two results, if it is |
| * allowed by the state transition table. So INACTIVE may never actually be seen in |
| * a result.</p> |
| * <p>The state in the result is the state for this image (in sync with this image): if |
| * AWB state becomes CONVERGED, then the image data associated with this result should |
| * be good to use.</p> |
| * <p>Below are state transition tables for different AWB modes.</p> |
| * <p>When <code>ACAMERA_CONTROL_AWB_MODE != AWB_MODE_AUTO</code>:</p> |
| * <p>State | Transition Cause | New State | Notes |
| * :------------:|:----------------:|:---------:|:-----------------------: |
| * INACTIVE | |INACTIVE |Camera device auto white balance algorithm is disabled</p> |
| * <p>When ACAMERA_CONTROL_AWB_MODE is AWB_MODE_AUTO:</p> |
| * <p>State | Transition Cause | New State | Notes |
| * :-------------:|:--------------------------------:|:-------------:|:-----------------: |
| * INACTIVE | Camera device initiates AWB scan | SEARCHING | Values changing |
| * INACTIVE | ACAMERA_CONTROL_AWB_LOCK is ON | LOCKED | Values locked |
| * SEARCHING | Camera device finishes AWB scan | CONVERGED | Good values, not changing |
| * SEARCHING | ACAMERA_CONTROL_AWB_LOCK is ON | LOCKED | Values locked |
| * CONVERGED | Camera device initiates AWB scan | SEARCHING | Values changing |
| * CONVERGED | ACAMERA_CONTROL_AWB_LOCK is ON | LOCKED | Values locked |
| * LOCKED | ACAMERA_CONTROL_AWB_LOCK is OFF | SEARCHING | Values not good after unlock</p> |
| * <p>For the above table, the camera device may skip reporting any state changes that happen |
| * without application intervention (i.e. mode switch, trigger, locking). Any state that |
| * can be skipped in that manner is called a transient state.</p> |
| * <p>For example, for this AWB mode (AWB_MODE_AUTO), in addition to the state transitions |
| * listed in above table, it is also legal for the camera device to skip one or more |
| * transient states between two results. See below table for examples:</p> |
| * <p>State | Transition Cause | New State | Notes |
| * :-------------:|:--------------------------------:|:-------------:|:-----------------: |
| * INACTIVE | Camera device finished AWB scan | CONVERGED | Values are already good, transient states are skipped by camera device. |
| * LOCKED | ACAMERA_CONTROL_AWB_LOCK is OFF | CONVERGED | Values good after unlock, transient states are skipped by camera device.</p> |
| * |
| * @see ACAMERA_CONTROL_AWB_LOCK |
| * @see ACAMERA_CONTROL_AWB_MODE |
| * @see ACAMERA_CONTROL_MODE |
| * @see ACAMERA_CONTROL_SCENE_MODE |
| */ |
| ACAMERA_CONTROL_AWB_STATE = // byte (enum) |
| ACAMERA_CONTROL_START + 34, |
| /** |
| * <p>Whether the camera device supports ACAMERA_CONTROL_AE_LOCK</p> |
| * |
| * @see ACAMERA_CONTROL_AE_LOCK |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>Devices with MANUAL_SENSOR capability or BURST_CAPTURE capability will always |
| * list <code>true</code>. This includes FULL devices.</p> |
| */ |
| ACAMERA_CONTROL_AE_LOCK_AVAILABLE = // byte (enum) |
| ACAMERA_CONTROL_START + 36, |
| /** |
| * <p>Whether the camera device supports ACAMERA_CONTROL_AWB_LOCK</p> |
| * |
| * @see ACAMERA_CONTROL_AWB_LOCK |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>Devices with MANUAL_POST_PROCESSING capability or BURST_CAPTURE capability will |
| * always list <code>true</code>. This includes FULL devices.</p> |
| */ |
| ACAMERA_CONTROL_AWB_LOCK_AVAILABLE = // byte (enum) |
| ACAMERA_CONTROL_START + 37, |
| /** |
| * <p>List of control modes for ACAMERA_CONTROL_MODE that are supported by this camera |
| * device.</p> |
| * |
| * @see ACAMERA_CONTROL_MODE |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>This list contains control modes that can be set for the camera device. |
| * LEGACY mode devices will always support AUTO mode. LIMITED and FULL |
| * devices will always support OFF, AUTO modes.</p> |
| */ |
| ACAMERA_CONTROL_AVAILABLE_MODES = // byte[n] |
| ACAMERA_CONTROL_START + 38, |
| /** |
| * <p>Range of boosts for ACAMERA_CONTROL_POST_RAW_SENSITIVITY_BOOST supported |
| * by this camera device.</p> |
| * |
| * @see ACAMERA_CONTROL_POST_RAW_SENSITIVITY_BOOST |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>Devices support post RAW sensitivity boost will advertise |
| * ACAMERA_CONTROL_POST_RAW_SENSITIVITY_BOOST key for controling |
| * post RAW sensitivity boost.</p> |
| * <p>This key will be <code>null</code> for devices that do not support any RAW format |
| * outputs. For devices that do support RAW format outputs, this key will always |
| * present, and if a device does not support post RAW sensitivity boost, it will |
| * list <code>(100, 100)</code> in this key.</p> |
| * |
| * @see ACAMERA_CONTROL_POST_RAW_SENSITIVITY_BOOST |
| */ |
| ACAMERA_CONTROL_POST_RAW_SENSITIVITY_BOOST_RANGE = // int32[2] |
| ACAMERA_CONTROL_START + 39, |
| /** |
| * <p>The amount of additional sensitivity boost applied to output images |
| * after RAW sensor data is captured.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>Some camera devices support additional digital sensitivity boosting in the |
| * camera processing pipeline after sensor RAW image is captured. |
| * Such a boost will be applied to YUV/JPEG format output images but will not |
| * have effect on RAW output formats like RAW_SENSOR, RAW10, RAW12 or RAW_OPAQUE.</p> |
| * <p>This key will be <code>null</code> for devices that do not support any RAW format |
| * outputs. For devices that do support RAW format outputs, this key will always |
| * present, and if a device does not support post RAW sensitivity boost, it will |
| * list <code>100</code> in this key.</p> |
| * <p>If the camera device cannot apply the exact boost requested, it will reduce the |
| * boost to the nearest supported value. |
| * The final boost value used will be available in the output capture result.</p> |
| * <p>For devices that support post RAW sensitivity boost, the YUV/JPEG output images |
| * of such device will have the total sensitivity of |
| * <code>ACAMERA_SENSOR_SENSITIVITY * ACAMERA_CONTROL_POST_RAW_SENSITIVITY_BOOST / 100</code> |
| * The sensitivity of RAW format images will always be <code>ACAMERA_SENSOR_SENSITIVITY</code></p> |
| * <p>This control is only effective if ACAMERA_CONTROL_AE_MODE or ACAMERA_CONTROL_MODE is set to |
| * OFF; otherwise the auto-exposure algorithm will override this value.</p> |
| * |
| * @see ACAMERA_CONTROL_AE_MODE |
| * @see ACAMERA_CONTROL_MODE |
| * @see ACAMERA_CONTROL_POST_RAW_SENSITIVITY_BOOST |
| * @see ACAMERA_SENSOR_SENSITIVITY |
| */ |
| ACAMERA_CONTROL_POST_RAW_SENSITIVITY_BOOST = // int32 |
| ACAMERA_CONTROL_START + 40, |
| ACAMERA_CONTROL_END, |
| |
| /** |
| * <p>Operation mode for edge |
| * enhancement.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>Edge enhancement improves sharpness and details in the captured image. OFF means |
| * no enhancement will be applied by the camera device.</p> |
| * <p>FAST/HIGH_QUALITY both mean camera device determined enhancement |
| * will be applied. HIGH_QUALITY mode indicates that the |
| * camera device will use the highest-quality enhancement algorithms, |
| * even if it slows down capture rate. FAST means the camera device will |
| * not slow down capture rate when applying edge enhancement. FAST may be the same as OFF if |
| * edge enhancement will slow down capture rate. Every output stream will have a similar |
| * amount of enhancement applied.</p> |
| * <p>ZERO_SHUTTER_LAG is meant to be used by applications that maintain a continuous circular |
| * buffer of high-resolution images during preview and reprocess image(s) from that buffer |
| * into a final capture when triggered by the user. In this mode, the camera device applies |
| * edge enhancement to low-resolution streams (below maximum recording resolution) to |
| * maximize preview quality, but does not apply edge enhancement to high-resolution streams, |
| * since those will be reprocessed later if necessary.</p> |
| * <p>For YUV_REPROCESSING, these FAST/HIGH_QUALITY modes both mean that the camera |
| * device will apply FAST/HIGH_QUALITY YUV-domain edge enhancement, respectively. |
| * The camera device may adjust its internal edge enhancement parameters for best |
| * image quality based on the android.reprocess.effectiveExposureFactor, if it is set.</p> |
| */ |
| ACAMERA_EDGE_MODE = // byte (enum) |
| ACAMERA_EDGE_START, |
| /** |
| * <p>List of edge enhancement modes for ACAMERA_EDGE_MODE that are supported by this camera |
| * device.</p> |
| * |
| * @see ACAMERA_EDGE_MODE |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>Full-capability camera devices must always support OFF; camera devices that support |
| * YUV_REPROCESSING or PRIVATE_REPROCESSING will list ZERO_SHUTTER_LAG; all devices will |
| * list FAST.</p> |
| */ |
| ACAMERA_EDGE_AVAILABLE_EDGE_MODES = // byte[n] |
| ACAMERA_EDGE_START + 2, |
| ACAMERA_EDGE_END, |
| |
| /** |
| * <p>The desired mode for for the camera device's flash control.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>This control is only effective when flash unit is available |
| * (<code>ACAMERA_FLASH_INFO_AVAILABLE == true</code>).</p> |
| * <p>When this control is used, the ACAMERA_CONTROL_AE_MODE must be set to ON or OFF. |
| * Otherwise, the camera device auto-exposure related flash control (ON_AUTO_FLASH, |
| * ON_ALWAYS_FLASH, or ON_AUTO_FLASH_REDEYE) will override this control.</p> |
| * <p>When set to OFF, the camera device will not fire flash for this capture.</p> |
| * <p>When set to SINGLE, the camera device will fire flash regardless of the camera |
| * device's auto-exposure routine's result. When used in still capture case, this |
| * control should be used along with auto-exposure (AE) precapture metering sequence |
| * (ACAMERA_CONTROL_AE_PRECAPTURE_TRIGGER), otherwise, the image may be incorrectly exposed.</p> |
| * <p>When set to TORCH, the flash will be on continuously. This mode can be used |
| * for use cases such as preview, auto-focus assist, still capture, or video recording.</p> |
| * <p>The flash status will be reported by ACAMERA_FLASH_STATE in the capture result metadata.</p> |
| * |
| * @see ACAMERA_CONTROL_AE_MODE |
| * @see ACAMERA_CONTROL_AE_PRECAPTURE_TRIGGER |
| * @see ACAMERA_FLASH_INFO_AVAILABLE |
| * @see ACAMERA_FLASH_STATE |
| */ |
| ACAMERA_FLASH_MODE = // byte (enum) |
| ACAMERA_FLASH_START + 2, |
| /** |
| * <p>Current state of the flash |
| * unit.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * </ul> |
| * |
| * <p>When the camera device doesn't have flash unit |
| * (i.e. <code>ACAMERA_FLASH_INFO_AVAILABLE == false</code>), this state will always be UNAVAILABLE. |
| * Other states indicate the current flash status.</p> |
| * <p>In certain conditions, this will be available on LEGACY devices:</p> |
| * <ul> |
| * <li>Flash-less cameras always return UNAVAILABLE.</li> |
| * <li>Using ACAMERA_CONTROL_AE_MODE <code>==</code> ON_ALWAYS_FLASH |
| * will always return FIRED.</li> |
| * <li>Using ACAMERA_FLASH_MODE <code>==</code> TORCH |
| * will always return FIRED.</li> |
| * </ul> |
| * <p>In all other conditions the state will not be available on |
| * LEGACY devices (i.e. it will be <code>null</code>).</p> |
| * |
| * @see ACAMERA_CONTROL_AE_MODE |
| * @see ACAMERA_FLASH_INFO_AVAILABLE |
| * @see ACAMERA_FLASH_MODE |
| */ |
| ACAMERA_FLASH_STATE = // byte (enum) |
| ACAMERA_FLASH_START + 5, |
| ACAMERA_FLASH_END, |
| |
| /** |
| * <p>Whether this camera device has a |
| * flash unit.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>Will be <code>false</code> if no flash is available.</p> |
| * <p>If there is no flash unit, none of the flash controls do |
| * anything.</p> |
| */ |
| ACAMERA_FLASH_INFO_AVAILABLE = // byte (enum) |
| ACAMERA_FLASH_INFO_START, |
| ACAMERA_FLASH_INFO_END, |
| |
| /** |
| * <p>Operational mode for hot pixel correction.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>Hotpixel correction interpolates out, or otherwise removes, pixels |
| * that do not accurately measure the incoming light (i.e. pixels that |
| * are stuck at an arbitrary value or are oversensitive).</p> |
| */ |
| ACAMERA_HOT_PIXEL_MODE = // byte (enum) |
| ACAMERA_HOT_PIXEL_START, |
| /** |
| * <p>List of hot pixel correction modes for ACAMERA_HOT_PIXEL_MODE that are supported by this |
| * camera device.</p> |
| * |
| * @see ACAMERA_HOT_PIXEL_MODE |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>FULL mode camera devices will always support FAST.</p> |
| */ |
| ACAMERA_HOT_PIXEL_AVAILABLE_HOT_PIXEL_MODES = // byte[n] |
| ACAMERA_HOT_PIXEL_START + 1, |
| ACAMERA_HOT_PIXEL_END, |
| |
| /** |
| * <p>GPS coordinates to include in output JPEG |
| * EXIF.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>None</p> |
| */ |
| ACAMERA_JPEG_GPS_COORDINATES = // double[3] |
| ACAMERA_JPEG_START, |
| /** |
| * <p>32 characters describing GPS algorithm to |
| * include in EXIF.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>None</p> |
| */ |
| ACAMERA_JPEG_GPS_PROCESSING_METHOD = // byte |
| ACAMERA_JPEG_START + 1, |
| /** |
| * <p>Time GPS fix was made to include in |
| * EXIF.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>None</p> |
| */ |
| ACAMERA_JPEG_GPS_TIMESTAMP = // int64 |
| ACAMERA_JPEG_START + 2, |
| /** |
| * <p>The orientation for a JPEG image.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>The clockwise rotation angle in degrees, relative to the orientation |
| * to the camera, that the JPEG picture needs to be rotated by, to be viewed |
| * upright.</p> |
| * <p>Camera devices may either encode this value into the JPEG EXIF header, or |
| * rotate the image data to match this orientation. When the image data is rotated, |
| * the thumbnail data will also be rotated.</p> |
| * <p>Note that this orientation is relative to the orientation of the camera sensor, given |
| * by ACAMERA_SENSOR_ORIENTATION.</p> |
| * <p>To translate from the device orientation given by the Android sensor APIs, the following |
| * sample code may be used:</p> |
| * <pre><code>private int getJpegOrientation(CameraCharacteristics c, int deviceOrientation) { |
| * if (deviceOrientation == android.view.OrientationEventListener.ORIENTATION_UNKNOWN) return 0; |
| * int sensorOrientation = c.get(CameraCharacteristics.SENSOR_ORIENTATION); |
| * |
| * // Round device orientation to a multiple of 90 |
| * deviceOrientation = (deviceOrientation + 45) / 90 * 90; |
| * |
| * // Reverse device orientation for front-facing cameras |
| * boolean facingFront = c.get(CameraCharacteristics.LENS_FACING) == CameraCharacteristics.LENS_FACING_FRONT; |
| * if (facingFront) deviceOrientation = -deviceOrientation; |
| * |
| * // Calculate desired JPEG orientation relative to camera orientation to make |
| * // the image upright relative to the device orientation |
| * int jpegOrientation = (sensorOrientation + deviceOrientation + 360) % 360; |
| * |
| * return jpegOrientation; |
| * } |
| * </code></pre> |
| * |
| * @see ACAMERA_SENSOR_ORIENTATION |
| */ |
| ACAMERA_JPEG_ORIENTATION = // int32 |
| ACAMERA_JPEG_START + 3, |
| /** |
| * <p>Compression quality of the final JPEG |
| * image.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>85-95 is typical usage range.</p> |
| */ |
| ACAMERA_JPEG_QUALITY = // byte |
| ACAMERA_JPEG_START + 4, |
| /** |
| * <p>Compression quality of JPEG |
| * thumbnail.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>None</p> |
| */ |
| ACAMERA_JPEG_THUMBNAIL_QUALITY = // byte |
| ACAMERA_JPEG_START + 5, |
| /** |
| * <p>Resolution of embedded JPEG thumbnail.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>When set to (0, 0) value, the JPEG EXIF will not contain thumbnail, |
| * but the captured JPEG will still be a valid image.</p> |
| * <p>For best results, when issuing a request for a JPEG image, the thumbnail size selected |
| * should have the same aspect ratio as the main JPEG output.</p> |
| * <p>If the thumbnail image aspect ratio differs from the JPEG primary image aspect |
| * ratio, the camera device creates the thumbnail by cropping it from the primary image. |
| * For example, if the primary image has 4:3 aspect ratio, the thumbnail image has |
| * 16:9 aspect ratio, the primary image will be cropped vertically (letterbox) to |
| * generate the thumbnail image. The thumbnail image will always have a smaller Field |
| * Of View (FOV) than the primary image when aspect ratios differ.</p> |
| * <p>When an ACAMERA_JPEG_ORIENTATION of non-zero degree is requested, |
| * the camera device will handle thumbnail rotation in one of the following ways:</p> |
| * <ul> |
| * <li>Set the |
| * <a href="https://developer.android.com/reference/android/media/ExifInterface.html#TAG_ORIENTATION">EXIF orientation flag</a> |
| * and keep jpeg and thumbnail image data unrotated.</li> |
| * <li>Rotate the jpeg and thumbnail image data and not set |
| * <a href="https://developer.android.com/reference/android/media/ExifInterface.html#TAG_ORIENTATION">EXIF orientation flag</a>. |
| * In this case, LIMITED or FULL hardware level devices will report rotated thumnail size |
| * in capture result, so the width and height will be interchanged if 90 or 270 degree |
| * orientation is requested. LEGACY device will always report unrotated thumbnail size.</li> |
| * </ul> |
| * |
| * @see ACAMERA_JPEG_ORIENTATION |
| */ |
| ACAMERA_JPEG_THUMBNAIL_SIZE = // int32[2] |
| ACAMERA_JPEG_START + 6, |
| /** |
| * <p>List of JPEG thumbnail sizes for ACAMERA_JPEG_THUMBNAIL_SIZE supported by this |
| * camera device.</p> |
| * |
| * @see ACAMERA_JPEG_THUMBNAIL_SIZE |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>This list will include at least one non-zero resolution, plus <code>(0,0)</code> for indicating no |
| * thumbnail should be generated.</p> |
| * <p>Below condiditions will be satisfied for this size list:</p> |
| * <ul> |
| * <li>The sizes will be sorted by increasing pixel area (width x height). |
| * If several resolutions have the same area, they will be sorted by increasing width.</li> |
| * <li>The aspect ratio of the largest thumbnail size will be same as the |
| * aspect ratio of largest JPEG output size in ACAMERA_SCALER_AVAILABLE_STREAM_CONFIGURATIONS. |
| * The largest size is defined as the size that has the largest pixel area |
| * in a given size list.</li> |
| * <li>Each output JPEG size in ACAMERA_SCALER_AVAILABLE_STREAM_CONFIGURATIONS will have at least |
| * one corresponding size that has the same aspect ratio in availableThumbnailSizes, |
| * and vice versa.</li> |
| * <li>All non-<code>(0, 0)</code> sizes will have non-zero widths and heights.</li> |
| * </ul> |
| * |
| * @see ACAMERA_SCALER_AVAILABLE_STREAM_CONFIGURATIONS |
| */ |
| ACAMERA_JPEG_AVAILABLE_THUMBNAIL_SIZES = // int32[2*n] |
| ACAMERA_JPEG_START + 7, |
| ACAMERA_JPEG_END, |
| |
| /** |
| * <p>The desired lens aperture size, as a ratio of lens focal length to the |
| * effective aperture diameter.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>Setting this value is only supported on the camera devices that have a variable |
| * aperture lens.</p> |
| * <p>When this is supported and ACAMERA_CONTROL_AE_MODE is OFF, |
| * this can be set along with ACAMERA_SENSOR_EXPOSURE_TIME, |
| * ACAMERA_SENSOR_SENSITIVITY, and ACAMERA_SENSOR_FRAME_DURATION |
| * to achieve manual exposure control.</p> |
| * <p>The requested aperture value may take several frames to reach the |
| * requested value; the camera device will report the current (intermediate) |
| * aperture size in capture result metadata while the aperture is changing. |
| * While the aperture is still changing, ACAMERA_LENS_STATE will be set to MOVING.</p> |
| * <p>When this is supported and ACAMERA_CONTROL_AE_MODE is one of |
| * the ON modes, this will be overridden by the camera device |
| * auto-exposure algorithm, the overridden values are then provided |
| * back to the user in the corresponding result.</p> |
| * |
| * @see ACAMERA_CONTROL_AE_MODE |
| * @see ACAMERA_LENS_STATE |
| * @see ACAMERA_SENSOR_EXPOSURE_TIME |
| * @see ACAMERA_SENSOR_FRAME_DURATION |
| * @see ACAMERA_SENSOR_SENSITIVITY |
| */ |
| ACAMERA_LENS_APERTURE = // float |
| ACAMERA_LENS_START, |
| /** |
| * <p>The desired setting for the lens neutral density filter(s).</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>This control will not be supported on most camera devices.</p> |
| * <p>Lens filters are typically used to lower the amount of light the |
| * sensor is exposed to (measured in steps of EV). As used here, an EV |
| * step is the standard logarithmic representation, which are |
| * non-negative, and inversely proportional to the amount of light |
| * hitting the sensor. For example, setting this to 0 would result |
| * in no reduction of the incoming light, and setting this to 2 would |
| * mean that the filter is set to reduce incoming light by two stops |
| * (allowing 1/4 of the prior amount of light to the sensor).</p> |
| * <p>It may take several frames before the lens filter density changes |
| * to the requested value. While the filter density is still changing, |
| * ACAMERA_LENS_STATE will be set to MOVING.</p> |
| * |
| * @see ACAMERA_LENS_STATE |
| */ |
| ACAMERA_LENS_FILTER_DENSITY = // float |
| ACAMERA_LENS_START + 1, |
| /** |
| * <p>The desired lens focal length; used for optical zoom.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>This setting controls the physical focal length of the camera |
| * device's lens. Changing the focal length changes the field of |
| * view of the camera device, and is usually used for optical zoom.</p> |
| * <p>Like ACAMERA_LENS_FOCUS_DISTANCE and ACAMERA_LENS_APERTURE, this |
| * setting won't be applied instantaneously, and it may take several |
| * frames before the lens can change to the requested focal length. |
| * While the focal length is still changing, ACAMERA_LENS_STATE will |
| * be set to MOVING.</p> |
| * <p>Optical zoom will not be supported on most devices.</p> |
| * |
| * @see ACAMERA_LENS_APERTURE |
| * @see ACAMERA_LENS_FOCUS_DISTANCE |
| * @see ACAMERA_LENS_STATE |
| */ |
| ACAMERA_LENS_FOCAL_LENGTH = // float |
| ACAMERA_LENS_START + 2, |
| /** |
| * <p>Desired distance to plane of sharpest focus, |
| * measured from frontmost surface of the lens.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>Should be zero for fixed-focus cameras</p> |
| */ |
| ACAMERA_LENS_FOCUS_DISTANCE = // float |
| ACAMERA_LENS_START + 3, |
| /** |
| * <p>Sets whether the camera device uses optical image stabilization (OIS) |
| * when capturing images.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>OIS is used to compensate for motion blur due to small |
| * movements of the camera during capture. Unlike digital image |
| * stabilization (ACAMERA_CONTROL_VIDEO_STABILIZATION_MODE), OIS |
| * makes use of mechanical elements to stabilize the camera |
| * sensor, and thus allows for longer exposure times before |
| * camera shake becomes apparent.</p> |
| * <p>Switching between different optical stabilization modes may take several |
| * frames to initialize, the camera device will report the current mode in |
| * capture result metadata. For example, When "ON" mode is requested, the |
| * optical stabilization modes in the first several capture results may still |
| * be "OFF", and it will become "ON" when the initialization is done.</p> |
| * <p>If a camera device supports both OIS and digital image stabilization |
| * (ACAMERA_CONTROL_VIDEO_STABILIZATION_MODE), turning both modes on may produce undesirable |
| * interaction, so it is recommended not to enable both at the same time.</p> |
| * <p>Not all devices will support OIS; see |
| * ACAMERA_LENS_INFO_AVAILABLE_OPTICAL_STABILIZATION for |
| * available controls.</p> |
| * |
| * @see ACAMERA_CONTROL_VIDEO_STABILIZATION_MODE |
| * @see ACAMERA_LENS_INFO_AVAILABLE_OPTICAL_STABILIZATION |
| */ |
| ACAMERA_LENS_OPTICAL_STABILIZATION_MODE = // byte (enum) |
| ACAMERA_LENS_START + 4, |
| /** |
| * <p>Direction the camera faces relative to |
| * device screen.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>None</p> |
| */ |
| ACAMERA_LENS_FACING = // byte (enum) |
| ACAMERA_LENS_START + 5, |
| /** |
| * <p>The orientation of the camera relative to the sensor |
| * coordinate system.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * </ul> |
| * |
| * <p>The four coefficients that describe the quaternion |
| * rotation from the Android sensor coordinate system to a |
| * camera-aligned coordinate system where the X-axis is |
| * aligned with the long side of the image sensor, the Y-axis |
| * is aligned with the short side of the image sensor, and |
| * the Z-axis is aligned with the optical axis of the sensor.</p> |
| * <p>To convert from the quaternion coefficients <code>(x,y,z,w)</code> |
| * to the axis of rotation <code>(a_x, a_y, a_z)</code> and rotation |
| * amount <code>theta</code>, the following formulas can be used:</p> |
| * <pre><code> theta = 2 * acos(w) |
| * a_x = x / sin(theta/2) |
| * a_y = y / sin(theta/2) |
| * a_z = z / sin(theta/2) |
| * </code></pre> |
| * <p>To create a 3x3 rotation matrix that applies the rotation |
| * defined by this quaternion, the following matrix can be |
| * used:</p> |
| * <pre><code>R = [ 1 - 2y^2 - 2z^2, 2xy - 2zw, 2xz + 2yw, |
| * 2xy + 2zw, 1 - 2x^2 - 2z^2, 2yz - 2xw, |
| * 2xz - 2yw, 2yz + 2xw, 1 - 2x^2 - 2y^2 ] |
| * </code></pre> |
| * <p>This matrix can then be used to apply the rotation to a |
| * column vector point with</p> |
| * <p><code>p' = Rp</code></p> |
| * <p>where <code>p</code> is in the device sensor coordinate system, and |
| * <code>p'</code> is in the camera-oriented coordinate system.</p> |
| */ |
| ACAMERA_LENS_POSE_ROTATION = // float[4] |
| ACAMERA_LENS_START + 6, |
| /** |
| * <p>Position of the camera optical center.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * </ul> |
| * |
| * <p>The position of the camera device's lens optical center, |
| * as a three-dimensional vector <code>(x,y,z)</code>, relative to the |
| * optical center of the largest camera device facing in the |
| * same direction as this camera, in the |
| * <a href="https://developer.android.com/reference/android/hardware/SensorEvent.html">Android sensor coordinate axes</a>. |
| * Note that only the axis definitions are shared with |
| * the sensor coordinate system, but not the origin.</p> |
| * <p>If this device is the largest or only camera device with a |
| * given facing, then this position will be <code>(0, 0, 0)</code>; a |
| * camera device with a lens optical center located 3 cm from |
| * the main sensor along the +X axis (to the right from the |
| * user's perspective) will report <code>(0.03, 0, 0)</code>.</p> |
| * <p>To transform a pixel coordinates between two cameras |
| * facing the same direction, first the source camera |
| * ACAMERA_LENS_RADIAL_DISTORTION must be corrected for. Then |
| * the source camera ACAMERA_LENS_INTRINSIC_CALIBRATION needs |
| * to be applied, followed by the ACAMERA_LENS_POSE_ROTATION |
| * of the source camera, the translation of the source camera |
| * relative to the destination camera, the |
| * ACAMERA_LENS_POSE_ROTATION of the destination camera, and |
| * finally the inverse of ACAMERA_LENS_INTRINSIC_CALIBRATION |
| * of the destination camera. This obtains a |
| * radial-distortion-free coordinate in the destination |
| * camera pixel coordinates.</p> |
| * <p>To compare this against a real image from the destination |
| * camera, the destination camera image then needs to be |
| * corrected for radial distortion before comparison or |
| * sampling.</p> |
| * |
| * @see ACAMERA_LENS_INTRINSIC_CALIBRATION |
| * @see ACAMERA_LENS_POSE_ROTATION |
| * @see ACAMERA_LENS_RADIAL_DISTORTION |
| */ |
| ACAMERA_LENS_POSE_TRANSLATION = // float[3] |
| ACAMERA_LENS_START + 7, |
| /** |
| * <p>The range of scene distances that are in |
| * sharp focus (depth of field).</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * </ul> |
| * |
| * <p>If variable focus not supported, can still report |
| * fixed depth of field range</p> |
| */ |
| ACAMERA_LENS_FOCUS_RANGE = // float[2] |
| ACAMERA_LENS_START + 8, |
| /** |
| * <p>Current lens status.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * </ul> |
| * |
| * <p>For lens parameters ACAMERA_LENS_FOCAL_LENGTH, ACAMERA_LENS_FOCUS_DISTANCE, |
| * ACAMERA_LENS_FILTER_DENSITY and ACAMERA_LENS_APERTURE, when changes are requested, |
| * they may take several frames to reach the requested values. This state indicates |
| * the current status of the lens parameters.</p> |
| * <p>When the state is STATIONARY, the lens parameters are not changing. This could be |
| * either because the parameters are all fixed, or because the lens has had enough |
| * time to reach the most recently-requested values. |
| * If all these lens parameters are not changable for a camera device, as listed below:</p> |
| * <ul> |
| * <li>Fixed focus (<code>ACAMERA_LENS_INFO_MINIMUM_FOCUS_DISTANCE == 0</code>), which means |
| * ACAMERA_LENS_FOCUS_DISTANCE parameter will always be 0.</li> |
| * <li>Fixed focal length (ACAMERA_LENS_INFO_AVAILABLE_FOCAL_LENGTHS contains single value), |
| * which means the optical zoom is not supported.</li> |
| * <li>No ND filter (ACAMERA_LENS_INFO_AVAILABLE_FILTER_DENSITIES contains only 0).</li> |
| * <li>Fixed aperture (ACAMERA_LENS_INFO_AVAILABLE_APERTURES contains single value).</li> |
| * </ul> |
| * <p>Then this state will always be STATIONARY.</p> |
| * <p>When the state is MOVING, it indicates that at least one of the lens parameters |
| * is changing.</p> |
| * |
| * @see ACAMERA_LENS_APERTURE |
| * @see ACAMERA_LENS_FILTER_DENSITY |
| * @see ACAMERA_LENS_FOCAL_LENGTH |
| * @see ACAMERA_LENS_FOCUS_DISTANCE |
| * @see ACAMERA_LENS_INFO_AVAILABLE_APERTURES |
| * @see ACAMERA_LENS_INFO_AVAILABLE_FILTER_DENSITIES |
| * @see ACAMERA_LENS_INFO_AVAILABLE_FOCAL_LENGTHS |
| * @see ACAMERA_LENS_INFO_MINIMUM_FOCUS_DISTANCE |
| */ |
| ACAMERA_LENS_STATE = // byte (enum) |
| ACAMERA_LENS_START + 9, |
| /** |
| * <p>The parameters for this camera device's intrinsic |
| * calibration.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * </ul> |
| * |
| * <p>The five calibration parameters that describe the |
| * transform from camera-centric 3D coordinates to sensor |
| * pixel coordinates:</p> |
| * <pre><code>[f_x, f_y, c_x, c_y, s] |
| * </code></pre> |
| * <p>Where <code>f_x</code> and <code>f_y</code> are the horizontal and vertical |
| * focal lengths, <code>[c_x, c_y]</code> is the position of the optical |
| * axis, and <code>s</code> is a skew parameter for the sensor plane not |
| * being aligned with the lens plane.</p> |
| * <p>These are typically used within a transformation matrix K:</p> |
| * <pre><code>K = [ f_x, s, c_x, |
| * 0, f_y, c_y, |
| * 0 0, 1 ] |
| * </code></pre> |
| * <p>which can then be combined with the camera pose rotation |
| * <code>R</code> and translation <code>t</code> (ACAMERA_LENS_POSE_ROTATION and |
| * ACAMERA_LENS_POSE_TRANSLATION, respective) to calculate the |
| * complete transform from world coordinates to pixel |
| * coordinates:</p> |
| * <pre><code>P = [ K 0 * [ R t |
| * 0 1 ] 0 1 ] |
| * </code></pre> |
| * <p>and with <code>p_w</code> being a point in the world coordinate system |
| * and <code>p_s</code> being a point in the camera active pixel array |
| * coordinate system, and with the mapping including the |
| * homogeneous division by z:</p> |
| * <pre><code> p_h = (x_h, y_h, z_h) = P p_w |
| * p_s = p_h / z_h |
| * </code></pre> |
| * <p>so <code>[x_s, y_s]</code> is the pixel coordinates of the world |
| * point, <code>z_s = 1</code>, and <code>w_s</code> is a measurement of disparity |
| * (depth) in pixel coordinates.</p> |
| * <p>Note that the coordinate system for this transform is the |
| * ACAMERA_SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE system, |
| * where <code>(0,0)</code> is the top-left of the |
| * preCorrectionActiveArraySize rectangle. Once the pose and |
| * intrinsic calibration transforms have been applied to a |
| * world point, then the ACAMERA_LENS_RADIAL_DISTORTION |
| * transform needs to be applied, and the result adjusted to |
| * be in the ACAMERA_SENSOR_INFO_ACTIVE_ARRAY_SIZE coordinate |
| * system (where <code>(0, 0)</code> is the top-left of the |
| * activeArraySize rectangle), to determine the final pixel |
| * coordinate of the world point for processed (non-RAW) |
| * output buffers.</p> |
| * |
| * @see ACAMERA_LENS_POSE_ROTATION |
| * @see ACAMERA_LENS_POSE_TRANSLATION |
| * @see ACAMERA_LENS_RADIAL_DISTORTION |
| * @see ACAMERA_SENSOR_INFO_ACTIVE_ARRAY_SIZE |
| * @see ACAMERA_SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE |
| */ |
| ACAMERA_LENS_INTRINSIC_CALIBRATION = // float[5] |
| ACAMERA_LENS_START + 10, |
| /** |
| * <p>The correction coefficients to correct for this camera device's |
| * radial and tangential lens distortion.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * </ul> |
| * |
| * <p>Four radial distortion coefficients <code>[kappa_0, kappa_1, kappa_2, |
| * kappa_3]</code> and two tangential distortion coefficients |
| * <code>[kappa_4, kappa_5]</code> that can be used to correct the |
| * lens's geometric distortion with the mapping equations:</p> |
| * <pre><code> x_c = x_i * ( kappa_0 + kappa_1 * r^2 + kappa_2 * r^4 + kappa_3 * r^6 ) + |
| * kappa_4 * (2 * x_i * y_i) + kappa_5 * ( r^2 + 2 * x_i^2 ) |
| * y_c = y_i * ( kappa_0 + kappa_1 * r^2 + kappa_2 * r^4 + kappa_3 * r^6 ) + |
| * kappa_5 * (2 * x_i * y_i) + kappa_4 * ( r^2 + 2 * y_i^2 ) |
| * </code></pre> |
| * <p>Here, <code>[x_c, y_c]</code> are the coordinates to sample in the |
| * input image that correspond to the pixel values in the |
| * corrected image at the coordinate <code>[x_i, y_i]</code>:</p> |
| * <pre><code> correctedImage(x_i, y_i) = sample_at(x_c, y_c, inputImage) |
| * </code></pre> |
| * <p>The pixel coordinates are defined in a normalized |
| * coordinate system related to the |
| * ACAMERA_LENS_INTRINSIC_CALIBRATION calibration fields. |
| * Both <code>[x_i, y_i]</code> and <code>[x_c, y_c]</code> have <code>(0,0)</code> at the |
| * lens optical center <code>[c_x, c_y]</code>. The maximum magnitudes |
| * of both x and y coordinates are normalized to be 1 at the |
| * edge further from the optical center, so the range |
| * for both dimensions is <code>-1 <= x <= 1</code>.</p> |
| * <p>Finally, <code>r</code> represents the radial distance from the |
| * optical center, <code>r^2 = x_i^2 + y_i^2</code>, and its magnitude |
| * is therefore no larger than <code>|r| <= sqrt(2)</code>.</p> |
| * <p>The distortion model used is the Brown-Conrady model.</p> |
| * |
| * @see ACAMERA_LENS_INTRINSIC_CALIBRATION |
| */ |
| ACAMERA_LENS_RADIAL_DISTORTION = // float[6] |
| ACAMERA_LENS_START + 11, |
| ACAMERA_LENS_END, |
| |
| /** |
| * <p>List of aperture size values for ACAMERA_LENS_APERTURE that are |
| * supported by this camera device.</p> |
| * |
| * @see ACAMERA_LENS_APERTURE |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>If the camera device doesn't support a variable lens aperture, |
| * this list will contain only one value, which is the fixed aperture size.</p> |
| * <p>If the camera device supports a variable aperture, the aperture values |
| * in this list will be sorted in ascending order.</p> |
| */ |
| ACAMERA_LENS_INFO_AVAILABLE_APERTURES = // float[n] |
| ACAMERA_LENS_INFO_START, |
| /** |
| * <p>List of neutral density filter values for |
| * ACAMERA_LENS_FILTER_DENSITY that are supported by this camera device.</p> |
| * |
| * @see ACAMERA_LENS_FILTER_DENSITY |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>If a neutral density filter is not supported by this camera device, |
| * this list will contain only 0. Otherwise, this list will include every |
| * filter density supported by the camera device, in ascending order.</p> |
| */ |
| ACAMERA_LENS_INFO_AVAILABLE_FILTER_DENSITIES = // float[n] |
| ACAMERA_LENS_INFO_START + 1, |
| /** |
| * <p>List of focal lengths for ACAMERA_LENS_FOCAL_LENGTH that are supported by this camera |
| * device.</p> |
| * |
| * @see ACAMERA_LENS_FOCAL_LENGTH |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>If optical zoom is not supported, this list will only contain |
| * a single value corresponding to the fixed focal length of the |
| * device. Otherwise, this list will include every focal length supported |
| * by the camera device, in ascending order.</p> |
| */ |
| ACAMERA_LENS_INFO_AVAILABLE_FOCAL_LENGTHS = // float[n] |
| ACAMERA_LENS_INFO_START + 2, |
| /** |
| * <p>List of optical image stabilization (OIS) modes for |
| * ACAMERA_LENS_OPTICAL_STABILIZATION_MODE that are supported by this camera device.</p> |
| * |
| * @see ACAMERA_LENS_OPTICAL_STABILIZATION_MODE |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>If OIS is not supported by a given camera device, this list will |
| * contain only OFF.</p> |
| */ |
| ACAMERA_LENS_INFO_AVAILABLE_OPTICAL_STABILIZATION = // byte[n] |
| ACAMERA_LENS_INFO_START + 3, |
| /** |
| * <p>Hyperfocal distance for this lens.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>If the lens is not fixed focus, the camera device will report this |
| * field when ACAMERA_LENS_INFO_FOCUS_DISTANCE_CALIBRATION is APPROXIMATE or CALIBRATED.</p> |
| * |
| * @see ACAMERA_LENS_INFO_FOCUS_DISTANCE_CALIBRATION |
| */ |
| ACAMERA_LENS_INFO_HYPERFOCAL_DISTANCE = // float |
| ACAMERA_LENS_INFO_START + 4, |
| /** |
| * <p>Shortest distance from frontmost surface |
| * of the lens that can be brought into sharp focus.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>If the lens is fixed-focus, this will be |
| * 0.</p> |
| */ |
| ACAMERA_LENS_INFO_MINIMUM_FOCUS_DISTANCE = // float |
| ACAMERA_LENS_INFO_START + 5, |
| /** |
| * <p>Dimensions of lens shading map.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>The map should be on the order of 30-40 rows and columns, and |
| * must be smaller than 64x64.</p> |
| */ |
| ACAMERA_LENS_INFO_SHADING_MAP_SIZE = // int32[2] |
| ACAMERA_LENS_INFO_START + 6, |
| /** |
| * <p>The lens focus distance calibration quality.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>The lens focus distance calibration quality determines the reliability of |
| * focus related metadata entries, i.e. ACAMERA_LENS_FOCUS_DISTANCE, |
| * ACAMERA_LENS_FOCUS_RANGE, ACAMERA_LENS_INFO_HYPERFOCAL_DISTANCE, and |
| * ACAMERA_LENS_INFO_MINIMUM_FOCUS_DISTANCE.</p> |
| * <p>APPROXIMATE and CALIBRATED devices report the focus metadata in |
| * units of diopters (1/meter), so <code>0.0f</code> represents focusing at infinity, |
| * and increasing positive numbers represent focusing closer and closer |
| * to the camera device. The focus distance control also uses diopters |
| * on these devices.</p> |
| * <p>UNCALIBRATED devices do not use units that are directly comparable |
| * to any real physical measurement, but <code>0.0f</code> still represents farthest |
| * focus, and ACAMERA_LENS_INFO_MINIMUM_FOCUS_DISTANCE represents the |
| * nearest focus the device can achieve.</p> |
| * |
| * @see ACAMERA_LENS_FOCUS_DISTANCE |
| * @see ACAMERA_LENS_FOCUS_RANGE |
| * @see ACAMERA_LENS_INFO_HYPERFOCAL_DISTANCE |
| * @see ACAMERA_LENS_INFO_MINIMUM_FOCUS_DISTANCE |
| */ |
| ACAMERA_LENS_INFO_FOCUS_DISTANCE_CALIBRATION = // byte (enum) |
| ACAMERA_LENS_INFO_START + 7, |
| ACAMERA_LENS_INFO_END, |
| |
| /** |
| * <p>Mode of operation for the noise reduction algorithm.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>The noise reduction algorithm attempts to improve image quality by removing |
| * excessive noise added by the capture process, especially in dark conditions.</p> |
| * <p>OFF means no noise reduction will be applied by the camera device, for both raw and |
| * YUV domain.</p> |
| * <p>MINIMAL means that only sensor raw domain basic noise reduction is enabled ,to remove |
| * demosaicing or other processing artifacts. For YUV_REPROCESSING, MINIMAL is same as OFF. |
| * This mode is optional, may not be support by all devices. The application should check |
| * ACAMERA_NOISE_REDUCTION_AVAILABLE_NOISE_REDUCTION_MODES before using it.</p> |
| * <p>FAST/HIGH_QUALITY both mean camera device determined noise filtering |
| * will be applied. HIGH_QUALITY mode indicates that the camera device |
| * will use the highest-quality noise filtering algorithms, |
| * even if it slows down capture rate. FAST means the camera device will not |
| * slow down capture rate when applying noise filtering. FAST may be the same as MINIMAL if |
| * MINIMAL is listed, or the same as OFF if any noise filtering will slow down capture rate. |
| * Every output stream will have a similar amount of enhancement applied.</p> |
| * <p>ZERO_SHUTTER_LAG is meant to be used by applications that maintain a continuous circular |
| * buffer of high-resolution images during preview and reprocess image(s) from that buffer |
| * into a final capture when triggered by the user. In this mode, the camera device applies |
| * noise reduction to low-resolution streams (below maximum recording resolution) to maximize |
| * preview quality, but does not apply noise reduction to high-resolution streams, since |
| * those will be reprocessed later if necessary.</p> |
| * <p>For YUV_REPROCESSING, these FAST/HIGH_QUALITY modes both mean that the camera device |
| * will apply FAST/HIGH_QUALITY YUV domain noise reduction, respectively. The camera device |
| * may adjust the noise reduction parameters for best image quality based on the |
| * android.reprocess.effectiveExposureFactor if it is set.</p> |
| * |
| * @see ACAMERA_NOISE_REDUCTION_AVAILABLE_NOISE_REDUCTION_MODES |
| */ |
| ACAMERA_NOISE_REDUCTION_MODE = // byte (enum) |
| ACAMERA_NOISE_REDUCTION_START, |
| /** |
| * <p>List of noise reduction modes for ACAMERA_NOISE_REDUCTION_MODE that are supported |
| * by this camera device.</p> |
| * |
| * @see ACAMERA_NOISE_REDUCTION_MODE |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>Full-capability camera devices will always support OFF and FAST.</p> |
| * <p>Camera devices that support YUV_REPROCESSING or PRIVATE_REPROCESSING will support |
| * ZERO_SHUTTER_LAG.</p> |
| * <p>Legacy-capability camera devices will only support FAST mode.</p> |
| */ |
| ACAMERA_NOISE_REDUCTION_AVAILABLE_NOISE_REDUCTION_MODES = // byte[n] |
| ACAMERA_NOISE_REDUCTION_START + 2, |
| ACAMERA_NOISE_REDUCTION_END, |
| |
| /** |
| * <p>The maximum numbers of different types of output streams |
| * that can be configured and used simultaneously by a camera device.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>This is a 3 element tuple that contains the max number of output simultaneous |
| * streams for raw sensor, processed (but not stalling), and processed (and stalling) |
| * formats respectively. For example, assuming that JPEG is typically a processed and |
| * stalling stream, if max raw sensor format output stream number is 1, max YUV streams |
| * number is 3, and max JPEG stream number is 2, then this tuple should be <code>(1, 3, 2)</code>.</p> |
| * <p>This lists the upper bound of the number of output streams supported by |
| * the camera device. Using more streams simultaneously may require more hardware and |
| * CPU resources that will consume more power. The image format for an output stream can |
| * be any supported format provided by ACAMERA_SCALER_AVAILABLE_STREAM_CONFIGURATIONS. |
| * The formats defined in ACAMERA_SCALER_AVAILABLE_STREAM_CONFIGURATIONS can be catergorized |
| * into the 3 stream types as below:</p> |
| * <ul> |
| * <li>Processed (but stalling): any non-RAW format with a stallDurations > 0. |
| * Typically {@link AIMAGE_FORMAT_JPEG} format.</li> |
| * <li>Raw formats: {@link AIMAGE_FORMAT_RAW16}, {@link AIMAGE_FORMAT_RAW10}, or |
| * {@link AIMAGE_FORMAT_RAW12}.</li> |
| * <li>Processed (but not-stalling): any non-RAW format without a stall duration. |
| * Typically {@link AIMAGE_FORMAT_YUV_420_888}.</li> |
| * </ul> |
| * |
| * @see ACAMERA_SCALER_AVAILABLE_STREAM_CONFIGURATIONS |
| */ |
| ACAMERA_REQUEST_MAX_NUM_OUTPUT_STREAMS = // int32[3] |
| ACAMERA_REQUEST_START + 6, |
| /** |
| * <p>Specifies the number of pipeline stages the frame went |
| * through from when it was exposed to when the final completed result |
| * was available to the framework.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * </ul> |
| * |
| * <p>Depending on what settings are used in the request, and |
| * what streams are configured, the data may undergo less processing, |
| * and some pipeline stages skipped.</p> |
| * <p>See ACAMERA_REQUEST_PIPELINE_MAX_DEPTH for more details.</p> |
| * |
| * @see ACAMERA_REQUEST_PIPELINE_MAX_DEPTH |
| */ |
| ACAMERA_REQUEST_PIPELINE_DEPTH = // byte |
| ACAMERA_REQUEST_START + 9, |
| /** |
| * <p>Specifies the number of maximum pipeline stages a frame |
| * has to go through from when it's exposed to when it's available |
| * to the framework.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>A typical minimum value for this is 2 (one stage to expose, |
| * one stage to readout) from the sensor. The ISP then usually adds |
| * its own stages to do custom HW processing. Further stages may be |
| * added by SW processing.</p> |
| * <p>Depending on what settings are used (e.g. YUV, JPEG) and what |
| * processing is enabled (e.g. face detection), the actual pipeline |
| * depth (specified by ACAMERA_REQUEST_PIPELINE_DEPTH) may be less than |
| * the max pipeline depth.</p> |
| * <p>A pipeline depth of X stages is equivalent to a pipeline latency of |
| * X frame intervals.</p> |
| * <p>This value will normally be 8 or less, however, for high speed capture session, |
| * the max pipeline depth will be up to 8 x size of high speed capture request list.</p> |
| * |
| * @see ACAMERA_REQUEST_PIPELINE_DEPTH |
| */ |
| ACAMERA_REQUEST_PIPELINE_MAX_DEPTH = // byte |
| ACAMERA_REQUEST_START + 10, |
| /** |
| * <p>Defines how many sub-components |
| * a result will be composed of.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>In order to combat the pipeline latency, partial results |
| * may be delivered to the application layer from the camera device as |
| * soon as they are available.</p> |
| * <p>Optional; defaults to 1. A value of 1 means that partial |
| * results are not supported, and only the final TotalCaptureResult will |
| * be produced by the camera device.</p> |
| * <p>A typical use case for this might be: after requesting an |
| * auto-focus (AF) lock the new AF state might be available 50% |
| * of the way through the pipeline. The camera device could |
| * then immediately dispatch this state via a partial result to |
| * the application, and the rest of the metadata via later |
| * partial results.</p> |
| */ |
| ACAMERA_REQUEST_PARTIAL_RESULT_COUNT = // int32 |
| ACAMERA_REQUEST_START + 11, |
| /** |
| * <p>List of capabilities that this camera device |
| * advertises as fully supporting.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>A capability is a contract that the camera device makes in order |
| * to be able to satisfy one or more use cases.</p> |
| * <p>Listing a capability guarantees that the whole set of features |
| * required to support a common use will all be available.</p> |
| * <p>Using a subset of the functionality provided by an unsupported |
| * capability may be possible on a specific camera device implementation; |
| * to do this query each of ACAMERA_REQUEST_AVAILABLE_REQUEST_KEYS, |
| * ACAMERA_REQUEST_AVAILABLE_RESULT_KEYS, |
| * ACAMERA_REQUEST_AVAILABLE_CHARACTERISTICS_KEYS.</p> |
| * <p>The following capabilities are guaranteed to be available on |
| * ACAMERA_INFO_SUPPORTED_HARDWARE_LEVEL <code>==</code> FULL devices:</p> |
| * <ul> |
| * <li>MANUAL_SENSOR</li> |
| * <li>MANUAL_POST_PROCESSING</li> |
| * </ul> |
| * <p>Other capabilities may be available on either FULL or LIMITED |
| * devices, but the application should query this key to be sure.</p> |
| * |
| * @see ACAMERA_INFO_SUPPORTED_HARDWARE_LEVEL |
| * @see ACAMERA_REQUEST_AVAILABLE_CHARACTERISTICS_KEYS |
| * @see ACAMERA_REQUEST_AVAILABLE_REQUEST_KEYS |
| * @see ACAMERA_REQUEST_AVAILABLE_RESULT_KEYS |
| */ |
| ACAMERA_REQUEST_AVAILABLE_CAPABILITIES = // byte[n] (enum) |
| ACAMERA_REQUEST_START + 12, |
| /** |
| * <p>A list of all keys that the camera device has available |
| * to use with {@link ACaptureRequest}.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>Attempting to set a key into a CaptureRequest that is not |
| * listed here will result in an invalid request and will be rejected |
| * by the camera device.</p> |
| * <p>This field can be used to query the feature set of a camera device |
| * at a more granular level than capabilities. This is especially |
| * important for optional keys that are not listed under any capability |
| * in ACAMERA_REQUEST_AVAILABLE_CAPABILITIES.</p> |
| * |
| * @see ACAMERA_REQUEST_AVAILABLE_CAPABILITIES |
| */ |
| ACAMERA_REQUEST_AVAILABLE_REQUEST_KEYS = // int32[n] |
| ACAMERA_REQUEST_START + 13, |
| /** |
| * <p>A list of all keys that the camera device has available |
| * to query with {@link ACameraMetadata} from |
| * {@link ACameraCaptureSession_captureCallback_result}.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>Attempting to get a key from a CaptureResult that is not |
| * listed here will always return a <code>null</code> value. Getting a key from |
| * a CaptureResult that is listed here will generally never return a <code>null</code> |
| * value.</p> |
| * <p>The following keys may return <code>null</code> unless they are enabled:</p> |
| * <ul> |
| * <li>ACAMERA_STATISTICS_LENS_SHADING_MAP (non-null iff ACAMERA_STATISTICS_LENS_SHADING_MAP_MODE == ON)</li> |
| * </ul> |
| * <p>(Those sometimes-null keys will nevertheless be listed here |
| * if they are available.)</p> |
| * <p>This field can be used to query the feature set of a camera device |
| * at a more granular level than capabilities. This is especially |
| * important for optional keys that are not listed under any capability |
| * in ACAMERA_REQUEST_AVAILABLE_CAPABILITIES.</p> |
| * |
| * @see ACAMERA_REQUEST_AVAILABLE_CAPABILITIES |
| * @see ACAMERA_STATISTICS_LENS_SHADING_MAP |
| * @see ACAMERA_STATISTICS_LENS_SHADING_MAP_MODE |
| */ |
| ACAMERA_REQUEST_AVAILABLE_RESULT_KEYS = // int32[n] |
| ACAMERA_REQUEST_START + 14, |
| /** |
| * <p>A list of all keys that the camera device has available |
| * to query with {@link ACameraMetadata} from |
| * {@link ACameraManager_getCameraCharacteristics}.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>This entry follows the same rules as |
| * ACAMERA_REQUEST_AVAILABLE_RESULT_KEYS (except that it applies for |
| * CameraCharacteristics instead of CaptureResult). See above for more |
| * details.</p> |
| * |
| * @see ACAMERA_REQUEST_AVAILABLE_RESULT_KEYS |
| */ |
| ACAMERA_REQUEST_AVAILABLE_CHARACTERISTICS_KEYS = // int32[n] |
| ACAMERA_REQUEST_START + 15, |
| ACAMERA_REQUEST_END, |
| |
| /** |
| * <p>The desired region of the sensor to read out for this capture.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>This control can be used to implement digital zoom.</p> |
| * <p>The data representation is int[4], which maps to (left, top, width, height).</p> |
| * <p>The crop region coordinate system is based off |
| * ACAMERA_SENSOR_INFO_ACTIVE_ARRAY_SIZE, with <code>(0, 0)</code> being the |
| * top-left corner of the sensor active array.</p> |
| * <p>Output streams use this rectangle to produce their output, |
| * cropping to a smaller region if necessary to maintain the |
| * stream's aspect ratio, then scaling the sensor input to |
| * match the output's configured resolution.</p> |
| * <p>The crop region is applied after the RAW to other color |
| * space (e.g. YUV) conversion. Since raw streams |
| * (e.g. RAW16) don't have the conversion stage, they are not |
| * croppable. The crop region will be ignored by raw streams.</p> |
| * <p>For non-raw streams, any additional per-stream cropping will |
| * be done to maximize the final pixel area of the stream.</p> |
| * <p>For example, if the crop region is set to a 4:3 aspect |
| * ratio, then 4:3 streams will use the exact crop |
| * region. 16:9 streams will further crop vertically |
| * (letterbox).</p> |
| * <p>Conversely, if the crop region is set to a 16:9, then 4:3 |
| * outputs will crop horizontally (pillarbox), and 16:9 |
| * streams will match exactly. These additional crops will |
| * be centered within the crop region.</p> |
| * <p>The width and height of the crop region cannot |
| * be set to be smaller than |
| * <code>floor( activeArraySize.width / ACAMERA_SCALER_AVAILABLE_MAX_DIGITAL_ZOOM )</code> and |
| * <code>floor( activeArraySize.height / ACAMERA_SCALER_AVAILABLE_MAX_DIGITAL_ZOOM )</code>, respectively.</p> |
| * <p>The camera device may adjust the crop region to account |
| * for rounding and other hardware requirements; the final |
| * crop region used will be included in the output capture |
| * result.</p> |
| * |
| * @see ACAMERA_SCALER_AVAILABLE_MAX_DIGITAL_ZOOM |
| * @see ACAMERA_SENSOR_INFO_ACTIVE_ARRAY_SIZE |
| */ |
| ACAMERA_SCALER_CROP_REGION = // int32[4] |
| ACAMERA_SCALER_START, |
| /** |
| * <p>The maximum ratio between both active area width |
| * and crop region width, and active area height and |
| * crop region height, for ACAMERA_SCALER_CROP_REGION.</p> |
| * |
| * @see ACAMERA_SCALER_CROP_REGION |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>This represents the maximum amount of zooming possible by |
| * the camera device, or equivalently, the minimum cropping |
| * window size.</p> |
| * <p>Crop regions that have a width or height that is smaller |
| * than this ratio allows will be rounded up to the minimum |
| * allowed size by the camera device.</p> |
| */ |
| ACAMERA_SCALER_AVAILABLE_MAX_DIGITAL_ZOOM = // float |
| ACAMERA_SCALER_START + 4, |
| /** |
| * <p>The available stream configurations that this |
| * camera device supports |
| * (i.e. format, width, height, output/input stream).</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>The configurations are listed as <code>(format, width, height, input?)</code> |
| * tuples.</p> |
| * <p>For a given use case, the actual maximum supported resolution |
| * may be lower than what is listed here, depending on the destination |
| * Surface for the image data. For example, for recording video, |
| * the video encoder chosen may have a maximum size limit (e.g. 1080p) |
| * smaller than what the camera (e.g. maximum resolution is 3264x2448) |
| * can provide.</p> |
| * <p>Please reference the documentation for the image data destination to |
| * check if it limits the maximum size for image data.</p> |
| * <p>Not all output formats may be supported in a configuration with |
| * an input stream of a particular format. For more details, see |
| * android.scaler.availableInputOutputFormatsMap.</p> |
| * <p>The following table describes the minimum required output stream |
| * configurations based on the hardware level |
| * (ACAMERA_INFO_SUPPORTED_HARDWARE_LEVEL):</p> |
| * <p>Format | Size | Hardware Level | Notes |
| * :-------------:|:--------------------------------------------:|:--------------:|:--------------: |
| * JPEG | ACAMERA_SENSOR_INFO_ACTIVE_ARRAY_SIZE | Any | |
| * JPEG | 1920x1080 (1080p) | Any | if 1080p <= activeArraySize |
| * JPEG | 1280x720 (720) | Any | if 720p <= activeArraySize |
| * JPEG | 640x480 (480p) | Any | if 480p <= activeArraySize |
| * JPEG | 320x240 (240p) | Any | if 240p <= activeArraySize |
| * YUV_420_888 | all output sizes available for JPEG | FULL | |
| * YUV_420_888 | all output sizes available for JPEG, up to the maximum video size | LIMITED | |
| * IMPLEMENTATION_DEFINED | same as YUV_420_888 | Any |</p> |
| * <p>Refer to ACAMERA_REQUEST_AVAILABLE_CAPABILITIES for additional |
| * mandatory stream configurations on a per-capability basis.</p> |
| * |
| * @see ACAMERA_INFO_SUPPORTED_HARDWARE_LEVEL |
| * @see ACAMERA_REQUEST_AVAILABLE_CAPABILITIES |
| * @see ACAMERA_SENSOR_INFO_ACTIVE_ARRAY_SIZE |
| */ |
| ACAMERA_SCALER_AVAILABLE_STREAM_CONFIGURATIONS = // int32[n*4] (enum) |
| ACAMERA_SCALER_START + 10, |
| /** |
| * <p>This lists the minimum frame duration for each |
| * format/size combination.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>This should correspond to the frame duration when only that |
| * stream is active, with all processing (typically in android.*.mode) |
| * set to either OFF or FAST.</p> |
| * <p>When multiple streams are used in a request, the minimum frame |
| * duration will be max(individual stream min durations).</p> |
| * <p>The minimum frame duration of a stream (of a particular format, size) |
| * is the same regardless of whether the stream is input or output.</p> |
| * <p>See ACAMERA_SENSOR_FRAME_DURATION and |
| * ACAMERA_SCALER_AVAILABLE_STALL_DURATIONS for more details about |
| * calculating the max frame rate.</p> |
| * |
| * @see ACAMERA_SCALER_AVAILABLE_STALL_DURATIONS |
| * @see ACAMERA_SENSOR_FRAME_DURATION |
| */ |
| ACAMERA_SCALER_AVAILABLE_MIN_FRAME_DURATIONS = // int64[4*n] |
| ACAMERA_SCALER_START + 11, |
| /** |
| * <p>This lists the maximum stall duration for each |
| * output format/size combination.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>A stall duration is how much extra time would get added |
| * to the normal minimum frame duration for a repeating request |
| * that has streams with non-zero stall.</p> |
| * <p>For example, consider JPEG captures which have the following |
| * characteristics:</p> |
| * <ul> |
| * <li>JPEG streams act like processed YUV streams in requests for which |
| * they are not included; in requests in which they are directly |
| * referenced, they act as JPEG streams. This is because supporting a |
| * JPEG stream requires the underlying YUV data to always be ready for |
| * use by a JPEG encoder, but the encoder will only be used (and impact |
| * frame duration) on requests that actually reference a JPEG stream.</li> |
| * <li>The JPEG processor can run concurrently to the rest of the camera |
| * pipeline, but cannot process more than 1 capture at a time.</li> |
| * </ul> |
| * <p>In other words, using a repeating YUV request would result |
| * in a steady frame rate (let's say it's 30 FPS). If a single |
| * JPEG request is submitted periodically, the frame rate will stay |
| * at 30 FPS (as long as we wait for the previous JPEG to return each |
| * time). If we try to submit a repeating YUV + JPEG request, then |
| * the frame rate will drop from 30 FPS.</p> |
| * <p>In general, submitting a new request with a non-0 stall time |
| * stream will <em>not</em> cause a frame rate drop unless there are still |
| * outstanding buffers for that stream from previous requests.</p> |
| * <p>Submitting a repeating request with streams (call this <code>S</code>) |
| * is the same as setting the minimum frame duration from |
| * the normal minimum frame duration corresponding to <code>S</code>, added with |
| * the maximum stall duration for <code>S</code>.</p> |
| * <p>If interleaving requests with and without a stall duration, |
| * a request will stall by the maximum of the remaining times |
| * for each can-stall stream with outstanding buffers.</p> |
| * <p>This means that a stalling request will not have an exposure start |
| * until the stall has completed.</p> |
| * <p>This should correspond to the stall duration when only that stream is |
| * active, with all processing (typically in android.*.mode) set to FAST |
| * or OFF. Setting any of the processing modes to HIGH_QUALITY |
| * effectively results in an indeterminate stall duration for all |
| * streams in a request (the regular stall calculation rules are |
| * ignored).</p> |
| * <p>The following formats may always have a stall duration:</p> |
| * <ul> |
| * <li>{@link AIMAGE_FORMAT_JPEG}</li> |
| * <li>{@link AIMAGE_FORMAT_RAW16}</li> |
| * </ul> |
| * <p>The following formats will never have a stall duration:</p> |
| * <ul> |
| * <li>{@link AIMAGE_FORMAT_YUV_420_888}</li> |
| * <li>{@link AIMAGE_FORMAT_RAW10}</li> |
| * </ul> |
| * <p>All other formats may or may not have an allowed stall duration on |
| * a per-capability basis; refer to ACAMERA_REQUEST_AVAILABLE_CAPABILITIES |
| * for more details.</p> |
| * <p>See ACAMERA_SENSOR_FRAME_DURATION for more information about |
| * calculating the max frame rate (absent stalls).</p> |
| * |
| * @see ACAMERA_REQUEST_AVAILABLE_CAPABILITIES |
| * @see ACAMERA_SENSOR_FRAME_DURATION |
| */ |
| ACAMERA_SCALER_AVAILABLE_STALL_DURATIONS = // int64[4*n] |
| ACAMERA_SCALER_START + 12, |
| /** |
| * <p>The crop type that this camera device supports.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>When passing a non-centered crop region (ACAMERA_SCALER_CROP_REGION) to a camera |
| * device that only supports CENTER_ONLY cropping, the camera device will move the |
| * crop region to the center of the sensor active array (ACAMERA_SENSOR_INFO_ACTIVE_ARRAY_SIZE) |
| * and keep the crop region width and height unchanged. The camera device will return the |
| * final used crop region in metadata result ACAMERA_SCALER_CROP_REGION.</p> |
| * <p>Camera devices that support FREEFORM cropping will support any crop region that |
| * is inside of the active array. The camera device will apply the same crop region and |
| * return the final used crop region in capture result metadata ACAMERA_SCALER_CROP_REGION.</p> |
| * <p>LEGACY capability devices will only support CENTER_ONLY cropping.</p> |
| * |
| * @see ACAMERA_SCALER_CROP_REGION |
| * @see ACAMERA_SENSOR_INFO_ACTIVE_ARRAY_SIZE |
| */ |
| ACAMERA_SCALER_CROPPING_TYPE = // byte (enum) |
| ACAMERA_SCALER_START + 13, |
| ACAMERA_SCALER_END, |
| |
| /** |
| * <p>Duration each pixel is exposed to |
| * light.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>If the sensor can't expose this exact duration, it will shorten the |
| * duration exposed to the nearest possible value (rather than expose longer). |
| * The final exposure time used will be available in the output capture result.</p> |
| * <p>This control is only effective if ACAMERA_CONTROL_AE_MODE or ACAMERA_CONTROL_MODE is set to |
| * OFF; otherwise the auto-exposure algorithm will override this value.</p> |
| * |
| * @see ACAMERA_CONTROL_AE_MODE |
| * @see ACAMERA_CONTROL_MODE |
| */ |
| ACAMERA_SENSOR_EXPOSURE_TIME = // int64 |
| ACAMERA_SENSOR_START, |
| /** |
| * <p>Duration from start of frame exposure to |
| * start of next frame exposure.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>The maximum frame rate that can be supported by a camera subsystem is |
| * a function of many factors:</p> |
| * <ul> |
| * <li>Requested resolutions of output image streams</li> |
| * <li>Availability of binning / skipping modes on the imager</li> |
| * <li>The bandwidth of the imager interface</li> |
| * <li>The bandwidth of the various ISP processing blocks</li> |
| * </ul> |
| * <p>Since these factors can vary greatly between different ISPs and |
| * sensors, the camera abstraction tries to represent the bandwidth |
| * restrictions with as simple a model as possible.</p> |
| * <p>The model presented has the following characteristics:</p> |
| * <ul> |
| * <li>The image sensor is always configured to output the smallest |
| * resolution possible given the application's requested output stream |
| * sizes. The smallest resolution is defined as being at least as large |
| * as the largest requested output stream size; the camera pipeline must |
| * never digitally upsample sensor data when the crop region covers the |
| * whole sensor. In general, this means that if only small output stream |
| * resolutions are configured, the sensor can provide a higher frame |
| * rate.</li> |
| * <li>Since any request may use any or all the currently configured |
| * output streams, the sensor and ISP must be configured to support |
| * scaling a single capture to all the streams at the same time. This |
| * means the camera pipeline must be ready to produce the largest |
| * requested output size without any delay. Therefore, the overall |
| * frame rate of a given configured stream set is governed only by the |
| * largest requested stream resolution.</li> |
| * <li>Using more than one output stream in a request does not affect the |
| * frame duration.</li> |
| * <li>Certain format-streams may need to do additional background processing |
| * before data is consumed/produced by that stream. These processors |
| * can run concurrently to the rest of the camera pipeline, but |
| * cannot process more than 1 capture at a time.</li> |
| * </ul> |
| * <p>The necessary information for the application, given the model above, |
| * is provided via |
| * {@link ACAMERA_SCALER_AVAILABLE_MIN_FRAME_DURATIONS}. |
| * These are used to determine the maximum frame rate / minimum frame |
| * duration that is possible for a given stream configuration.</p> |
| * <p>Specifically, the application can use the following rules to |
| * determine the minimum frame duration it can request from the camera |
| * device:</p> |
| * <ol> |
| * <li>Let the set of currently configured input/output streams |
| * be called <code>S</code>.</li> |
| * <li>Find the minimum frame durations for each stream in <code>S</code>, by looking |
| * it up in {@link ACAMERA_SCALER_AVAILABLE_MIN_FRAME_DURATIONS} |
| * (with its respective size/format). Let this set of frame durations be |
| * called <code>F</code>.</li> |
| * <li>For any given request <code>R</code>, the minimum frame duration allowed |
| * for <code>R</code> is the maximum out of all values in <code>F</code>. Let the streams |
| * used in <code>R</code> be called <code>S_r</code>.</li> |
| * </ol> |
| * <p>If none of the streams in <code>S_r</code> have a stall time (listed in {@link |
| * ACAMERA_SCALER_AVAILABLE_STALL_DURATIONS} |
| * using its respective size/format), then the frame duration in <code>F</code> |
| * determines the steady state frame rate that the application will get |
| * if it uses <code>R</code> as a repeating request. Let this special kind of |
| * request be called <code>Rsimple</code>.</p> |
| * <p>A repeating request <code>Rsimple</code> can be <em>occasionally</em> interleaved |
| * by a single capture of a new request <code>Rstall</code> (which has at least |
| * one in-use stream with a non-0 stall time) and if <code>Rstall</code> has the |
| * same minimum frame duration this will not cause a frame rate loss |
| * if all buffers from the previous <code>Rstall</code> have already been |
| * delivered.</p> |
| * <p>For more details about stalling, see |
| * {@link ACAMERA_SCALER_AVAILABLE_STALL_DURATIONS}.</p> |
| * <p>This control is only effective if ACAMERA_CONTROL_AE_MODE or ACAMERA_CONTROL_MODE is set to |
| * OFF; otherwise the auto-exposure algorithm will override this value.</p> |
| * |
| * @see ACAMERA_CONTROL_AE_MODE |
| * @see ACAMERA_CONTROL_MODE |
| */ |
| ACAMERA_SENSOR_FRAME_DURATION = // int64 |
| ACAMERA_SENSOR_START + 1, |
| /** |
| * <p>The amount of gain applied to sensor data |
| * before processing.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>The sensitivity is the standard ISO sensitivity value, |
| * as defined in ISO 12232:2006.</p> |
| * <p>The sensitivity must be within ACAMERA_SENSOR_INFO_SENSITIVITY_RANGE, and |
| * if if it less than ACAMERA_SENSOR_MAX_ANALOG_SENSITIVITY, the camera device |
| * is guaranteed to use only analog amplification for applying the gain.</p> |
| * <p>If the camera device cannot apply the exact sensitivity |
| * requested, it will reduce the gain to the nearest supported |
| * value. The final sensitivity used will be available in the |
| * output capture result.</p> |
| * <p>This control is only effective if ACAMERA_CONTROL_AE_MODE or ACAMERA_CONTROL_MODE is set to |
| * OFF; otherwise the auto-exposure algorithm will override this value.</p> |
| * |
| * @see ACAMERA_CONTROL_AE_MODE |
| * @see ACAMERA_CONTROL_MODE |
| * @see ACAMERA_SENSOR_INFO_SENSITIVITY_RANGE |
| * @see ACAMERA_SENSOR_MAX_ANALOG_SENSITIVITY |
| */ |
| ACAMERA_SENSOR_SENSITIVITY = // int32 |
| ACAMERA_SENSOR_START + 2, |
| /** |
| * <p>The standard reference illuminant used as the scene light source when |
| * calculating the ACAMERA_SENSOR_COLOR_TRANSFORM1, |
| * ACAMERA_SENSOR_CALIBRATION_TRANSFORM1, and |
| * ACAMERA_SENSOR_FORWARD_MATRIX1 matrices.</p> |
| * |
| * @see ACAMERA_SENSOR_CALIBRATION_TRANSFORM1 |
| * @see ACAMERA_SENSOR_COLOR_TRANSFORM1 |
| * @see ACAMERA_SENSOR_FORWARD_MATRIX1 |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>The values in this key correspond to the values defined for the |
| * EXIF LightSource tag. These illuminants are standard light sources |
| * that are often used calibrating camera devices.</p> |
| * <p>If this key is present, then ACAMERA_SENSOR_COLOR_TRANSFORM1, |
| * ACAMERA_SENSOR_CALIBRATION_TRANSFORM1, and |
| * ACAMERA_SENSOR_FORWARD_MATRIX1 will also be present.</p> |
| * <p>Some devices may choose to provide a second set of calibration |
| * information for improved quality, including |
| * ACAMERA_SENSOR_REFERENCE_ILLUMINANT2 and its corresponding matrices.</p> |
| * |
| * @see ACAMERA_SENSOR_CALIBRATION_TRANSFORM1 |
| * @see ACAMERA_SENSOR_COLOR_TRANSFORM1 |
| * @see ACAMERA_SENSOR_FORWARD_MATRIX1 |
| * @see ACAMERA_SENSOR_REFERENCE_ILLUMINANT2 |
| */ |
| ACAMERA_SENSOR_REFERENCE_ILLUMINANT1 = // byte (enum) |
| ACAMERA_SENSOR_START + 3, |
| /** |
| * <p>The standard reference illuminant used as the scene light source when |
| * calculating the ACAMERA_SENSOR_COLOR_TRANSFORM2, |
| * ACAMERA_SENSOR_CALIBRATION_TRANSFORM2, and |
| * ACAMERA_SENSOR_FORWARD_MATRIX2 matrices.</p> |
| * |
| * @see ACAMERA_SENSOR_CALIBRATION_TRANSFORM2 |
| * @see ACAMERA_SENSOR_COLOR_TRANSFORM2 |
| * @see ACAMERA_SENSOR_FORWARD_MATRIX2 |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>See ACAMERA_SENSOR_REFERENCE_ILLUMINANT1 for more details.</p> |
| * <p>If this key is present, then ACAMERA_SENSOR_COLOR_TRANSFORM2, |
| * ACAMERA_SENSOR_CALIBRATION_TRANSFORM2, and |
| * ACAMERA_SENSOR_FORWARD_MATRIX2 will also be present.</p> |
| * |
| * @see ACAMERA_SENSOR_CALIBRATION_TRANSFORM2 |
| * @see ACAMERA_SENSOR_COLOR_TRANSFORM2 |
| * @see ACAMERA_SENSOR_FORWARD_MATRIX2 |
| * @see ACAMERA_SENSOR_REFERENCE_ILLUMINANT1 |
| */ |
| ACAMERA_SENSOR_REFERENCE_ILLUMINANT2 = // byte |
| ACAMERA_SENSOR_START + 4, |
| /** |
| * <p>A per-device calibration transform matrix that maps from the |
| * reference sensor colorspace to the actual device sensor colorspace.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>This matrix is used to correct for per-device variations in the |
| * sensor colorspace, and is used for processing raw buffer data.</p> |
| * <p>The matrix is expressed as a 3x3 matrix in row-major-order, and |
| * contains a per-device calibration transform that maps colors |
| * from reference sensor color space (i.e. the "golden module" |
| * colorspace) into this camera device's native sensor color |
| * space under the first reference illuminant |
| * (ACAMERA_SENSOR_REFERENCE_ILLUMINANT1).</p> |
| * |
| * @see ACAMERA_SENSOR_REFERENCE_ILLUMINANT1 |
| */ |
| ACAMERA_SENSOR_CALIBRATION_TRANSFORM1 = // rational[3*3] |
| ACAMERA_SENSOR_START + 5, |
| /** |
| * <p>A per-device calibration transform matrix that maps from the |
| * reference sensor colorspace to the actual device sensor colorspace |
| * (this is the colorspace of the raw buffer data).</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>This matrix is used to correct for per-device variations in the |
| * sensor colorspace, and is used for processing raw buffer data.</p> |
| * <p>The matrix is expressed as a 3x3 matrix in row-major-order, and |
| * contains a per-device calibration transform that maps colors |
| * from reference sensor color space (i.e. the "golden module" |
| * colorspace) into this camera device's native sensor color |
| * space under the second reference illuminant |
| * (ACAMERA_SENSOR_REFERENCE_ILLUMINANT2).</p> |
| * <p>This matrix will only be present if the second reference |
| * illuminant is present.</p> |
| * |
| * @see ACAMERA_SENSOR_REFERENCE_ILLUMINANT2 |
| */ |
| ACAMERA_SENSOR_CALIBRATION_TRANSFORM2 = // rational[3*3] |
| ACAMERA_SENSOR_START + 6, |
| /** |
| * <p>A matrix that transforms color values from CIE XYZ color space to |
| * reference sensor color space.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>This matrix is used to convert from the standard CIE XYZ color |
| * space to the reference sensor colorspace, and is used when processing |
| * raw buffer data.</p> |
| * <p>The matrix is expressed as a 3x3 matrix in row-major-order, and |
| * contains a color transform matrix that maps colors from the CIE |
| * XYZ color space to the reference sensor color space (i.e. the |
| * "golden module" colorspace) under the first reference illuminant |
| * (ACAMERA_SENSOR_REFERENCE_ILLUMINANT1).</p> |
| * <p>The white points chosen in both the reference sensor color space |
| * and the CIE XYZ colorspace when calculating this transform will |
| * match the standard white point for the first reference illuminant |
| * (i.e. no chromatic adaptation will be applied by this transform).</p> |
| * |
| * @see ACAMERA_SENSOR_REFERENCE_ILLUMINANT1 |
| */ |
| ACAMERA_SENSOR_COLOR_TRANSFORM1 = // rational[3*3] |
| ACAMERA_SENSOR_START + 7, |
| /** |
| * <p>A matrix that transforms color values from CIE XYZ color space to |
| * reference sensor color space.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>This matrix is used to convert from the standard CIE XYZ color |
| * space to the reference sensor colorspace, and is used when processing |
| * raw buffer data.</p> |
| * <p>The matrix is expressed as a 3x3 matrix in row-major-order, and |
| * contains a color transform matrix that maps colors from the CIE |
| * XYZ color space to the reference sensor color space (i.e. the |
| * "golden module" colorspace) under the second reference illuminant |
| * (ACAMERA_SENSOR_REFERENCE_ILLUMINANT2).</p> |
| * <p>The white points chosen in both the reference sensor color space |
| * and the CIE XYZ colorspace when calculating this transform will |
| * match the standard white point for the second reference illuminant |
| * (i.e. no chromatic adaptation will be applied by this transform).</p> |
| * <p>This matrix will only be present if the second reference |
| * illuminant is present.</p> |
| * |
| * @see ACAMERA_SENSOR_REFERENCE_ILLUMINANT2 |
| */ |
| ACAMERA_SENSOR_COLOR_TRANSFORM2 = // rational[3*3] |
| ACAMERA_SENSOR_START + 8, |
| /** |
| * <p>A matrix that transforms white balanced camera colors from the reference |
| * sensor colorspace to the CIE XYZ colorspace with a D50 whitepoint.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>This matrix is used to convert to the standard CIE XYZ colorspace, and |
| * is used when processing raw buffer data.</p> |
| * <p>This matrix is expressed as a 3x3 matrix in row-major-order, and contains |
| * a color transform matrix that maps white balanced colors from the |
| * reference sensor color space to the CIE XYZ color space with a D50 white |
| * point.</p> |
| * <p>Under the first reference illuminant (ACAMERA_SENSOR_REFERENCE_ILLUMINANT1) |
| * this matrix is chosen so that the standard white point for this reference |
| * illuminant in the reference sensor colorspace is mapped to D50 in the |
| * CIE XYZ colorspace.</p> |
| * |
| * @see ACAMERA_SENSOR_REFERENCE_ILLUMINANT1 |
| */ |
| ACAMERA_SENSOR_FORWARD_MATRIX1 = // rational[3*3] |
| ACAMERA_SENSOR_START + 9, |
| /** |
| * <p>A matrix that transforms white balanced camera colors from the reference |
| * sensor colorspace to the CIE XYZ colorspace with a D50 whitepoint.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>This matrix is used to convert to the standard CIE XYZ colorspace, and |
| * is used when processing raw buffer data.</p> |
| * <p>This matrix is expressed as a 3x3 matrix in row-major-order, and contains |
| * a color transform matrix that maps white balanced colors from the |
| * reference sensor color space to the CIE XYZ color space with a D50 white |
| * point.</p> |
| * <p>Under the second reference illuminant (ACAMERA_SENSOR_REFERENCE_ILLUMINANT2) |
| * this matrix is chosen so that the standard white point for this reference |
| * illuminant in the reference sensor colorspace is mapped to D50 in the |
| * CIE XYZ colorspace.</p> |
| * <p>This matrix will only be present if the second reference |
| * illuminant is present.</p> |
| * |
| * @see ACAMERA_SENSOR_REFERENCE_ILLUMINANT2 |
| */ |
| ACAMERA_SENSOR_FORWARD_MATRIX2 = // rational[3*3] |
| ACAMERA_SENSOR_START + 10, |
| /** |
| * <p>A fixed black level offset for each of the color filter arrangement |
| * (CFA) mosaic channels.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>This key specifies the zero light value for each of the CFA mosaic |
| * channels in the camera sensor. The maximal value output by the |
| * sensor is represented by the value in ACAMERA_SENSOR_INFO_WHITE_LEVEL.</p> |
| * <p>The values are given in the same order as channels listed for the CFA |
| * layout key (see ACAMERA_SENSOR_INFO_COLOR_FILTER_ARRANGEMENT), i.e. the |
| * nth value given corresponds to the black level offset for the nth |
| * color channel listed in the CFA.</p> |
| * <p>The black level values of captured images may vary for different |
| * capture settings (e.g., ACAMERA_SENSOR_SENSITIVITY). This key |
| * represents a coarse approximation for such case. It is recommended to |
| * use ACAMERA_SENSOR_DYNAMIC_BLACK_LEVEL or use pixels from |
| * ACAMERA_SENSOR_OPTICAL_BLACK_REGIONS directly for captures when |
| * supported by the camera device, which provides more accurate black |
| * level values. For raw capture in particular, it is recommended to use |
| * pixels from ACAMERA_SENSOR_OPTICAL_BLACK_REGIONS to calculate black |
| * level values for each frame.</p> |
| * |
| * @see ACAMERA_SENSOR_DYNAMIC_BLACK_LEVEL |
| * @see ACAMERA_SENSOR_INFO_COLOR_FILTER_ARRANGEMENT |
| * @see ACAMERA_SENSOR_INFO_WHITE_LEVEL |
| * @see ACAMERA_SENSOR_OPTICAL_BLACK_REGIONS |
| * @see ACAMERA_SENSOR_SENSITIVITY |
| */ |
| ACAMERA_SENSOR_BLACK_LEVEL_PATTERN = // int32[4] |
| ACAMERA_SENSOR_START + 12, |
| /** |
| * <p>Maximum sensitivity that is implemented |
| * purely through analog gain.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>For ACAMERA_SENSOR_SENSITIVITY values less than or |
| * equal to this, all applied gain must be analog. For |
| * values above this, the gain applied can be a mix of analog and |
| * digital.</p> |
| * |
| * @see ACAMERA_SENSOR_SENSITIVITY |
| */ |
| ACAMERA_SENSOR_MAX_ANALOG_SENSITIVITY = // int32 |
| ACAMERA_SENSOR_START + 13, |
| /** |
| * <p>Clockwise angle through which the output image needs to be rotated to be |
| * upright on the device screen in its native orientation.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>Also defines the direction of rolling shutter readout, which is from top to bottom in |
| * the sensor's coordinate system.</p> |
| */ |
| ACAMERA_SENSOR_ORIENTATION = // int32 |
| ACAMERA_SENSOR_START + 14, |
| /** |
| * <p>Time at start of exposure of first |
| * row of the image sensor active array, in nanoseconds.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * </ul> |
| * |
| * <p>The timestamps are also included in all image |
| * buffers produced for the same capture, and will be identical |
| * on all the outputs.</p> |
| * <p>When ACAMERA_SENSOR_INFO_TIMESTAMP_SOURCE <code>==</code> UNKNOWN, |
| * the timestamps measure time since an unspecified starting point, |
| * and are monotonically increasing. They can be compared with the |
| * timestamps for other captures from the same camera device, but are |
| * not guaranteed to be comparable to any other time source.</p> |
| * <p>When ACAMERA_SENSOR_INFO_TIMESTAMP_SOURCE <code>==</code> REALTIME, the |
| * timestamps measure time in the same timebase as |
| * <a href="https://developer.android.com/reference/android/os/SystemClock.html#elapsedRealtimeNanos">elapsedRealtimeNanos</a> |
| * (or CLOCK_BOOTTIME), and they can |
| * be compared to other timestamps from other subsystems that |
| * are using that base.</p> |
| * <p>For reprocessing, the timestamp will match the start of exposure of |
| * the input image, i.e. {@link CaptureResult#SENSOR_TIMESTAMP the |
| * timestamp} in the TotalCaptureResult that was used to create the |
| * reprocess capture request.</p> |
| * |
| * @see ACAMERA_SENSOR_INFO_TIMESTAMP_SOURCE |
| */ |
| ACAMERA_SENSOR_TIMESTAMP = // int64 |
| ACAMERA_SENSOR_START + 16, |
| /** |
| * <p>The estimated camera neutral color in the native sensor colorspace at |
| * the time of capture.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * </ul> |
| * |
| * <p>This value gives the neutral color point encoded as an RGB value in the |
| * native sensor color space. The neutral color point indicates the |
| * currently estimated white point of the scene illumination. It can be |
| * used to interpolate between the provided color transforms when |
| * processing raw sensor data.</p> |
| * <p>The order of the values is R, G, B; where R is in the lowest index.</p> |
| */ |
| ACAMERA_SENSOR_NEUTRAL_COLOR_POINT = // rational[3] |
| ACAMERA_SENSOR_START + 18, |
| /** |
| * <p>Noise model coefficients for each CFA mosaic channel.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * </ul> |
| * |
| * <p>This key contains two noise model coefficients for each CFA channel |
| * corresponding to the sensor amplification (S) and sensor readout |
| * noise (O). These are given as pairs of coefficients for each channel |
| * in the same order as channels listed for the CFA layout key |
| * (see ACAMERA_SENSOR_INFO_COLOR_FILTER_ARRANGEMENT). This is |
| * represented as an array of Pair<Double, Double>, where |
| * the first member of the Pair at index n is the S coefficient and the |
| * second member is the O coefficient for the nth color channel in the CFA.</p> |
| * <p>These coefficients are used in a two parameter noise model to describe |
| * the amount of noise present in the image for each CFA channel. The |
| * noise model used here is:</p> |
| * <p>N(x) = sqrt(Sx + O)</p> |
| * <p>Where x represents the recorded signal of a CFA channel normalized to |
| * the range [0, 1], and S and O are the noise model coeffiecients for |
| * that channel.</p> |
| * <p>A more detailed description of the noise model can be found in the |
| * Adobe DNG specification for the NoiseProfile tag.</p> |
| * |
| * @see ACAMERA_SENSOR_INFO_COLOR_FILTER_ARRANGEMENT |
| */ |
| ACAMERA_SENSOR_NOISE_PROFILE = // double[2*CFA Channels] |
| ACAMERA_SENSOR_START + 19, |
| /** |
| * <p>The worst-case divergence between Bayer green channels.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * </ul> |
| * |
| * <p>This value is an estimate of the worst case split between the |
| * Bayer green channels in the red and blue rows in the sensor color |
| * filter array.</p> |
| * <p>The green split is calculated as follows:</p> |
| * <ol> |
| * <li>A 5x5 pixel (or larger) window W within the active sensor array is |
| * chosen. The term 'pixel' here is taken to mean a group of 4 Bayer |
| * mosaic channels (R, Gr, Gb, B). The location and size of the window |
| * chosen is implementation defined, and should be chosen to provide a |
| * green split estimate that is both representative of the entire image |
| * for this camera sensor, and can be calculated quickly.</li> |
| * <li>The arithmetic mean of the green channels from the red |
| * rows (mean_Gr) within W is computed.</li> |
| * <li>The arithmetic mean of the green channels from the blue |
| * rows (mean_Gb) within W is computed.</li> |
| * <li>The maximum ratio R of the two means is computed as follows: |
| * <code>R = max((mean_Gr + 1)/(mean_Gb + 1), (mean_Gb + 1)/(mean_Gr + 1))</code></li> |
| * </ol> |
| * <p>The ratio R is the green split divergence reported for this property, |
| * which represents how much the green channels differ in the mosaic |
| * pattern. This value is typically used to determine the treatment of |
| * the green mosaic channels when demosaicing.</p> |
| * <p>The green split value can be roughly interpreted as follows:</p> |
| * <ul> |
| * <li>R < 1.03 is a negligible split (<3% divergence).</li> |
| * <li>1.20 <= R >= 1.03 will require some software |
| * correction to avoid demosaic errors (3-20% divergence).</li> |
| * <li>R > 1.20 will require strong software correction to produce |
| * a usuable image (>20% divergence).</li> |
| * </ul> |
| */ |
| ACAMERA_SENSOR_GREEN_SPLIT = // float |
| ACAMERA_SENSOR_START + 22, |
| /** |
| * <p>A pixel <code>[R, G_even, G_odd, B]</code> that supplies the test pattern |
| * when ACAMERA_SENSOR_TEST_PATTERN_MODE is SOLID_COLOR.</p> |
| * |
| * @see ACAMERA_SENSOR_TEST_PATTERN_MODE |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>Each color channel is treated as an unsigned 32-bit integer. |
| * The camera device then uses the most significant X bits |
| * that correspond to how many bits are in its Bayer raw sensor |
| * output.</p> |
| * <p>For example, a sensor with RAW10 Bayer output would use the |
| * 10 most significant bits from each color channel.</p> |
| */ |
| ACAMERA_SENSOR_TEST_PATTERN_DATA = // int32[4] |
| ACAMERA_SENSOR_START + 23, |
| /** |
| * <p>When enabled, the sensor sends a test pattern instead of |
| * doing a real exposure from the camera.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * <li>ACaptureRequest</li> |
| * </ul> |
| * |
| * <p>When a test pattern is enabled, all manual sensor controls specified |
| * by ACAMERA_SENSOR_* will be ignored. All other controls should |
| * work as normal.</p> |
| * <p>For example, if manual flash is enabled, flash firing should still |
| * occur (and that the test pattern remain unmodified, since the flash |
| * would not actually affect it).</p> |
| * <p>Defaults to OFF.</p> |
| */ |
| ACAMERA_SENSOR_TEST_PATTERN_MODE = // int32 (enum) |
| ACAMERA_SENSOR_START + 24, |
| /** |
| * <p>List of sensor test pattern modes for ACAMERA_SENSOR_TEST_PATTERN_MODE |
| * supported by this camera device.</p> |
| * |
| * @see ACAMERA_SENSOR_TEST_PATTERN_MODE |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>Defaults to OFF, and always includes OFF if defined.</p> |
| */ |
| ACAMERA_SENSOR_AVAILABLE_TEST_PATTERN_MODES = // int32[n] |
| ACAMERA_SENSOR_START + 25, |
| /** |
| * <p>Duration between the start of first row exposure |
| * and the start of last row exposure.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * </ul> |
| * |
| * <p>This is the exposure time skew between the first and last |
| * row exposure start times. The first row and the last row are |
| * the first and last rows inside of the |
| * ACAMERA_SENSOR_INFO_ACTIVE_ARRAY_SIZE.</p> |
| * <p>For typical camera sensors that use rolling shutters, this is also equivalent |
| * to the frame readout time.</p> |
| * |
| * @see ACAMERA_SENSOR_INFO_ACTIVE_ARRAY_SIZE |
| */ |
| ACAMERA_SENSOR_ROLLING_SHUTTER_SKEW = // int64 |
| ACAMERA_SENSOR_START + 26, |
| /** |
| * <p>List of disjoint rectangles indicating the sensor |
| * optically shielded black pixel regions.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>In most camera sensors, the active array is surrounded by some |
| * optically shielded pixel areas. By blocking light, these pixels |
| * provides a reliable black reference for black level compensation |
| * in active array region.</p> |
| * <p>The data representation is int[4], which maps to (left, top, width, height).</p> |
| * <p>This key provides a list of disjoint rectangles specifying the |
| * regions of optically shielded (with metal shield) black pixel |
| * regions if the camera device is capable of reading out these black |
| * pixels in the output raw images. In comparison to the fixed black |
| * level values reported by ACAMERA_SENSOR_BLACK_LEVEL_PATTERN, this key |
| * may provide a more accurate way for the application to calculate |
| * black level of each captured raw images.</p> |
| * <p>When this key is reported, the ACAMERA_SENSOR_DYNAMIC_BLACK_LEVEL and |
| * ACAMERA_SENSOR_DYNAMIC_WHITE_LEVEL will also be reported.</p> |
| * |
| * @see ACAMERA_SENSOR_BLACK_LEVEL_PATTERN |
| * @see ACAMERA_SENSOR_DYNAMIC_BLACK_LEVEL |
| * @see ACAMERA_SENSOR_DYNAMIC_WHITE_LEVEL |
| */ |
| ACAMERA_SENSOR_OPTICAL_BLACK_REGIONS = // int32[4*num_regions] |
| ACAMERA_SENSOR_START + 27, |
| /** |
| * <p>A per-frame dynamic black level offset for each of the color filter |
| * arrangement (CFA) mosaic channels.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * </ul> |
| * |
| * <p>Camera sensor black levels may vary dramatically for different |
| * capture settings (e.g. ACAMERA_SENSOR_SENSITIVITY). The fixed black |
| * level reported by ACAMERA_SENSOR_BLACK_LEVEL_PATTERN may be too |
| * inaccurate to represent the actual value on a per-frame basis. The |
| * camera device internal pipeline relies on reliable black level values |
| * to process the raw images appropriately. To get the best image |
| * quality, the camera device may choose to estimate the per frame black |
| * level values either based on optically shielded black regions |
| * (ACAMERA_SENSOR_OPTICAL_BLACK_REGIONS) or its internal model.</p> |
| * <p>This key reports the camera device estimated per-frame zero light |
| * value for each of the CFA mosaic channels in the camera sensor. The |
| * ACAMERA_SENSOR_BLACK_LEVEL_PATTERN may only represent a coarse |
| * approximation of the actual black level values. This value is the |
| * black level used in camera device internal image processing pipeline |
| * and generally more accurate than the fixed black level values. |
| * However, since they are estimated values by the camera device, they |
| * may not be as accurate as the black level values calculated from the |
| * optical black pixels reported by ACAMERA_SENSOR_OPTICAL_BLACK_REGIONS.</p> |
| * <p>The values are given in the same order as channels listed for the CFA |
| * layout key (see ACAMERA_SENSOR_INFO_COLOR_FILTER_ARRANGEMENT), i.e. the |
| * nth value given corresponds to the black level offset for the nth |
| * color channel listed in the CFA.</p> |
| * <p>This key will be available if ACAMERA_SENSOR_OPTICAL_BLACK_REGIONS is |
| * available or the camera device advertises this key via |
| * {@link ACAMERA_REQUEST_AVAILABLE_RESULT_KEYS}.</p> |
| * |
| * @see ACAMERA_SENSOR_BLACK_LEVEL_PATTERN |
| * @see ACAMERA_SENSOR_INFO_COLOR_FILTER_ARRANGEMENT |
| * @see ACAMERA_SENSOR_OPTICAL_BLACK_REGIONS |
| * @see ACAMERA_SENSOR_SENSITIVITY |
| */ |
| ACAMERA_SENSOR_DYNAMIC_BLACK_LEVEL = // float[4] |
| ACAMERA_SENSOR_START + 28, |
| /** |
| * <p>Maximum raw value output by sensor for this frame.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraCaptureSession_captureCallback_result callbacks</li> |
| * </ul> |
| * |
| * <p>Since the ACAMERA_SENSOR_BLACK_LEVEL_PATTERN may change for different |
| * capture settings (e.g., ACAMERA_SENSOR_SENSITIVITY), the white |
| * level will change accordingly. This key is similar to |
| * ACAMERA_SENSOR_INFO_WHITE_LEVEL, but specifies the camera device |
| * estimated white level for each frame.</p> |
| * <p>This key will be available if ACAMERA_SENSOR_OPTICAL_BLACK_REGIONS is |
| * available or the camera device advertises this key via |
| * {@link ACAMERA_REQUEST_AVAILABLE_RESULT_KEYS}.</p> |
| * |
| * @see ACAMERA_SENSOR_BLACK_LEVEL_PATTERN |
| * @see ACAMERA_SENSOR_INFO_WHITE_LEVEL |
| * @see ACAMERA_SENSOR_OPTICAL_BLACK_REGIONS |
| * @see ACAMERA_SENSOR_SENSITIVITY |
| */ |
| ACAMERA_SENSOR_DYNAMIC_WHITE_LEVEL = // int32 |
| ACAMERA_SENSOR_START + 29, |
| ACAMERA_SENSOR_END, |
| |
| /** |
| * <p>The area of the image sensor which corresponds to active pixels after any geometric |
| * distortion correction has been applied.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>This is the rectangle representing the size of the active region of the sensor (i.e. |
| * the region that actually receives light from the scene) after any geometric correction |
| * has been applied, and should be treated as the maximum size in pixels of any of the |
| * image output formats aside from the raw formats.</p> |
| * <p>This rectangle is defined relative to the full pixel array; (0,0) is the top-left of |
| * the full pixel array, and the size of the full pixel array is given by |
| * ACAMERA_SENSOR_INFO_PIXEL_ARRAY_SIZE.</p> |
| * <p>The data representation is int[4], which maps to (left, top, width, height).</p> |
| * <p>The coordinate system for most other keys that list pixel coordinates, including |
| * ACAMERA_SCALER_CROP_REGION, is defined relative to the active array rectangle given in |
| * this field, with <code>(0, 0)</code> being the top-left of this rectangle.</p> |
| * <p>The active array may be smaller than the full pixel array, since the full array may |
| * include black calibration pixels or other inactive regions, and geometric correction |
| * resulting in scaling or cropping may have been applied.</p> |
| * |
| * @see ACAMERA_SCALER_CROP_REGION |
| * @see ACAMERA_SENSOR_INFO_PIXEL_ARRAY_SIZE |
| */ |
| ACAMERA_SENSOR_INFO_ACTIVE_ARRAY_SIZE = // int32[4] |
| ACAMERA_SENSOR_INFO_START, |
| /** |
| * <p>Range of sensitivities for ACAMERA_SENSOR_SENSITIVITY supported by this |
| * camera device.</p> |
| * |
| * @see ACAMERA_SENSOR_SENSITIVITY |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>The values are the standard ISO sensitivity values, |
| * as defined in ISO 12232:2006.</p> |
| */ |
| ACAMERA_SENSOR_INFO_SENSITIVITY_RANGE = // int32[2] |
| ACAMERA_SENSOR_INFO_START + 1, |
| /** |
| * <p>The arrangement of color filters on sensor; |
| * represents the colors in the top-left 2x2 section of |
| * the sensor, in reading order.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>None</p> |
| */ |
| ACAMERA_SENSOR_INFO_COLOR_FILTER_ARRANGEMENT = // byte (enum) |
| ACAMERA_SENSOR_INFO_START + 2, |
| /** |
| * <p>The range of image exposure times for ACAMERA_SENSOR_EXPOSURE_TIME supported |
| * by this camera device.</p> |
| * |
| * @see ACAMERA_SENSOR_EXPOSURE_TIME |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>None</p> |
| */ |
| ACAMERA_SENSOR_INFO_EXPOSURE_TIME_RANGE = // int64[2] |
| ACAMERA_SENSOR_INFO_START + 3, |
| /** |
| * <p>The maximum possible frame duration (minimum frame rate) for |
| * ACAMERA_SENSOR_FRAME_DURATION that is supported this camera device.</p> |
| * |
| * @see ACAMERA_SENSOR_FRAME_DURATION |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>Attempting to use frame durations beyond the maximum will result in the frame |
| * duration being clipped to the maximum. See that control for a full definition of frame |
| * durations.</p> |
| * <p>Refer to {@link |
| * ACAMERA_SCALER_AVAILABLE_MIN_FRAME_DURATIONS} |
| * for the minimum frame duration values.</p> |
| */ |
| ACAMERA_SENSOR_INFO_MAX_FRAME_DURATION = // int64 |
| ACAMERA_SENSOR_INFO_START + 4, |
| /** |
| * <p>The physical dimensions of the full pixel |
| * array.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>This is the physical size of the sensor pixel |
| * array defined by ACAMERA_SENSOR_INFO_PIXEL_ARRAY_SIZE.</p> |
| * |
| * @see ACAMERA_SENSOR_INFO_PIXEL_ARRAY_SIZE |
| */ |
| ACAMERA_SENSOR_INFO_PHYSICAL_SIZE = // float[2] |
| ACAMERA_SENSOR_INFO_START + 5, |
| /** |
| * <p>Dimensions of the full pixel array, possibly |
| * including black calibration pixels.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>The pixel count of the full pixel array of the image sensor, which covers |
| * ACAMERA_SENSOR_INFO_PHYSICAL_SIZE area. This represents the full pixel dimensions of |
| * the raw buffers produced by this sensor.</p> |
| * <p>If a camera device supports raw sensor formats, either this or |
| * ACAMERA_SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE is the maximum dimensions for the raw |
| * output formats listed in ACAMERA_SCALER_AVAILABLE_STREAM_CONFIGURATIONS (this depends on |
| * whether or not the image sensor returns buffers containing pixels that are not |
| * part of the active array region for blacklevel calibration or other purposes).</p> |
| * <p>Some parts of the full pixel array may not receive light from the scene, |
| * or be otherwise inactive. The ACAMERA_SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE key |
| * defines the rectangle of active pixels that will be included in processed image |
| * formats.</p> |
| * |
| * @see ACAMERA_SENSOR_INFO_PHYSICAL_SIZE |
| * @see ACAMERA_SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE |
| */ |
| ACAMERA_SENSOR_INFO_PIXEL_ARRAY_SIZE = // int32[2] |
| ACAMERA_SENSOR_INFO_START + 6, |
| /** |
| * <p>Maximum raw value output by sensor.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>This specifies the fully-saturated encoding level for the raw |
| * sample values from the sensor. This is typically caused by the |
| * sensor becoming highly non-linear or clipping. The minimum for |
| * each channel is specified by the offset in the |
| * ACAMERA_SENSOR_BLACK_LEVEL_PATTERN key.</p> |
| * <p>The white level is typically determined either by sensor bit depth |
| * (8-14 bits is expected), or by the point where the sensor response |
| * becomes too non-linear to be useful. The default value for this is |
| * maximum representable value for a 16-bit raw sample (2^16 - 1).</p> |
| * <p>The white level values of captured images may vary for different |
| * capture settings (e.g., ACAMERA_SENSOR_SENSITIVITY). This key |
| * represents a coarse approximation for such case. It is recommended |
| * to use ACAMERA_SENSOR_DYNAMIC_WHITE_LEVEL for captures when supported |
| * by the camera device, which provides more accurate white level values.</p> |
| * |
| * @see ACAMERA_SENSOR_BLACK_LEVEL_PATTERN |
| * @see ACAMERA_SENSOR_DYNAMIC_WHITE_LEVEL |
| * @see ACAMERA_SENSOR_SENSITIVITY |
| */ |
| ACAMERA_SENSOR_INFO_WHITE_LEVEL = // int32 |
| ACAMERA_SENSOR_INFO_START + 7, |
| /** |
| * <p>The time base source for sensor capture start timestamps.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>The timestamps provided for captures are always in nanoseconds and monotonic, but |
| * may not based on a time source that can be compared to other system time sources.</p> |
| * <p>This characteristic defines the source for the timestamps, and therefore whether they |
| * can be compared against other system time sources/timestamps.</p> |
| */ |
| ACAMERA_SENSOR_INFO_TIMESTAMP_SOURCE = // byte (enum) |
| ACAMERA_SENSOR_INFO_START + 8, |
| /** |
| * <p>Whether the RAW images output from this camera device are subject to |
| * lens shading correction.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>If TRUE, all images produced by the camera device in the RAW image formats will |
| * have lens shading correction already applied to it. If FALSE, the images will |
| * not be adjusted for lens shading correction. |
| * See android.request.maxNumOutputRaw for a list of RAW image formats.</p> |
| * <p>This key will be <code>null</code> for all devices do not report this information. |
| * Devices with RAW capability will always report this information in this key.</p> |
| */ |
| ACAMERA_SENSOR_INFO_LENS_SHADING_APPLIED = // byte (enum) |
| ACAMERA_SENSOR_INFO_START + 9, |
| /** |
| * <p>The area of the image sensor which corresponds to active pixels prior to the |
| * application of any geometric distortion correction.</p> |
| * |
| * <p>This tag may appear in:</p> |
| * <ul> |
| * <li>ACameraMetadata from ACameraManager_getCameraCharacteristics</li> |
| * </ul> |
| * |
| * <p>The data representation is int[4], which maps to (left, top, width, height).</p> |
| * <p>This is the rectangle representing the size of the active region of the sensor (i.e. |
| * the region that actually receives light from the scene) before any geometric correction |
| * has been applied, and should be treated as the active region rectangle for any of the |
| * raw formats. All metadata associated with raw processing (e.g. the lens shading |
| * correction map, and radial distortion fields) treats the top, left of this rectangle as |
| * the origin, (0,0).</p> |
|
