Parameters.h revision ec7710898208162576c3242f5a590651ab42aa2d
12e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala/* 22e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala * Copyright (C) 2012 The Android Open Source Project 32e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala * 42e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala * Licensed under the Apache License, Version 2.0 (the "License"); 52e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala * you may not use this file except in compliance with the License. 62e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala * You may obtain a copy of the License at 72e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala * 82e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala * http://www.apache.org/licenses/LICENSE-2.0 92e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala * 102e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala * Unless required by applicable law or agreed to in writing, software 112e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala * distributed under the License is distributed on an "AS IS" BASIS, 122e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 132e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala * See the License for the specific language governing permissions and 142e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala * limitations under the License. 152e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala */ 162e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 172e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala#ifndef ANDROID_SERVERS_CAMERA_CAMERA2PARAMETERS_H 182e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala#define ANDROID_SERVERS_CAMERA_CAMERA2PARAMETERS_H 192e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 202e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala#include <system/graphics.h> 212e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 222e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala#include <utils/Errors.h> 232e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala#include <utils/Mutex.h> 242e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala#include <utils/String8.h> 252e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala#include <utils/Vector.h> 268a42dd8cd1a245d844f96cfd67dc342d7937e353Eino-Ville Talvala#include <utils/KeyedVector.h> 278a42dd8cd1a245d844f96cfd67dc342d7937e353Eino-Ville Talvala#include <camera/CameraParameters.h> 282e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 292e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala#include "CameraMetadata.h" 302e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 312e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvalanamespace android { 322e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvalanamespace camera2 { 332e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 34da6665cbd06ca58d3357c3002b7366d13e23f152Eino-Ville Talvala/** 35da6665cbd06ca58d3357c3002b7366d13e23f152Eino-Ville Talvala * Current camera state; this is the full state of the Camera under the old 36da6665cbd06ca58d3357c3002b7366d13e23f152Eino-Ville Talvala * camera API (contents of the CameraParameters object in a more-efficient 37da6665cbd06ca58d3357c3002b7366d13e23f152Eino-Ville Talvala * format, plus other state). The enum values are mostly based off the 38da6665cbd06ca58d3357c3002b7366d13e23f152Eino-Ville Talvala * corresponding camera2 enums, not the camera1 strings. A few are defined here 39da6665cbd06ca58d3357c3002b7366d13e23f152Eino-Ville Talvala * if they don't cleanly map to camera2 values. 40da6665cbd06ca58d3357c3002b7366d13e23f152Eino-Ville Talvala */ 412e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvalastruct Parameters { 42da6665cbd06ca58d3357c3002b7366d13e23f152Eino-Ville Talvala /** 43da6665cbd06ca58d3357c3002b7366d13e23f152Eino-Ville Talvala * Parameters and other state 44da6665cbd06ca58d3357c3002b7366d13e23f152Eino-Ville Talvala */ 452e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala int cameraId; 462e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala int cameraFacing; 472e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 482e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala int previewWidth, previewHeight; 492e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala int32_t previewFpsRange[2]; 502e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala int previewFps; // deprecated, here only for tracking changes 512e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala int previewFormat; 522e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 532e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala int previewTransform; // set by CAMERA_CMD_SET_DISPLAY_ORIENTATION 542e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 552e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala int pictureWidth, pictureHeight; 562e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 572e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala int32_t jpegThumbSize[2]; 582e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala int32_t jpegQuality, jpegThumbQuality; 592e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala int32_t jpegRotation; 602e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 612e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala bool gpsEnabled; 622e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala double gpsCoordinates[3]; 632e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala int64_t gpsTimestamp; 642e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala String8 gpsProcessingMethod; 652e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 662e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala uint8_t wbMode; 672e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala uint8_t effectMode; 682e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala uint8_t antibandingMode; 692e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala uint8_t sceneMode; 702e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 712e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala enum flashMode_t { 722e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala FLASH_MODE_OFF = 0, 732e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala FLASH_MODE_AUTO, 742e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala FLASH_MODE_ON, 752e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala FLASH_MODE_TORCH, 762e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala FLASH_MODE_RED_EYE = ANDROID_CONTROL_AE_ON_AUTO_FLASH_REDEYE, 772e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala FLASH_MODE_INVALID = -1 782e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala } flashMode; 792e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 802e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala enum focusMode_t { 812e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala FOCUS_MODE_AUTO = ANDROID_CONTROL_AF_AUTO, 822e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala FOCUS_MODE_MACRO = ANDROID_CONTROL_AF_MACRO, 832e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala FOCUS_MODE_CONTINUOUS_VIDEO = ANDROID_CONTROL_AF_CONTINUOUS_VIDEO, 842e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala FOCUS_MODE_CONTINUOUS_PICTURE = ANDROID_CONTROL_AF_CONTINUOUS_PICTURE, 852e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala FOCUS_MODE_EDOF = ANDROID_CONTROL_AF_EDOF, 862e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala FOCUS_MODE_INFINITY, 872e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala FOCUS_MODE_FIXED, 882e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala FOCUS_MODE_INVALID = -1 892e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala } focusMode; 902e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 912e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala struct Area { 922e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala int left, top, right, bottom; 932e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala int weight; 942e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala Area() {} 952e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala Area(int left, int top, int right, int bottom, int weight): 962e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala left(left), top(top), right(right), bottom(bottom), 972e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala weight(weight) {} 982e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala }; 992e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala Vector<Area> focusingAreas; 1002e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 1012e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala int32_t exposureCompensation; 1022e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala bool autoExposureLock; 1032e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala bool autoWhiteBalanceLock; 1042e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 1052e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala Vector<Area> meteringAreas; 1062e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 1072e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala int zoom; 1082e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 1092e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala int videoWidth, videoHeight; 1102e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 1112e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala bool recordingHint; 1122e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala bool videoStabilization; 1132e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 114e538206d15282afbc5b168d60b1026a5dfcd13c0James Painter enum lightFxMode_t { 115e538206d15282afbc5b168d60b1026a5dfcd13c0James Painter LIGHTFX_NONE = 0, 116e538206d15282afbc5b168d60b1026a5dfcd13c0James Painter LIGHTFX_LOWLIGHT, 117e538206d15282afbc5b168d60b1026a5dfcd13c0James Painter LIGHTFX_HDR 118e538206d15282afbc5b168d60b1026a5dfcd13c0James Painter } lightFx; 119e538206d15282afbc5b168d60b1026a5dfcd13c0James Painter 1208a42dd8cd1a245d844f96cfd67dc342d7937e353Eino-Ville Talvala CameraParameters params; 1212e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala String8 paramsFlattened; 1222e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 1232e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala // These parameters are also part of the camera API-visible state, but not 1242e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala // directly listed in Camera.Parameters 1252e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala bool storeMetadataInBuffers; 1262e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala bool playShutterSound; 1272e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala bool enableFaceDetect; 1282e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 1292e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala bool enableFocusMoveMessages; 1302e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala int afTriggerCounter; 1312e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala int currentAfTriggerId; 1322e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala bool afInMotion; 1332e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 134da6665cbd06ca58d3357c3002b7366d13e23f152Eino-Ville Talvala int precaptureTriggerCounter; 135da6665cbd06ca58d3357c3002b7366d13e23f152Eino-Ville Talvala 1362e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala uint32_t previewCallbackFlags; 1372e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala bool previewCallbackOneShot; 1382e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 139da6665cbd06ca58d3357c3002b7366d13e23f152Eino-Ville Talvala bool zslMode; 140da6665cbd06ca58d3357c3002b7366d13e23f152Eino-Ville Talvala 1412e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala // Overall camera state 1422e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala enum State { 1432e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala DISCONNECTED, 1442e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala STOPPED, 1452e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala WAITING_FOR_PREVIEW_WINDOW, 1462e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala PREVIEW, 1472e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala RECORD, 1482e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala STILL_CAPTURE, 1492e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala VIDEO_SNAPSHOT 1502e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala } state; 1512e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 1522e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala // Number of zoom steps to simulate 153161fac83b369f4873859a101b6a71efeb596bd4aEino-Ville Talvala static const unsigned int NUM_ZOOM_STEPS = 30; 1542e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 1552e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala // Full static camera info, object owned by someone else, such as 1562e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala // Camera2Device. 1572e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala const CameraMetadata *info; 1582e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 1592e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala // Fast-access static device information; this is a subset of the 1602e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala // information available through the staticInfo() method, used for 1612e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala // frequently-accessed values or values that have to be calculated from the 1622e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala // static information. 1632e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala struct DeviceInfo { 1642e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala int32_t arrayWidth; 1652e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala int32_t arrayHeight; 1662e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala uint8_t bestFaceDetectMode; 1672e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala int32_t maxFaces; 1688a42dd8cd1a245d844f96cfd67dc342d7937e353Eino-Ville Talvala struct OverrideModes { 1698a42dd8cd1a245d844f96cfd67dc342d7937e353Eino-Ville Talvala flashMode_t flashMode; 1708a42dd8cd1a245d844f96cfd67dc342d7937e353Eino-Ville Talvala uint8_t wbMode; 1718a42dd8cd1a245d844f96cfd67dc342d7937e353Eino-Ville Talvala focusMode_t focusMode; 1728a42dd8cd1a245d844f96cfd67dc342d7937e353Eino-Ville Talvala OverrideModes(): 1738a42dd8cd1a245d844f96cfd67dc342d7937e353Eino-Ville Talvala flashMode(FLASH_MODE_INVALID), 1748a42dd8cd1a245d844f96cfd67dc342d7937e353Eino-Ville Talvala wbMode(ANDROID_CONTROL_AWB_OFF), 1758a42dd8cd1a245d844f96cfd67dc342d7937e353Eino-Ville Talvala focusMode(FOCUS_MODE_INVALID) { 1768a42dd8cd1a245d844f96cfd67dc342d7937e353Eino-Ville Talvala } 1778a42dd8cd1a245d844f96cfd67dc342d7937e353Eino-Ville Talvala }; 1788a42dd8cd1a245d844f96cfd67dc342d7937e353Eino-Ville Talvala DefaultKeyedVector<uint8_t, OverrideModes> sceneModeOverrides; 1792e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala } fastInfo; 1802e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 1818a42dd8cd1a245d844f96cfd67dc342d7937e353Eino-Ville Talvala // Quirks information; these are short-lived flags to enable workarounds for 1828a42dd8cd1a245d844f96cfd67dc342d7937e353Eino-Ville Talvala // incomplete HAL implementations 1838a42dd8cd1a245d844f96cfd67dc342d7937e353Eino-Ville Talvala struct Quirks { 1848a42dd8cd1a245d844f96cfd67dc342d7937e353Eino-Ville Talvala bool triggerAfWithAuto; 1858a42dd8cd1a245d844f96cfd67dc342d7937e353Eino-Ville Talvala bool useZslFormat; 1868a42dd8cd1a245d844f96cfd67dc342d7937e353Eino-Ville Talvala } quirks; 1878a42dd8cd1a245d844f96cfd67dc342d7937e353Eino-Ville Talvala 188da6665cbd06ca58d3357c3002b7366d13e23f152Eino-Ville Talvala /** 189da6665cbd06ca58d3357c3002b7366d13e23f152Eino-Ville Talvala * Parameter manipulation and setup methods 190da6665cbd06ca58d3357c3002b7366d13e23f152Eino-Ville Talvala */ 1912e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 1922e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala Parameters(int cameraId, int cameraFacing); 1932e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala ~Parameters(); 1942e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 1952e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala // Sets up default parameters 1962e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala status_t initialize(const CameraMetadata *info); 1972e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 198e382ee28709b83264a46b09e8f766c5ef42efa35Eino-Ville Talvala // Build fast-access device static info from static info 1992e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala status_t buildFastInfo(); 200e382ee28709b83264a46b09e8f766c5ef42efa35Eino-Ville Talvala // Query for quirks from static info 201e382ee28709b83264a46b09e8f766c5ef42efa35Eino-Ville Talvala status_t buildQuirks(); 2022e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 2032e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala // Get entry from camera static characteristics information. min/maxCount 2042e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala // are used for error checking the number of values in the entry. 0 for 2052e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala // max/minCount means to do no bounds check in that direction. In case of 2062e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala // error, the entry data pointer is null and the count is 0. 2072e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala camera_metadata_ro_entry_t staticInfo(uint32_t tag, 2082e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala size_t minCount=0, size_t maxCount=0) const; 2092e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 2102e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala // Validate and update camera parameters based on new settings 2118a42dd8cd1a245d844f96cfd67dc342d7937e353Eino-Ville Talvala status_t set(const String8 ¶mString); 2128a42dd8cd1a245d844f96cfd67dc342d7937e353Eino-Ville Talvala 2138a42dd8cd1a245d844f96cfd67dc342d7937e353Eino-Ville Talvala // Retrieve the current settings 2148a42dd8cd1a245d844f96cfd67dc342d7937e353Eino-Ville Talvala String8 get() const; 2152e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 216da6665cbd06ca58d3357c3002b7366d13e23f152Eino-Ville Talvala // Update passed-in request for common parameters 217da6665cbd06ca58d3357c3002b7366d13e23f152Eino-Ville Talvala status_t updateRequest(CameraMetadata *request) const; 218da6665cbd06ca58d3357c3002b7366d13e23f152Eino-Ville Talvala 219ec7710898208162576c3242f5a590651ab42aa2dEino-Ville Talvala // Add/update JPEG entries in metadata 220ec7710898208162576c3242f5a590651ab42aa2dEino-Ville Talvala status_t updateRequestJpeg(CameraMetadata *request) const; 221ec7710898208162576c3242f5a590651ab42aa2dEino-Ville Talvala 222018d228ac43a8da7d5f36e45fd105c9baf2490a0Igor Murashkin // Calculate the crop region rectangle based on current stream sizes 223018d228ac43a8da7d5f36e45fd105c9baf2490a0Igor Murashkin struct CropRegion { 224018d228ac43a8da7d5f36e45fd105c9baf2490a0Igor Murashkin float left; 225018d228ac43a8da7d5f36e45fd105c9baf2490a0Igor Murashkin float top; 226018d228ac43a8da7d5f36e45fd105c9baf2490a0Igor Murashkin float width; 227018d228ac43a8da7d5f36e45fd105c9baf2490a0Igor Murashkin float height; 228018d228ac43a8da7d5f36e45fd105c9baf2490a0Igor Murashkin }; 229018d228ac43a8da7d5f36e45fd105c9baf2490a0Igor Murashkin CropRegion calculateCropRegion(void) const; 230018d228ac43a8da7d5f36e45fd105c9baf2490a0Igor Murashkin 2312e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala // Static methods for debugging and converting between camera1 and camera2 2322e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala // parameters 2332e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 2342e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala static const char *getStateName(State state); 2352e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 2362e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala static int formatStringToEnum(const char *format); 2372e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala static const char *formatEnumToString(int format); 2382e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 2392e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala static int wbModeStringToEnum(const char *wbMode); 2408a42dd8cd1a245d844f96cfd67dc342d7937e353Eino-Ville Talvala static const char* wbModeEnumToString(uint8_t wbMode); 2412e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala static int effectModeStringToEnum(const char *effectMode); 2422e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala static int abModeStringToEnum(const char *abMode); 2432e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala static int sceneModeStringToEnum(const char *sceneMode); 2442e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala static flashMode_t flashModeStringToEnum(const char *flashMode); 2458a42dd8cd1a245d844f96cfd67dc342d7937e353Eino-Ville Talvala static const char* flashModeEnumToString(flashMode_t flashMode); 2462e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala static focusMode_t focusModeStringToEnum(const char *focusMode); 2478a42dd8cd1a245d844f96cfd67dc342d7937e353Eino-Ville Talvala static const char* focusModeEnumToString(focusMode_t focusMode); 2482e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala static status_t parseAreas(const char *areasCStr, 2492e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala Vector<Area> *areas); 2502e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala static status_t validateAreas(const Vector<Area> &areas, 2512e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala size_t maxRegions); 2522e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala static bool boolFromString(const char *boolStr); 2532e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 2542e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala // Map from camera orientation + facing to gralloc transform enum 2552e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala static int degToTransform(int degrees, bool mirror); 2562e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 257d0cec0cb574a3d629afb7c32883bc986d7a65535Eino-Ville Talvala // API specifies FPS ranges are done in fixed point integer, with LSB = 0.001. 258d0cec0cb574a3d629afb7c32883bc986d7a65535Eino-Ville Talvala // Note that this doesn't apply to the (deprecated) single FPS value. 259c9d7e4da3f963dadbea19e9b520fb7a7e28e614aEino-Ville Talvala static const int kFpsToApiScale = 1000; 260c9d7e4da3f963dadbea19e9b520fb7a7e28e614aEino-Ville Talvala 2612e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala // Transform between (-1000,-1000)-(1000,1000) normalized coords from camera 2622e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala // API and HAL2 (0,0)-(activePixelArray.width/height) coordinates 2632e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala int arrayXToNormalized(int width) const; 2642e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala int arrayYToNormalized(int height) const; 2652e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala int normalizedXToArray(int x) const; 2662e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala int normalizedYToArray(int y) const; 2672e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala}; 2682e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 2692e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala// This class encapsulates the Parameters class so that it can only be accessed 2702e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala// by constructing a Lock object, which locks the SharedParameter's mutex. 2712e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvalaclass SharedParameters { 2722e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala public: 2732e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala SharedParameters(int cameraId, int cameraFacing): 2742e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala mParameters(cameraId, cameraFacing) { 2752e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala } 2762e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 2772e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala template<typename S, typename P> 2782e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala class BaseLock { 2792e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala public: 2802e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala BaseLock(S &p): 2812e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala mParameters(p.mParameters), 2822e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala mSharedParameters(p) { 2832e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala mSharedParameters.mLock.lock(); 2842e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala } 2852e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 2862e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala ~BaseLock() { 2872e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala mSharedParameters.mLock.unlock(); 2882e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala } 2892e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala P &mParameters; 2902e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala private: 2912e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala // Disallow copying, default construction 2922e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala BaseLock(); 2932e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala BaseLock(const BaseLock &); 2942e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala BaseLock &operator=(const BaseLock &); 2952e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala S &mSharedParameters; 2962e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala }; 2972e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala typedef BaseLock<SharedParameters, Parameters> Lock; 2982e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala typedef BaseLock<const SharedParameters, const Parameters> ReadLock; 2992e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 3002e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala // Access static info, read-only and immutable, so no lock needed 3012e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala camera_metadata_ro_entry_t staticInfo(uint32_t tag, 3022e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala size_t minCount=0, size_t maxCount=0) const { 3032e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala return mParameters.staticInfo(tag, minCount, maxCount); 3042e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala } 3052e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 3062e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala // Only use for dumping or other debugging 3072e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala const Parameters &unsafeAccess() { 3082e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala return mParameters; 3092e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala } 3102e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala private: 3112e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala Parameters mParameters; 3122e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala mutable Mutex mLock; 3132e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala}; 3142e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 3152e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 3162e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala}; // namespace camera2 3172e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala}; // namespace android 3182e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala 3192e19c3c02957208371cdd491e6342ea7ddb440d9Eino-Ville Talvala#endif 320