1 /* 2 * Copyright (C) 2008 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 #ifndef ANDROID_HARDWARE_CAMERA_PARAMETERS_H 18 #define ANDROID_HARDWARE_CAMERA_PARAMETERS_H 19 20 #include <utils/KeyedVector.h> 21 #include <utils/String8.h> 22 23 namespace android { 24 25 struct Size { 26 int width; 27 int height; 28 SizeSize29 Size() { 30 width = 0; 31 height = 0; 32 } 33 SizeSize34 Size(int w, int h) { 35 width = w; 36 height = h; 37 } 38 }; 39 40 class CameraParameters 41 { 42 public: 43 CameraParameters(); CameraParameters(const String8 & params)44 CameraParameters(const String8 ¶ms) { unflatten(params); } 45 ~CameraParameters(); 46 47 String8 flatten() const; 48 void unflatten(const String8 ¶ms); 49 50 void set(const char *key, const char *value); 51 void set(const char *key, int value); 52 void setFloat(const char *key, float value); 53 const char *get(const char *key) const; 54 int getInt(const char *key) const; 55 float getFloat(const char *key) const; 56 57 void remove(const char *key); 58 59 void setPreviewSize(int width, int height); 60 void getPreviewSize(int *width, int *height) const; 61 void getSupportedPreviewSizes(Vector<Size> &sizes) const; 62 void setPreviewFrameRate(int fps); 63 int getPreviewFrameRate() const; 64 void getPreviewFpsRange(int *min_fps, int *max_fps) const; 65 void setPreviewFormat(const char *format); 66 const char *getPreviewFormat() const; 67 void setPictureSize(int width, int height); 68 void getPictureSize(int *width, int *height) const; 69 void getSupportedPictureSizes(Vector<Size> &sizes) const; 70 void setPictureFormat(const char *format); 71 const char *getPictureFormat() const; 72 73 void dump() const; 74 status_t dump(int fd, const Vector<String16>& args) const; 75 76 // Parameter keys to communicate between camera application and driver. 77 // The access (read/write, read only, or write only) is viewed from the 78 // perspective of applications, not driver. 79 80 // Preview frame size in pixels (width x height). 81 // Example value: "480x320". Read/Write. 82 static const char KEY_PREVIEW_SIZE[]; 83 // Supported preview frame sizes in pixels. 84 // Example value: "800x600,480x320". Read only. 85 static const char KEY_SUPPORTED_PREVIEW_SIZES[]; 86 // The current minimum and maximum preview fps. This controls the rate of 87 // preview frames received (CAMERA_MSG_PREVIEW_FRAME). The minimum and 88 // maximum fps must be one of the elements from 89 // KEY_SUPPORTED_PREVIEW_FPS_RANGE parameter. 90 // Example value: "10500,26623" 91 static const char KEY_PREVIEW_FPS_RANGE[]; 92 // The supported preview fps (frame-per-second) ranges. Each range contains 93 // a minimum fps and maximum fps. If minimum fps equals to maximum fps, the 94 // camera outputs frames in fixed frame rate. If not, the camera outputs 95 // frames in auto frame rate. The actual frame rate fluctuates between the 96 // minimum and the maximum. The list has at least one element. The list is 97 // sorted from small to large (first by maximum fps and then minimum fps). 98 // Example value: "(10500,26623),(15000,26623),(30000,30000)" 99 static const char KEY_SUPPORTED_PREVIEW_FPS_RANGE[]; 100 // The image format for preview frames. See CAMERA_MSG_PREVIEW_FRAME in 101 // frameworks/base/include/camera/Camera.h. 102 // Example value: "yuv420sp" or PIXEL_FORMAT_XXX constants. Read/write. 103 static const char KEY_PREVIEW_FORMAT[]; 104 // Supported image formats for preview frames. 105 // Example value: "yuv420sp,yuv422i-yuyv". Read only. 106 static const char KEY_SUPPORTED_PREVIEW_FORMATS[]; 107 // Number of preview frames per second. This is the target frame rate. The 108 // actual frame rate depends on the driver. 109 // Example value: "15". Read/write. 110 static const char KEY_PREVIEW_FRAME_RATE[]; 111 // Supported number of preview frames per second. 112 // Example value: "24,15,10". Read. 113 static const char KEY_SUPPORTED_PREVIEW_FRAME_RATES[]; 114 // The dimensions for captured pictures in pixels (width x height). 115 // Example value: "1024x768". Read/write. 116 static const char KEY_PICTURE_SIZE[]; 117 // Supported dimensions for captured pictures in pixels. 118 // Example value: "2048x1536,1024x768". Read only. 119 static const char KEY_SUPPORTED_PICTURE_SIZES[]; 120 // The image format for captured pictures. See CAMERA_MSG_COMPRESSED_IMAGE 121 // in frameworks/base/include/camera/Camera.h. 122 // Example value: "jpeg" or PIXEL_FORMAT_XXX constants. Read/write. 123 static const char KEY_PICTURE_FORMAT[]; 124 // Supported image formats for captured pictures. 125 // Example value: "jpeg,rgb565". Read only. 126 static const char KEY_SUPPORTED_PICTURE_FORMATS[]; 127 // The width (in pixels) of EXIF thumbnail in Jpeg picture. 128 // Example value: "512". Read/write. 129 static const char KEY_JPEG_THUMBNAIL_WIDTH[]; 130 // The height (in pixels) of EXIF thumbnail in Jpeg picture. 131 // Example value: "384". Read/write. 132 static const char KEY_JPEG_THUMBNAIL_HEIGHT[]; 133 // Supported EXIF thumbnail sizes (width x height). 0x0 means not thumbnail 134 // in EXIF. 135 // Example value: "512x384,320x240,0x0". Read only. 136 static const char KEY_SUPPORTED_JPEG_THUMBNAIL_SIZES[]; 137 // The quality of the EXIF thumbnail in Jpeg picture. The range is 1 to 100, 138 // with 100 being the best. 139 // Example value: "90". Read/write. 140 static const char KEY_JPEG_THUMBNAIL_QUALITY[]; 141 // Jpeg quality of captured picture. The range is 1 to 100, with 100 being 142 // the best. 143 // Example value: "90". Read/write. 144 static const char KEY_JPEG_QUALITY[]; 145 // The rotation angle in degrees relative to the orientation of the camera. 146 // This affects the pictures returned from CAMERA_MSG_COMPRESSED_IMAGE. The 147 // camera driver may set orientation in the EXIF header without rotating the 148 // picture. Or the driver may rotate the picture and the EXIF thumbnail. If 149 // the Jpeg picture is rotated, the orientation in the EXIF header will be 150 // missing or 1 (row #0 is top and column #0 is left side). 151 // 152 // Note that the JPEG pictures of front-facing cameras are not mirrored 153 // as in preview display. 154 // 155 // For example, suppose the natural orientation of the device is portrait. 156 // The device is rotated 270 degrees clockwise, so the device orientation is 157 // 270. Suppose a back-facing camera sensor is mounted in landscape and the 158 // top side of the camera sensor is aligned with the right edge of the 159 // display in natural orientation. So the camera orientation is 90. The 160 // rotation should be set to 0 (270 + 90). 161 // 162 // Example value: "0" or "90" or "180" or "270". Write only. 163 static const char KEY_ROTATION[]; 164 // GPS latitude coordinate. GPSLatitude and GPSLatitudeRef will be stored in 165 // JPEG EXIF header. 166 // Example value: "25.032146" or "-33.462809". Write only. 167 static const char KEY_GPS_LATITUDE[]; 168 // GPS longitude coordinate. GPSLongitude and GPSLongitudeRef will be stored 169 // in JPEG EXIF header. 170 // Example value: "121.564448" or "-70.660286". Write only. 171 static const char KEY_GPS_LONGITUDE[]; 172 // GPS altitude. GPSAltitude and GPSAltitudeRef will be stored in JPEG EXIF 173 // header. 174 // Example value: "21.0" or "-5". Write only. 175 static const char KEY_GPS_ALTITUDE[]; 176 // GPS timestamp (UTC in seconds since January 1, 1970). This should be 177 // stored in JPEG EXIF header. 178 // Example value: "1251192757". Write only. 179 static const char KEY_GPS_TIMESTAMP[]; 180 // GPS Processing Method 181 // Example value: "GPS" or "NETWORK". Write only. 182 static const char KEY_GPS_PROCESSING_METHOD[]; 183 // Current white balance setting. 184 // Example value: "auto" or WHITE_BALANCE_XXX constants. Read/write. 185 static const char KEY_WHITE_BALANCE[]; 186 // Supported white balance settings. 187 // Example value: "auto,incandescent,daylight". Read only. 188 static const char KEY_SUPPORTED_WHITE_BALANCE[]; 189 // Current color effect setting. 190 // Example value: "none" or EFFECT_XXX constants. Read/write. 191 static const char KEY_EFFECT[]; 192 // Supported color effect settings. 193 // Example value: "none,mono,sepia". Read only. 194 static const char KEY_SUPPORTED_EFFECTS[]; 195 // Current antibanding setting. 196 // Example value: "auto" or ANTIBANDING_XXX constants. Read/write. 197 static const char KEY_ANTIBANDING[]; 198 // Supported antibanding settings. 199 // Example value: "auto,50hz,60hz,off". Read only. 200 static const char KEY_SUPPORTED_ANTIBANDING[]; 201 // Current scene mode. 202 // Example value: "auto" or SCENE_MODE_XXX constants. Read/write. 203 static const char KEY_SCENE_MODE[]; 204 // Supported scene mode settings. 205 // Example value: "auto,night,fireworks". Read only. 206 static const char KEY_SUPPORTED_SCENE_MODES[]; 207 // Current flash mode. 208 // Example value: "auto" or FLASH_MODE_XXX constants. Read/write. 209 static const char KEY_FLASH_MODE[]; 210 // Supported flash modes. 211 // Example value: "auto,on,off". Read only. 212 static const char KEY_SUPPORTED_FLASH_MODES[]; 213 // Current focus mode. This will not be empty. Applications should call 214 // CameraHardwareInterface.autoFocus to start the focus if focus mode is 215 // FOCUS_MODE_AUTO or FOCUS_MODE_MACRO. 216 // Example value: "auto" or FOCUS_MODE_XXX constants. Read/write. 217 static const char KEY_FOCUS_MODE[]; 218 // Supported focus modes. 219 // Example value: "auto,macro,fixed". Read only. 220 static const char KEY_SUPPORTED_FOCUS_MODES[]; 221 // Focal length in millimeter. 222 // Example value: "4.31". Read only. 223 static const char KEY_FOCAL_LENGTH[]; 224 // Horizontal angle of view in degrees. 225 // Example value: "54.8". Read only. 226 static const char KEY_HORIZONTAL_VIEW_ANGLE[]; 227 // Vertical angle of view in degrees. 228 // Example value: "42.5". Read only. 229 static const char KEY_VERTICAL_VIEW_ANGLE[]; 230 // Exposure compensation index. 0 means exposure is not adjusted. 231 // Example value: "0" or "5". Read/write. 232 static const char KEY_EXPOSURE_COMPENSATION[]; 233 // The maximum exposure compensation index (>=0). 234 // Example value: "6". Read only. 235 static const char KEY_MAX_EXPOSURE_COMPENSATION[]; 236 // The minimum exposure compensation index (<=0). 237 // Example value: "-6". Read only. 238 static const char KEY_MIN_EXPOSURE_COMPENSATION[]; 239 // The exposure compensation step. Exposure compensation index multiply by 240 // step eqals to EV. Ex: if exposure compensation index is 6 and step is 241 // 0.3333, EV is -2. 242 // Example value: "0.333333333" or "0.5". Read only. 243 static const char KEY_EXPOSURE_COMPENSATION_STEP[]; 244 // Current zoom value. 245 // Example value: "0" or "6". Read/write. 246 static const char KEY_ZOOM[]; 247 // Maximum zoom value. 248 // Example value: "6". Read only. 249 static const char KEY_MAX_ZOOM[]; 250 // The zoom ratios of all zoom values. The zoom ratio is in 1/100 251 // increments. Ex: a zoom of 3.2x is returned as 320. The number of list 252 // elements is KEY_MAX_ZOOM + 1. The first element is always 100. The last 253 // element is the zoom ratio of zoom value KEY_MAX_ZOOM. 254 // Example value: "100,150,200,250,300,350,400". Read only. 255 static const char KEY_ZOOM_RATIOS[]; 256 // Whether zoom is supported. Zoom is supported if the value is "true". Zoom 257 // is not supported if the value is not "true" or the key does not exist. 258 // Example value: "true". Read only. 259 static const char KEY_ZOOM_SUPPORTED[]; 260 // Whether if smooth zoom is supported. Smooth zoom is supported if the 261 // value is "true". It is not supported if the value is not "true" or the 262 // key does not exist. 263 // See CAMERA_CMD_START_SMOOTH_ZOOM, CAMERA_CMD_STOP_SMOOTH_ZOOM, and 264 // CAMERA_MSG_ZOOM in frameworks/base/include/camera/Camera.h. 265 // Example value: "true". Read only. 266 static const char KEY_SMOOTH_ZOOM_SUPPORTED[]; 267 268 // The distances (in meters) from the camera to where an object appears to 269 // be in focus. The object is sharpest at the optimal focus distance. The 270 // depth of field is the far focus distance minus near focus distance. 271 // 272 // Focus distances may change after starting auto focus, canceling auto 273 // focus, or starting the preview. Applications can read this anytime to get 274 // the latest focus distances. If the focus mode is FOCUS_MODE_CONTINUOUS, 275 // focus distances may change from time to time. 276 // 277 // This is intended to estimate the distance between the camera and the 278 // subject. After autofocus, the subject distance may be within near and far 279 // focus distance. However, the precision depends on the camera hardware, 280 // autofocus algorithm, the focus area, and the scene. The error can be 281 // large and it should be only used as a reference. 282 // 283 // Far focus distance > optimal focus distance > near focus distance. If 284 // the far focus distance is infinity, the value should be "Infinity" (case 285 // sensitive). The format is three float values separated by commas. The 286 // first is near focus distance. The second is optimal focus distance. The 287 // third is far focus distance. 288 // Example value: "0.95,1.9,Infinity" or "0.049,0.05,0.051". Read only. 289 static const char KEY_FOCUS_DISTANCES[]; 290 291 // The image format for video frames. See CAMERA_MSG_VIDEO_FRAME in 292 // frameworks/base/include/camera/Camera.h. 293 // Example value: "yuv420sp" or PIXEL_FORMAT_XXX constants. Read only. 294 static const char KEY_VIDEO_FRAME_FORMAT[]; 295 296 // Value for KEY_ZOOM_SUPPORTED or KEY_SMOOTH_ZOOM_SUPPORTED. 297 static const char TRUE[]; 298 299 // Value for KEY_FOCUS_DISTANCES. 300 static const char FOCUS_DISTANCE_INFINITY[]; 301 302 // Values for white balance settings. 303 static const char WHITE_BALANCE_AUTO[]; 304 static const char WHITE_BALANCE_INCANDESCENT[]; 305 static const char WHITE_BALANCE_FLUORESCENT[]; 306 static const char WHITE_BALANCE_WARM_FLUORESCENT[]; 307 static const char WHITE_BALANCE_DAYLIGHT[]; 308 static const char WHITE_BALANCE_CLOUDY_DAYLIGHT[]; 309 static const char WHITE_BALANCE_TWILIGHT[]; 310 static const char WHITE_BALANCE_SHADE[]; 311 312 // Values for effect settings. 313 static const char EFFECT_NONE[]; 314 static const char EFFECT_MONO[]; 315 static const char EFFECT_NEGATIVE[]; 316 static const char EFFECT_SOLARIZE[]; 317 static const char EFFECT_SEPIA[]; 318 static const char EFFECT_POSTERIZE[]; 319 static const char EFFECT_WHITEBOARD[]; 320 static const char EFFECT_BLACKBOARD[]; 321 static const char EFFECT_AQUA[]; 322 323 // Values for antibanding settings. 324 static const char ANTIBANDING_AUTO[]; 325 static const char ANTIBANDING_50HZ[]; 326 static const char ANTIBANDING_60HZ[]; 327 static const char ANTIBANDING_OFF[]; 328 329 // Values for flash mode settings. 330 // Flash will not be fired. 331 static const char FLASH_MODE_OFF[]; 332 // Flash will be fired automatically when required. The flash may be fired 333 // during preview, auto-focus, or snapshot depending on the driver. 334 static const char FLASH_MODE_AUTO[]; 335 // Flash will always be fired during snapshot. The flash may also be 336 // fired during preview or auto-focus depending on the driver. 337 static const char FLASH_MODE_ON[]; 338 // Flash will be fired in red-eye reduction mode. 339 static const char FLASH_MODE_RED_EYE[]; 340 // Constant emission of light during preview, auto-focus and snapshot. 341 // This can also be used for video recording. 342 static const char FLASH_MODE_TORCH[]; 343 344 // Values for scene mode settings. 345 static const char SCENE_MODE_AUTO[]; 346 static const char SCENE_MODE_ACTION[]; 347 static const char SCENE_MODE_PORTRAIT[]; 348 static const char SCENE_MODE_LANDSCAPE[]; 349 static const char SCENE_MODE_NIGHT[]; 350 static const char SCENE_MODE_NIGHT_PORTRAIT[]; 351 static const char SCENE_MODE_THEATRE[]; 352 static const char SCENE_MODE_BEACH[]; 353 static const char SCENE_MODE_SNOW[]; 354 static const char SCENE_MODE_SUNSET[]; 355 static const char SCENE_MODE_STEADYPHOTO[]; 356 static const char SCENE_MODE_FIREWORKS[]; 357 static const char SCENE_MODE_SPORTS[]; 358 static const char SCENE_MODE_PARTY[]; 359 static const char SCENE_MODE_CANDLELIGHT[]; 360 // Applications are looking for a barcode. Camera driver will be optimized 361 // for barcode reading. 362 static const char SCENE_MODE_BARCODE[]; 363 364 // Formats for setPreviewFormat and setPictureFormat. 365 static const char PIXEL_FORMAT_YUV422SP[]; 366 static const char PIXEL_FORMAT_YUV420SP[]; // NV21 367 static const char PIXEL_FORMAT_YUV422I[]; // YUY2 368 static const char PIXEL_FORMAT_RGB565[]; 369 static const char PIXEL_FORMAT_JPEG[]; 370 371 // Values for focus mode settings. 372 // Auto-focus mode. Applications should call 373 // CameraHardwareInterface.autoFocus to start the focus in this mode. 374 static const char FOCUS_MODE_AUTO[]; 375 // Focus is set at infinity. Applications should not call 376 // CameraHardwareInterface.autoFocus in this mode. 377 static const char FOCUS_MODE_INFINITY[]; 378 // Macro (close-up) focus mode. Applications should call 379 // CameraHardwareInterface.autoFocus to start the focus in this mode. 380 static const char FOCUS_MODE_MACRO[]; 381 // Focus is fixed. The camera is always in this mode if the focus is not 382 // adjustable. If the camera has auto-focus, this mode can fix the 383 // focus, which is usually at hyperfocal distance. Applications should 384 // not call CameraHardwareInterface.autoFocus in this mode. 385 static const char FOCUS_MODE_FIXED[]; 386 // Extended depth of field (EDOF). Focusing is done digitally and 387 // continuously. Applications should not call 388 // CameraHardwareInterface.autoFocus in this mode. 389 static const char FOCUS_MODE_EDOF[]; 390 // Continuous auto focus mode intended for video recording. The camera 391 // continuously tries to focus. This is ideal for shooting video. 392 // Applications still can call CameraHardwareInterface.takePicture in this 393 // mode but the subject may not be in focus. Auto focus starts when the 394 // parameter is set. Applications should not call 395 // CameraHardwareInterface.autoFocus in this mode. To stop continuous focus, 396 // applications should change the focus mode to other modes. 397 static const char FOCUS_MODE_CONTINUOUS_VIDEO[]; 398 399 private: 400 DefaultKeyedVector<String8,String8> mMap; 401 }; 402 403 }; // namespace android 404 405 #endif 406