CameraParameters.cpp revision 3cf613507f1e2f7bd932d921a6e222e426fd3be4
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_WHITE_BALANCE[] = "whitebalance"; 48const char CameraParameters::KEY_SUPPORTED_WHITE_BALANCE[] = "whitebalance-values"; 49const char CameraParameters::KEY_EFFECT[] = "effect"; 50const char CameraParameters::KEY_SUPPORTED_EFFECTS[] = "effect-values"; 51const char CameraParameters::KEY_ANTIBANDING[] = "antibanding"; 52const char CameraParameters::KEY_SUPPORTED_ANTIBANDING[] = "antibanding-values"; 53const char CameraParameters::KEY_SCENE_MODE[] = "scene-mode"; 54const char CameraParameters::KEY_SUPPORTED_SCENE_MODES[] = "scene-mode-values"; 55const char CameraParameters::KEY_FLASH_MODE[] = "flash-mode"; 56const char CameraParameters::KEY_SUPPORTED_FLASH_MODES[] = "flash-mode-values"; 57const char CameraParameters::KEY_FOCUS_MODE[] = "focus-mode"; 58const char CameraParameters::KEY_SUPPORTED_FOCUS_MODES[] = "focus-mode-values"; 59const char CameraParameters::KEY_FOCAL_LENGTH[] = "focal-length"; 60const char CameraParameters::KEY_HORIZONTAL_VIEW_ANGLE[] = "horizontal-view-angle"; 61const char CameraParameters::KEY_VERTICAL_VIEW_ANGLE[] = "vertical-view-angle"; 62const char CameraParameters::KEY_EXPOSURE_COMPENSATION[] = "exposure-compensation"; 63const char CameraParameters::KEY_SUPPORTED_EXPOSURE_COMPENSATION[] = "exposure-compensation-values"; 64 65// Values for white balance settings. 66const char CameraParameters::WHITE_BALANCE_AUTO[] = "auto"; 67const char CameraParameters::WHITE_BALANCE_INCANDESCENT[] = "incandescent"; 68const char CameraParameters::WHITE_BALANCE_FLUORESCENT[] = "fluorescent"; 69const char CameraParameters::WHITE_BALANCE_WARM_FLUORESCENT[] = "warm-fluorescent"; 70const char CameraParameters::WHITE_BALANCE_DAYLIGHT[] = "daylight"; 71const char CameraParameters::WHITE_BALANCE_CLOUDY_DAYLIGHT[] = "cloudy-daylight"; 72const char CameraParameters::WHITE_BALANCE_TWILIGHT[] = "twilight"; 73const char CameraParameters::WHITE_BALANCE_SHADE[] = "shade"; 74 75// Values for effect settings. 76const char CameraParameters::EFFECT_NONE[] = "none"; 77const char CameraParameters::EFFECT_MONO[] = "mono"; 78const char CameraParameters::EFFECT_NEGATIVE[] = "negative"; 79const char CameraParameters::EFFECT_SOLARIZE[] = "solarize"; 80const char CameraParameters::EFFECT_SEPIA[] = "sepia"; 81const char CameraParameters::EFFECT_POSTERIZE[] = "posterize"; 82const char CameraParameters::EFFECT_WHITEBOARD[] = "whiteboard"; 83const char CameraParameters::EFFECT_BLACKBOARD[] = "blackboard"; 84const char CameraParameters::EFFECT_AQUA[] = "aqua"; 85 86// Values for antibanding settings. 87const char CameraParameters::ANTIBANDING_AUTO[] = "auto"; 88const char CameraParameters::ANTIBANDING_50HZ[] = "50hz"; 89const char CameraParameters::ANTIBANDING_60HZ[] = "60hz"; 90const char CameraParameters::ANTIBANDING_OFF[] = "off"; 91 92// Values for flash mode settings. 93const char CameraParameters::FLASH_MODE_OFF[] = "off"; 94const char CameraParameters::FLASH_MODE_AUTO[] = "auto"; 95const char CameraParameters::FLASH_MODE_ON[] = "on"; 96const char CameraParameters::FLASH_MODE_RED_EYE[] = "red-eye"; 97const char CameraParameters::FLASH_MODE_TORCH[] = "torch"; 98 99// Values for scene mode settings. 100const char CameraParameters::SCENE_MODE_AUTO[] = "auto"; 101const char CameraParameters::SCENE_MODE_ACTION[] = "action"; 102const char CameraParameters::SCENE_MODE_PORTRAIT[] = "portrait"; 103const char CameraParameters::SCENE_MODE_LANDSCAPE[] = "landscape"; 104const char CameraParameters::SCENE_MODE_NIGHT[] = "night"; 105const char CameraParameters::SCENE_MODE_NIGHT_PORTRAIT[] = "night-portrait"; 106const char CameraParameters::SCENE_MODE_THEATRE[] = "theatre"; 107const char CameraParameters::SCENE_MODE_BEACH[] = "beach"; 108const char CameraParameters::SCENE_MODE_SNOW[] = "snow"; 109const char CameraParameters::SCENE_MODE_SUNSET[] = "sunset"; 110const char CameraParameters::SCENE_MODE_STEADYPHOTO[] = "steadyphoto"; 111const char CameraParameters::SCENE_MODE_FIREWORKS[] = "fireworks"; 112const char CameraParameters::SCENE_MODE_SPORTS[] = "sports"; 113const char CameraParameters::SCENE_MODE_PARTY[] = "party"; 114const char CameraParameters::SCENE_MODE_CANDLELIGHT[] = "candlelight"; 115 116// Formats for setPreviewFormat and setPictureFormat. 117const char CameraParameters::PIXEL_FORMAT_YUV422SP[] = "yuv422sp"; 118const char CameraParameters::PIXEL_FORMAT_YUV420SP[] = "yuv420sp"; 119const char CameraParameters::PIXEL_FORMAT_YUV422I[] = "yuv422i-yuyv"; 120const char CameraParameters::PIXEL_FORMAT_RGB565[] = "rgb565"; 121const char CameraParameters::PIXEL_FORMAT_JPEG[] = "jpeg"; 122 123// Values for focus mode settings. 124const char CameraParameters::FOCUS_MODE_AUTO[] = "auto"; 125const char CameraParameters::FOCUS_MODE_INFINITY[] = "infinity"; 126const char CameraParameters::FOCUS_MODE_MACRO[] = "macro"; 127const char CameraParameters::FOCUS_MODE_FIXED[] = "fixed"; 128 129CameraParameters::CameraParameters() 130 : mMap() 131{ 132} 133 134CameraParameters::~CameraParameters() 135{ 136} 137 138String8 CameraParameters::flatten() const 139{ 140 String8 flattened(""); 141 size_t size = mMap.size(); 142 143 for (size_t i = 0; i < size; i++) { 144 String8 k, v; 145 k = mMap.keyAt(i); 146 v = mMap.valueAt(i); 147 148 flattened += k; 149 flattened += "="; 150 flattened += v; 151 if (i != size-1) 152 flattened += ";"; 153 } 154 155 return flattened; 156} 157 158void CameraParameters::unflatten(const String8 ¶ms) 159{ 160 const char *a = params.string(); 161 const char *b; 162 163 mMap.clear(); 164 165 for (;;) { 166 // Find the bounds of the key name. 167 b = strchr(a, '='); 168 if (b == 0) 169 break; 170 171 // Create the key string. 172 String8 k(a, (size_t)(b-a)); 173 174 // Find the value. 175 a = b+1; 176 b = strchr(a, ';'); 177 if (b == 0) { 178 // If there's no semicolon, this is the last item. 179 String8 v(a); 180 mMap.add(k, v); 181 break; 182 } 183 184 String8 v(a, (size_t)(b-a)); 185 mMap.add(k, v); 186 a = b+1; 187 } 188} 189 190 191void CameraParameters::set(const char *key, const char *value) 192{ 193 // XXX i think i can do this with strspn() 194 if (strchr(key, '=') || strchr(key, ';')) { 195 //XXX LOGE("Key \"%s\"contains invalid character (= or ;)", key); 196 return; 197 } 198 199 if (strchr(value, '=') || strchr(key, ';')) { 200 //XXX LOGE("Value \"%s\"contains invalid character (= or ;)", value); 201 return; 202 } 203 204 mMap.replaceValueFor(String8(key), String8(value)); 205} 206 207void CameraParameters::set(const char *key, int value) 208{ 209 char str[16]; 210 sprintf(str, "%d", value); 211 set(key, str); 212} 213 214void CameraParameters::setFloat(const char *key, float value) 215{ 216 char str[16]; // 14 should be enough. We overestimate to be safe. 217 snprintf(str, sizeof(str), "%g", value); 218 set(key, str); 219} 220 221const char *CameraParameters::get(const char *key) const 222{ 223 String8 v = mMap.valueFor(String8(key)); 224 if (v.length() == 0) 225 return 0; 226 return v.string(); 227} 228 229int CameraParameters::getInt(const char *key) const 230{ 231 const char *v = get(key); 232 if (v == 0) 233 return -1; 234 return strtol(v, 0, 0); 235} 236 237float CameraParameters::getFloat(const char *key) const 238{ 239 const char *v = get(key); 240 if (v == 0) return -1; 241 return strtof(v, 0); 242} 243 244static int parse_size(const char *str, int &width, int &height) 245{ 246 // Find the width. 247 char *end; 248 int w = (int)strtol(str, &end, 10); 249 // If an 'x' does not immediately follow, give up. 250 if (*end != 'x') 251 return -1; 252 253 // Find the height, immediately after the 'x'. 254 int h = (int)strtol(end+1, 0, 10); 255 256 width = w; 257 height = h; 258 259 return 0; 260} 261 262void CameraParameters::setPreviewSize(int width, int height) 263{ 264 char str[32]; 265 sprintf(str, "%dx%d", width, height); 266 set(KEY_PREVIEW_SIZE, str); 267} 268 269void CameraParameters::getPreviewSize(int *width, int *height) const 270{ 271 *width = -1; 272 *height = -1; 273 274 // Get the current string, if it doesn't exist, leave the -1x-1 275 const char *p = get(KEY_PREVIEW_SIZE); 276 if (p == 0) 277 return; 278 279 int w, h; 280 if (parse_size(p, w, h) == 0) { 281 *width = w; 282 *height = h; 283 } 284} 285 286void CameraParameters::setPreviewFrameRate(int fps) 287{ 288 set(KEY_PREVIEW_FRAME_RATE, fps); 289} 290 291int CameraParameters::getPreviewFrameRate() const 292{ 293 return getInt(KEY_PREVIEW_FRAME_RATE); 294} 295 296void CameraParameters::setPreviewFormat(const char *format) 297{ 298 set(KEY_PREVIEW_FORMAT, format); 299} 300 301const char *CameraParameters::getPreviewFormat() const 302{ 303 return get(KEY_PREVIEW_FORMAT); 304} 305 306void CameraParameters::setPictureSize(int width, int height) 307{ 308 char str[32]; 309 sprintf(str, "%dx%d", width, height); 310 set(KEY_PICTURE_SIZE, str); 311} 312 313void CameraParameters::getPictureSize(int *width, int *height) const 314{ 315 *width = -1; 316 *height = -1; 317 318 // Get the current string, if it doesn't exist, leave the -1x-1 319 const char *p = get(KEY_PICTURE_SIZE); 320 if (p == 0) 321 return; 322 323 int w, h; 324 if (parse_size(p, w, h) == 0) { 325 *width = w; 326 *height = h; 327 } 328} 329 330void CameraParameters::setPictureFormat(const char *format) 331{ 332 set(KEY_PICTURE_FORMAT, format); 333} 334 335const char *CameraParameters::getPictureFormat() const 336{ 337 return get(KEY_PICTURE_FORMAT); 338} 339 340void CameraParameters::dump() const 341{ 342 LOGD("dump: mMap.size = %d", mMap.size()); 343 for (size_t i = 0; i < mMap.size(); i++) { 344 String8 k, v; 345 k = mMap.keyAt(i); 346 v = mMap.valueAt(i); 347 LOGD("%s: %s\n", k.string(), v.string()); 348 } 349} 350 351status_t CameraParameters::dump(int fd, const Vector<String16>& args) const 352{ 353 const size_t SIZE = 256; 354 char buffer[SIZE]; 355 String8 result; 356 snprintf(buffer, 255, "CameraParameters::dump: mMap.size = %d\n", mMap.size()); 357 result.append(buffer); 358 for (size_t i = 0; i < mMap.size(); i++) { 359 String8 k, v; 360 k = mMap.keyAt(i); 361 v = mMap.valueAt(i); 362 snprintf(buffer, 255, "\t%s: %s\n", k.string(), v.string()); 363 result.append(buffer); 364 } 365 write(fd, result.string(), result.size()); 366 return NO_ERROR; 367} 368 369}; // namespace android 370