CameraParameters.cpp revision 9078a1b3b9f9c0c48046ade0e8e18b0d79a659db
1/* 2** 3** Copyright 2008, The Android Open Source Project 4** 5** Licensed under the Apache License, Version 2.0 (the "License"); 6** you may not use this file except in compliance with the License. 7** You may obtain a copy of the License at 8** 9** http://www.apache.org/licenses/LICENSE-2.0 10** 11** Unless required by applicable law or agreed to in writing, software 12** distributed under the License is distributed on an "AS IS" BASIS, 13** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 14** See the License for the specific language governing permissions and 15** limitations under the License. 16*/ 17 18#define LOG_TAG "CameraParams" 19// #define LOG_NDEBUG 0 20#include <utils/Log.h> 21 22#include <string.h> 23#include <stdlib.h> 24#include <camera/CameraParameters.h> 25 26namespace android { 27// Parameter keys to communicate between camera application and driver. 28const char CameraParameters::KEY_PREVIEW_SIZE[] = "preview-size"; 29const char CameraParameters::KEY_SUPPORTED_PREVIEW_SIZES[] = "preview-size-values"; 30const char CameraParameters::KEY_PREVIEW_FORMAT[] = "preview-format"; 31const char CameraParameters::KEY_SUPPORTED_PREVIEW_FORMATS[] = "preview-format-values"; 32const char CameraParameters::KEY_PREVIEW_FRAME_RATE[] = "preview-frame-rate"; 33const char CameraParameters::KEY_SUPPORTED_PREVIEW_FRAME_RATES[] = "preview-frame-rate-values"; 34const char CameraParameters::KEY_PREVIEW_FPS_RANGE[] = "preview-fps-range"; 35const char CameraParameters::KEY_SUPPORTED_PREVIEW_FPS_RANGE[] = "preview-fps-range-values"; 36const char CameraParameters::KEY_PICTURE_SIZE[] = "picture-size"; 37const char CameraParameters::KEY_SUPPORTED_PICTURE_SIZES[] = "picture-size-values"; 38const char CameraParameters::KEY_PICTURE_FORMAT[] = "picture-format"; 39const char CameraParameters::KEY_SUPPORTED_PICTURE_FORMATS[] = "picture-format-values"; 40const char CameraParameters::KEY_JPEG_THUMBNAIL_WIDTH[] = "jpeg-thumbnail-width"; 41const char CameraParameters::KEY_JPEG_THUMBNAIL_HEIGHT[] = "jpeg-thumbnail-height"; 42const char CameraParameters::KEY_SUPPORTED_JPEG_THUMBNAIL_SIZES[] = "jpeg-thumbnail-size-values"; 43const char CameraParameters::KEY_JPEG_THUMBNAIL_QUALITY[] = "jpeg-thumbnail-quality"; 44const char CameraParameters::KEY_JPEG_QUALITY[] = "jpeg-quality"; 45const char CameraParameters::KEY_ROTATION[] = "rotation"; 46const char CameraParameters::KEY_GPS_LATITUDE[] = "gps-latitude"; 47const char CameraParameters::KEY_GPS_LONGITUDE[] = "gps-longitude"; 48const char CameraParameters::KEY_GPS_ALTITUDE[] = "gps-altitude"; 49const char CameraParameters::KEY_GPS_TIMESTAMP[] = "gps-timestamp"; 50const char CameraParameters::KEY_GPS_PROCESSING_METHOD[] = "gps-processing-method"; 51const char CameraParameters::KEY_WHITE_BALANCE[] = "whitebalance"; 52const char CameraParameters::KEY_SUPPORTED_WHITE_BALANCE[] = "whitebalance-values"; 53const char CameraParameters::KEY_EFFECT[] = "effect"; 54const char CameraParameters::KEY_SUPPORTED_EFFECTS[] = "effect-values"; 55const char CameraParameters::KEY_ANTIBANDING[] = "antibanding"; 56const char CameraParameters::KEY_SUPPORTED_ANTIBANDING[] = "antibanding-values"; 57const char CameraParameters::KEY_SCENE_MODE[] = "scene-mode"; 58const char CameraParameters::KEY_SUPPORTED_SCENE_MODES[] = "scene-mode-values"; 59const char CameraParameters::KEY_FLASH_MODE[] = "flash-mode"; 60const char CameraParameters::KEY_SUPPORTED_FLASH_MODES[] = "flash-mode-values"; 61const char CameraParameters::KEY_FOCUS_MODE[] = "focus-mode"; 62const char CameraParameters::KEY_SUPPORTED_FOCUS_MODES[] = "focus-mode-values"; 63const char CameraParameters::KEY_MAX_NUM_FOCUS_AREAS[] = "max-num-focus-areas"; 64const char CameraParameters::KEY_FOCUS_AREAS[] = "focus-areas"; 65const char CameraParameters::KEY_FOCAL_LENGTH[] = "focal-length"; 66const char CameraParameters::KEY_HORIZONTAL_VIEW_ANGLE[] = "horizontal-view-angle"; 67const char CameraParameters::KEY_VERTICAL_VIEW_ANGLE[] = "vertical-view-angle"; 68const char CameraParameters::KEY_EXPOSURE_COMPENSATION[] = "exposure-compensation"; 69const char CameraParameters::KEY_MAX_EXPOSURE_COMPENSATION[] = "max-exposure-compensation"; 70const char CameraParameters::KEY_MIN_EXPOSURE_COMPENSATION[] = "min-exposure-compensation"; 71const char CameraParameters::KEY_EXPOSURE_COMPENSATION_STEP[] = "exposure-compensation-step"; 72const char CameraParameters::KEY_AUTO_EXPOSURE_LOCK[] = "auto-exposure-lock"; 73const char CameraParameters::KEY_AUTO_EXPOSURE_LOCK_SUPPORTED[] = "auto-exposure-lock-supported"; 74const char CameraParameters::KEY_AUTO_WHITEBALANCE_LOCK[] = "auto-whitebalance-lock"; 75const char CameraParameters::KEY_AUTO_WHITEBALANCE_LOCK_SUPPORTED[] = "auto-whitebalance-lock-supported"; 76const char CameraParameters::KEY_MAX_NUM_METERING_AREAS[] = "max-num-metering-areas"; 77const char CameraParameters::KEY_METERING_AREAS[] = "metering-areas"; 78const char CameraParameters::KEY_ZOOM[] = "zoom"; 79const char CameraParameters::KEY_MAX_ZOOM[] = "max-zoom"; 80const char CameraParameters::KEY_ZOOM_RATIOS[] = "zoom-ratios"; 81const char CameraParameters::KEY_ZOOM_SUPPORTED[] = "zoom-supported"; 82const char CameraParameters::KEY_SMOOTH_ZOOM_SUPPORTED[] = "smooth-zoom-supported"; 83const char CameraParameters::KEY_FOCUS_DISTANCES[] = "focus-distances"; 84const char CameraParameters::KEY_VIDEO_FRAME_FORMAT[] = "video-frame-format"; 85const char CameraParameters::KEY_VIDEO_SIZE[] = "video-size"; 86const char CameraParameters::KEY_SUPPORTED_VIDEO_SIZES[] = "video-size-values"; 87const char CameraParameters::KEY_PREFERRED_PREVIEW_SIZE_FOR_VIDEO[] = "preferred-preview-size-for-video"; 88const char CameraParameters::KEY_MAX_NUM_DETECTED_FACES_HW[] = "max-num-detected-faces-hw"; 89const char CameraParameters::KEY_MAX_NUM_DETECTED_FACES_SW[] = "max-num-detected-faces-sw"; 90const char CameraParameters::KEY_RECORDING_HINT[] = "recording-hint"; 91const char CameraParameters::KEY_VIDEO_SNAPSHOT_SUPPORTED[] = "video-snapshot-supported"; 92const char CameraParameters::KEY_VIDEO_STABILIZATION[] = "video-stabilization"; 93const char CameraParameters::KEY_VIDEO_STABILIZATION_SUPPORTED[] = "video-stabilization-supported"; 94const char CameraParameters::KEY_LIGHTFX[] = "light-fx"; 95 96const char CameraParameters::TRUE[] = "true"; 97const char CameraParameters::FALSE[] = "false"; 98const char CameraParameters::FOCUS_DISTANCE_INFINITY[] = "Infinity"; 99 100// Values for white balance settings. 101const char CameraParameters::WHITE_BALANCE_AUTO[] = "auto"; 102const char CameraParameters::WHITE_BALANCE_INCANDESCENT[] = "incandescent"; 103const char CameraParameters::WHITE_BALANCE_FLUORESCENT[] = "fluorescent"; 104const char CameraParameters::WHITE_BALANCE_WARM_FLUORESCENT[] = "warm-fluorescent"; 105const char CameraParameters::WHITE_BALANCE_DAYLIGHT[] = "daylight"; 106const char CameraParameters::WHITE_BALANCE_CLOUDY_DAYLIGHT[] = "cloudy-daylight"; 107const char CameraParameters::WHITE_BALANCE_TWILIGHT[] = "twilight"; 108const char CameraParameters::WHITE_BALANCE_SHADE[] = "shade"; 109 110// Values for effect settings. 111const char CameraParameters::EFFECT_NONE[] = "none"; 112const char CameraParameters::EFFECT_MONO[] = "mono"; 113const char CameraParameters::EFFECT_NEGATIVE[] = "negative"; 114const char CameraParameters::EFFECT_SOLARIZE[] = "solarize"; 115const char CameraParameters::EFFECT_SEPIA[] = "sepia"; 116const char CameraParameters::EFFECT_POSTERIZE[] = "posterize"; 117const char CameraParameters::EFFECT_WHITEBOARD[] = "whiteboard"; 118const char CameraParameters::EFFECT_BLACKBOARD[] = "blackboard"; 119const char CameraParameters::EFFECT_AQUA[] = "aqua"; 120 121// Values for antibanding settings. 122const char CameraParameters::ANTIBANDING_AUTO[] = "auto"; 123const char CameraParameters::ANTIBANDING_50HZ[] = "50hz"; 124const char CameraParameters::ANTIBANDING_60HZ[] = "60hz"; 125const char CameraParameters::ANTIBANDING_OFF[] = "off"; 126 127// Values for flash mode settings. 128const char CameraParameters::FLASH_MODE_OFF[] = "off"; 129const char CameraParameters::FLASH_MODE_AUTO[] = "auto"; 130const char CameraParameters::FLASH_MODE_ON[] = "on"; 131const char CameraParameters::FLASH_MODE_RED_EYE[] = "red-eye"; 132const char CameraParameters::FLASH_MODE_TORCH[] = "torch"; 133 134// Values for scene mode settings. 135const char CameraParameters::SCENE_MODE_AUTO[] = "auto"; 136const char CameraParameters::SCENE_MODE_ACTION[] = "action"; 137const char CameraParameters::SCENE_MODE_PORTRAIT[] = "portrait"; 138const char CameraParameters::SCENE_MODE_LANDSCAPE[] = "landscape"; 139const char CameraParameters::SCENE_MODE_NIGHT[] = "night"; 140const char CameraParameters::SCENE_MODE_NIGHT_PORTRAIT[] = "night-portrait"; 141const char CameraParameters::SCENE_MODE_THEATRE[] = "theatre"; 142const char CameraParameters::SCENE_MODE_BEACH[] = "beach"; 143const char CameraParameters::SCENE_MODE_SNOW[] = "snow"; 144const char CameraParameters::SCENE_MODE_SUNSET[] = "sunset"; 145const char CameraParameters::SCENE_MODE_STEADYPHOTO[] = "steadyphoto"; 146const char CameraParameters::SCENE_MODE_FIREWORKS[] = "fireworks"; 147const char CameraParameters::SCENE_MODE_SPORTS[] = "sports"; 148const char CameraParameters::SCENE_MODE_PARTY[] = "party"; 149const char CameraParameters::SCENE_MODE_CANDLELIGHT[] = "candlelight"; 150const char CameraParameters::SCENE_MODE_BARCODE[] = "barcode"; 151const char CameraParameters::SCENE_MODE_HDR[] = "hdr"; 152 153const char CameraParameters::PIXEL_FORMAT_YUV422SP[] = "yuv422sp"; 154const char CameraParameters::PIXEL_FORMAT_YUV420SP[] = "yuv420sp"; 155const char CameraParameters::PIXEL_FORMAT_YUV422I[] = "yuv422i-yuyv"; 156const char CameraParameters::PIXEL_FORMAT_YUV420P[] = "yuv420p"; 157const char CameraParameters::PIXEL_FORMAT_RGB565[] = "rgb565"; 158const char CameraParameters::PIXEL_FORMAT_RGBA8888[] = "rgba8888"; 159const char CameraParameters::PIXEL_FORMAT_JPEG[] = "jpeg"; 160const char CameraParameters::PIXEL_FORMAT_BAYER_RGGB[] = "bayer-rggb"; 161const char CameraParameters::PIXEL_FORMAT_ANDROID_OPAQUE[] = "android-opaque"; 162 163// Values for focus mode settings. 164const char CameraParameters::FOCUS_MODE_AUTO[] = "auto"; 165const char CameraParameters::FOCUS_MODE_INFINITY[] = "infinity"; 166const char CameraParameters::FOCUS_MODE_MACRO[] = "macro"; 167const char CameraParameters::FOCUS_MODE_FIXED[] = "fixed"; 168const char CameraParameters::FOCUS_MODE_EDOF[] = "edof"; 169const char CameraParameters::FOCUS_MODE_CONTINUOUS_VIDEO[] = "continuous-video"; 170const char CameraParameters::FOCUS_MODE_CONTINUOUS_PICTURE[] = "continuous-picture"; 171 172// Values for light fx settings 173const char CameraParameters::LIGHTFX_LOWLIGHT[] = "low-light"; 174const char CameraParameters::LIGHTFX_HDR[] = "high-dynamic-range"; 175 176CameraParameters::CameraParameters() 177 : mMap() 178{ 179} 180 181CameraParameters::~CameraParameters() 182{ 183} 184 185String8 CameraParameters::flatten() const 186{ 187 String8 flattened(""); 188 size_t size = mMap.size(); 189 190 for (size_t i = 0; i < size; i++) { 191 String8 k, v; 192 k = mMap.keyAt(i); 193 v = mMap.valueAt(i); 194 195 flattened += k; 196 flattened += "="; 197 flattened += v; 198 if (i != size-1) 199 flattened += ";"; 200 } 201 202 ALOGV("%s: Flattened params = %s", __FUNCTION__, flattened.string()); 203 204 return flattened; 205} 206 207void CameraParameters::unflatten(const String8 ¶ms) 208{ 209 const char *a = params.string(); 210 const char *b; 211 212 mMap.clear(); 213 214 for (;;) { 215 // Find the bounds of the key name. 216 b = strchr(a, '='); 217 if (b == 0) 218 break; 219 220 // Create the key string. 221 String8 k(a, (size_t)(b-a)); 222 223 // Find the value. 224 a = b+1; 225 b = strchr(a, ';'); 226 if (b == 0) { 227 // If there's no semicolon, this is the last item. 228 String8 v(a); 229 mMap.add(k, v); 230 break; 231 } 232 233 String8 v(a, (size_t)(b-a)); 234 mMap.add(k, v); 235 a = b+1; 236 } 237} 238 239 240void CameraParameters::set(const char *key, const char *value) 241{ 242 // XXX i think i can do this with strspn() 243 if (strchr(key, '=') || strchr(key, ';')) { 244 //XXX ALOGE("Key \"%s\"contains invalid character (= or ;)", key); 245 return; 246 } 247 248 if (strchr(value, '=') || strchr(value, ';')) { 249 //XXX ALOGE("Value \"%s\"contains invalid character (= or ;)", value); 250 return; 251 } 252 253 // Replacing a value updates the key's order to be the new largest order 254 ssize_t res = mMap.replaceValueFor(String8(key), String8(value)); 255 LOG_ALWAYS_FATAL_IF(res < 0, "replaceValueFor(%s,%s) failed", key, value); 256} 257 258void CameraParameters::set(const char *key, int value) 259{ 260 char str[16]; 261 sprintf(str, "%d", value); 262 set(key, str); 263} 264 265void CameraParameters::setFloat(const char *key, float value) 266{ 267 char str[16]; // 14 should be enough. We overestimate to be safe. 268 snprintf(str, sizeof(str), "%g", value); 269 set(key, str); 270} 271 272const char *CameraParameters::get(const char *key) const 273{ 274 ssize_t idx = mMap.indexOfKey(String8(key)); 275 if (idx < 0) { 276 return NULL; 277 } else { 278 return mMap.valueAt(idx).string(); 279 } 280} 281 282int CameraParameters::getInt(const char *key) const 283{ 284 const char *v = get(key); 285 if (v == 0) 286 return -1; 287 return strtol(v, 0, 0); 288} 289 290float CameraParameters::getFloat(const char *key) const 291{ 292 const char *v = get(key); 293 if (v == 0) return -1; 294 return strtof(v, 0); 295} 296 297status_t CameraParameters::compareSetOrder(const char *key1, const char *key2, 298 int *order) const { 299 if (key1 == NULL) { 300 ALOGE("%s: key1 must not be NULL", __FUNCTION__); 301 return BAD_VALUE; 302 } else if (key2 == NULL) { 303 ALOGE("%s: key2 must not be NULL", __FUNCTION__); 304 return BAD_VALUE; 305 } else if (order == NULL) { 306 ALOGE("%s: order must not be NULL", __FUNCTION__); 307 return BAD_VALUE; 308 } 309 310 ssize_t index1 = mMap.indexOfKey(String8(key1)); 311 ssize_t index2 = mMap.indexOfKey(String8(key2)); 312 if (index1 < 0) { 313 ALOGW("%s: Key1 (%s) was not set", __FUNCTION__, key1); 314 return NAME_NOT_FOUND; 315 } else if (index2 < 0) { 316 ALOGW("%s: Key2 (%s) was not set", __FUNCTION__, key2); 317 return NAME_NOT_FOUND; 318 } 319 320 *order = (index1 == index2) ? 0 : 321 (index1 < index2) ? -1 : 322 1; 323 324 return OK; 325} 326 327void CameraParameters::remove(const char *key) 328{ 329 mMap.removeItem(String8(key)); 330} 331 332// Parse string like "640x480" or "10000,20000" 333static int parse_pair(const char *str, int *first, int *second, char delim, 334 char **endptr = NULL) 335{ 336 // Find the first integer. 337 char *end; 338 int w = (int)strtol(str, &end, 10); 339 // If a delimeter does not immediately follow, give up. 340 if (*end != delim) { 341 ALOGE("Cannot find delimeter (%c) in str=%s", delim, str); 342 return -1; 343 } 344 345 // Find the second integer, immediately after the delimeter. 346 int h = (int)strtol(end+1, &end, 10); 347 348 *first = w; 349 *second = h; 350 351 if (endptr) { 352 *endptr = end; 353 } 354 355 return 0; 356} 357 358static void parseSizesList(const char *sizesStr, Vector<Size> &sizes) 359{ 360 if (sizesStr == 0) { 361 return; 362 } 363 364 char *sizeStartPtr = (char *)sizesStr; 365 366 while (true) { 367 int width, height; 368 int success = parse_pair(sizeStartPtr, &width, &height, 'x', 369 &sizeStartPtr); 370 if (success == -1 || (*sizeStartPtr != ',' && *sizeStartPtr != '\0')) { 371 ALOGE("Picture sizes string \"%s\" contains invalid character.", sizesStr); 372 return; 373 } 374 sizes.push(Size(width, height)); 375 376 if (*sizeStartPtr == '\0') { 377 return; 378 } 379 sizeStartPtr++; 380 } 381} 382 383void CameraParameters::setPreviewSize(int width, int height) 384{ 385 char str[32]; 386 sprintf(str, "%dx%d", width, height); 387 set(KEY_PREVIEW_SIZE, str); 388} 389 390void CameraParameters::getPreviewSize(int *width, int *height) const 391{ 392 *width = *height = -1; 393 // Get the current string, if it doesn't exist, leave the -1x-1 394 const char *p = get(KEY_PREVIEW_SIZE); 395 if (p == 0) return; 396 parse_pair(p, width, height, 'x'); 397} 398 399void CameraParameters::getPreferredPreviewSizeForVideo(int *width, int *height) const 400{ 401 *width = *height = -1; 402 const char *p = get(KEY_PREFERRED_PREVIEW_SIZE_FOR_VIDEO); 403 if (p == 0) return; 404 parse_pair(p, width, height, 'x'); 405} 406 407void CameraParameters::getSupportedPreviewSizes(Vector<Size> &sizes) const 408{ 409 const char *previewSizesStr = get(KEY_SUPPORTED_PREVIEW_SIZES); 410 parseSizesList(previewSizesStr, sizes); 411} 412 413void CameraParameters::setVideoSize(int width, int height) 414{ 415 char str[32]; 416 sprintf(str, "%dx%d", width, height); 417 set(KEY_VIDEO_SIZE, str); 418} 419 420void CameraParameters::getVideoSize(int *width, int *height) const 421{ 422 *width = *height = -1; 423 const char *p = get(KEY_VIDEO_SIZE); 424 if (p == 0) return; 425 parse_pair(p, width, height, 'x'); 426} 427 428void CameraParameters::getSupportedVideoSizes(Vector<Size> &sizes) const 429{ 430 const char *videoSizesStr = get(KEY_SUPPORTED_VIDEO_SIZES); 431 parseSizesList(videoSizesStr, sizes); 432} 433 434void CameraParameters::setPreviewFrameRate(int fps) 435{ 436 set(KEY_PREVIEW_FRAME_RATE, fps); 437} 438 439int CameraParameters::getPreviewFrameRate() const 440{ 441 return getInt(KEY_PREVIEW_FRAME_RATE); 442} 443 444void CameraParameters::getPreviewFpsRange(int *min_fps, int *max_fps) const 445{ 446 *min_fps = *max_fps = -1; 447 const char *p = get(KEY_PREVIEW_FPS_RANGE); 448 if (p == 0) return; 449 parse_pair(p, min_fps, max_fps, ','); 450} 451 452void CameraParameters::setPreviewFpsRange(int min_fps, int max_fps) 453{ 454 String8 str = String8::format("%d,%d", min_fps, max_fps); 455 set(KEY_PREVIEW_FPS_RANGE, str.string()); 456} 457 458void CameraParameters::setPreviewFormat(const char *format) 459{ 460 set(KEY_PREVIEW_FORMAT, format); 461} 462 463const char *CameraParameters::getPreviewFormat() const 464{ 465 return get(KEY_PREVIEW_FORMAT); 466} 467 468void CameraParameters::setPictureSize(int width, int height) 469{ 470 char str[32]; 471 sprintf(str, "%dx%d", width, height); 472 set(KEY_PICTURE_SIZE, str); 473} 474 475void CameraParameters::getPictureSize(int *width, int *height) const 476{ 477 *width = *height = -1; 478 // Get the current string, if it doesn't exist, leave the -1x-1 479 const char *p = get(KEY_PICTURE_SIZE); 480 if (p == 0) return; 481 parse_pair(p, width, height, 'x'); 482} 483 484void CameraParameters::getSupportedPictureSizes(Vector<Size> &sizes) const 485{ 486 const char *pictureSizesStr = get(KEY_SUPPORTED_PICTURE_SIZES); 487 parseSizesList(pictureSizesStr, sizes); 488} 489 490void CameraParameters::setPictureFormat(const char *format) 491{ 492 set(KEY_PICTURE_FORMAT, format); 493} 494 495const char *CameraParameters::getPictureFormat() const 496{ 497 return get(KEY_PICTURE_FORMAT); 498} 499 500void CameraParameters::dump() const 501{ 502 ALOGD("dump: mMap.size = %d", mMap.size()); 503 for (size_t i = 0; i < mMap.size(); i++) { 504 String8 k, v; 505 k = mMap.keyAt(i); 506 v = mMap.valueAt(i); 507 ALOGD("%s: %s\n", k.string(), v.string()); 508 } 509} 510 511status_t CameraParameters::dump(int fd, const Vector<String16>& args) const 512{ 513 const size_t SIZE = 256; 514 char buffer[SIZE]; 515 String8 result; 516 snprintf(buffer, 255, "CameraParameters::dump: mMap.size = %zu\n", mMap.size()); 517 result.append(buffer); 518 for (size_t i = 0; i < mMap.size(); i++) { 519 String8 k, v; 520 k = mMap.keyAt(i); 521 v = mMap.valueAt(i); 522 snprintf(buffer, 255, "\t%s: %s\n", k.string(), v.string()); 523 result.append(buffer); 524 } 525 write(fd, result.string(), result.size()); 526 return NO_ERROR; 527} 528 529}; // namespace android 530