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