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