274 lines
12 KiB
C++
274 lines
12 KiB
C++
/*
|
|
* 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 <utils/KeyedVector.h>
|
|
#include <utils/String8.h>
|
|
|
|
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<String16>& 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<String8,String8> mMap;
|
|
};
|
|
|
|
}; // namespace android
|
|
|
|
#endif
|