/* * Copyright (C) 2008 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef ANDROID_HARDWARE_CAMERA_PARAMETERS_H #define ANDROID_HARDWARE_CAMERA_PARAMETERS_H #include #include namespace android { class CameraParameters { public: CameraParameters(); CameraParameters(const String8 ¶ms) { unflatten(params); } ~CameraParameters(); enum { CAMERA_ORIENTATION_UNKNOWN = 0, CAMERA_ORIENTATION_PORTRAIT = 1, CAMERA_ORIENTATION_LANDSCAPE = 2, }; String8 flatten() const; void unflatten(const String8 ¶ms); void set(const char *key, const char *value); void set(const char *key, int value); const char *get(const char *key) const; int getInt(const char *key) const; /* preview-size=176x144 */ void setPreviewSize(int width, int height); void getPreviewSize(int *width, int *height) const; /* preview-fps=15 */ void setPreviewFrameRate(int fps); int getPreviewFrameRate() const; /* preview-format=rgb565|yuv422 */ void setPreviewFormat(const char *format); const char *getPreviewFormat() const; /* picture-size=1024x768 */ void setPictureSize(int width, int height); void getPictureSize(int *width, int *height) const; /* picture-format=yuv422|jpeg */ void setPictureFormat(const char *format); const char *getPictureFormat() const; int getOrientation() const; void setOrientation(int orientation); void dump() const; status_t dump(int fd, const Vector& args) const; // Parameter keys to communicate between camera application and driver. // The access (read/write, read only, or write only) is viewed from the // perspective of applications, not driver. // Preview frame size in pixels (width x height). // Example value: "480x320". Read/Write. static const char KEY_PREVIEW_SIZE[]; // Supported preview frame sizes in pixels. // Example value: "800x600,480x320". Read only. static const char KEY_SUPPORTED_PREVIEW_SIZES[]; // The image format for preview frames. // Example value: "yuv420sp" or PIXEL_FORMAT_XXX constants. Read/write. static const char KEY_PREVIEW_FORMAT[]; // Supported image formats for preview frames. // Example value: "yuv420sp,yuv422i-yuyv". Read only. static const char KEY_SUPPORTED_PREVIEW_FORMATS[]; // Number of preview frames per second. // Example value: "15". Read/write. static const char KEY_PREVIEW_FRAME_RATE[]; // Supported number of preview frames per second. // Example value: "24,15,10". Read. static const char KEY_SUPPORTED_PREVIEW_FRAME_RATES[]; // The dimensions for captured pictures in pixels (width x height). // Example value: "1024x768". Read/write. static const char KEY_PICTURE_SIZE[]; // Supported dimensions for captured pictures in pixels. // Example value: "2048x1536,1024x768". Read only. static const char KEY_SUPPORTED_PICTURE_SIZES[]; // The image format for captured pictures. // Example value: "jpeg" or PIXEL_FORMAT_XXX constants. Read/write. static const char KEY_PICTURE_FORMAT[]; // Supported image formats for captured pictures. // Example value: "jpeg,rgb565". Read only. static const char KEY_SUPPORTED_PICTURE_FORMATS[]; // The width (in pixels) of EXIF thumbnail in Jpeg picture. // Example value: "512". Read/write. static const char KEY_JPEG_THUMBNAIL_WIDTH[]; // The height (in pixels) of EXIF thumbnail in Jpeg picture. // Example value: "384". Read/write. static const char KEY_JPEG_THUMBNAIL_HEIGHT[]; // Supported EXIF thumbnail sizes (width x height). // Example value: "512x384,320x240". Read only. static const char KEY_SUPPORTED_THUMBNAIL_SIZES[]; // The quality of the EXIF thumbnail in Jpeg picture. The range is 1 to 100, // with 100 being the best. // Example value: "90". Read/write. static const char KEY_JPEG_THUMBNAIL_QUALITY[]; // Jpeg quality of captured picture. The range is 1 to 100, with 100 being // the best. // Example value: "90". Read/write. static const char KEY_JPEG_QUALITY[]; // The orientation of the device in degrees. For example, suppose the // natural position of the device is landscape. If the user takes a picture // in landscape mode in 2048x1536 resolution, the rotation will be set to // "0". If the user rotates the phone 90 degrees clockwise, the rotation // should be set to "90". // The camera driver can set orientation in the EXIF header without rotating // the picture. Or the driver can rotate the picture and the EXIF thumbnail. // If the Jpeg picture is rotated, the orientation in the EXIF header should // be missing or 1 (row #0 is top and column #0 is left side). The driver // should not set default value for this parameter. // Example value: "0" or "90" or "180" or "270". Write only. static const char KEY_ROTATION[]; // GPS latitude coordinate. This will be stored in JPEG EXIF header. // Example value: "25.032146". Write only. static const char KEY_GPS_LATITUDE[]; // GPS longitude coordinate. This will be stored in JPEG EXIF header. // Example value: "121.564448". Write only. static const char KEY_GPS_LONGITUDE[]; // GPS altitude. This will be stored in JPEG EXIF header. // Example value: "21.0". Write only. static const char KEY_GPS_ALTITUDE[]; // GPS timestamp (UTC in seconds since January 1, 1970). This should be // stored in JPEG EXIF header. // Example value: "1251192757". Write only. static const char KEY_GPS_TIMESTAMP[]; // Current white balance setting. // Example value: "auto" or WHITE_BALANCE_XXX constants. Read/write. static const char KEY_WHITE_BALANCE[]; // Supported white balance settings. // Example value: "auto,incandescent,daylight". Read only. static const char KEY_SUPPORTED_WHITE_BALANCE[]; // Current color effect setting. // Example value: "none" or EFFECT_XXX constants. Read/write. static const char KEY_EFFECT[]; // Supported color effect settings. // Example value: "none,mono,sepia". Read only. static const char KEY_SUPPORTED_EFFECTS[]; // Current antibanding setting. // Example value: "auto" or ANTIBANDING_XXX constants. Read/write. static const char KEY_ANTIBANDING[]; // Supported antibanding settings. // Example value: "auto,50hz,60hz,off". Read only. static const char KEY_SUPPORTED_ANTIBANDING[]; // Current scene mode. // Example value: "auto" or SCENE_MODE_XXX constants. Read/write. static const char KEY_SCENE_MODE[]; // Supported scene mode settings. // Example value: "auto,night,fireworks". Read only. static const char KEY_SUPPORTED_SCENE_MODES[]; // Current flash mode. // Example value: "auto" or FLASH_MODE_XXX constants. Read/write. static const char KEY_FLASH_MODE[]; // Supported flash modes. // Example value: "auto,on,off". Read only. static const char KEY_SUPPORTED_FLASH_MODES[]; // Current focus mode. If the camera does not support auto-focus, the value // should be FOCUS_MODE_FIXED. If the focus mode is not FOCUS_MODE_FIXED or // or FOCUS_MODE_INFINITY, applications should call // CameraHardwareInterface.autoFocus to start the focus. // Example value: "auto" or FOCUS_MODE_XXX constants. Read/write. static const char KEY_FOCUS_MODE[]; // Supported focus modes. // Example value: "auto,macro,fixed". Read only. static const char KEY_SUPPORTED_FOCUS_MODES[]; // Values for white balance settings. static const char WHITE_BALANCE_AUTO[]; static const char WHITE_BALANCE_INCANDESCENT[]; static const char WHITE_BALANCE_FLUORESCENT[]; static const char WHITE_BALANCE_WARM_FLUORESCENT[]; static const char WHITE_BALANCE_DAYLIGHT[]; static const char WHITE_BALANCE_CLOUDY_DAYLIGHT[]; static const char WHITE_BALANCE_TWILIGHT[]; static const char WHITE_BALANCE_SHADE[]; // Values for effect settings. static const char EFFECT_NONE[]; static const char EFFECT_MONO[]; static const char EFFECT_NEGATIVE[]; static const char EFFECT_SOLARIZE[]; static const char EFFECT_SEPIA[]; static const char EFFECT_POSTERIZE[]; static const char EFFECT_WHITEBOARD[]; static const char EFFECT_BLACKBOARD[]; static const char EFFECT_AQUA[]; // Values for antibanding settings. static const char ANTIBANDING_AUTO[]; static const char ANTIBANDING_50HZ[]; static const char ANTIBANDING_60HZ[]; static const char ANTIBANDING_OFF[]; // Values for flash mode settings. // Flash will not be fired. static const char FLASH_MODE_OFF[]; // Flash will be fired automatically when required. The flash may be fired // during preview, auto-focus, or snapshot depending on the driver. static const char FLASH_MODE_AUTO[]; // Flash will always be fired during snapshot. The flash may also be // fired during preview or auto-focus depending on the driver. static const char FLASH_MODE_ON[]; // Flash will be fired in red-eye reduction mode. static const char FLASH_MODE_RED_EYE[]; // Constant emission of light during preview, auto-focus and snapshot. // This can also be used for video recording. static const char FLASH_MODE_TORCH[]; // Values for scene mode settings. static const char SCENE_MODE_AUTO[]; static const char SCENE_MODE_ACTION[]; static const char SCENE_MODE_PORTRAIT[]; static const char SCENE_MODE_LANDSCAPE[]; static const char SCENE_MODE_NIGHT[]; static const char SCENE_MODE_NIGHT_PORTRAIT[]; static const char SCENE_MODE_THEATRE[]; static const char SCENE_MODE_BEACH[]; static const char SCENE_MODE_SNOW[]; static const char SCENE_MODE_SUNSET[]; static const char SCENE_MODE_STEADYPHOTO[]; static const char SCENE_MODE_FIREWORKS[]; static const char SCENE_MODE_SPORTS[]; static const char SCENE_MODE_PARTY[]; static const char SCENE_MODE_CANDLELIGHT[]; // Formats for setPreviewFormat and setPictureFormat. static const char PIXEL_FORMAT_YUV422SP[]; static const char PIXEL_FORMAT_YUV420SP[]; // NV21 static const char PIXEL_FORMAT_YUV422I[]; // YUY2 static const char PIXEL_FORMAT_RGB565[]; static const char PIXEL_FORMAT_JPEG[]; // Values for focus mode settings. // Auto-focus mode. static const char FOCUS_MODE_AUTO[]; // Focus is set at infinity. Applications should not call // CameraHardwareInterface.autoFocus in this mode. static const char FOCUS_MODE_INFINITY[]; static const char FOCUS_MODE_MACRO[]; // Focus is fixed. The camera is always in this mode if the focus is not // adjustable. If the camera has auto-focus, this mode can fix the // focus, which is usually at hyperfocal distance. Applications should // not call CameraHardwareInterface.autoFocus in this mode. static const char FOCUS_MODE_FIXED[]; private: DefaultKeyedVector mMap; }; }; // namespace android #endif