Camera.java revision c157e0cd161e5b3b28b72bafebb3360ed856a608
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2008 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.hardware; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1965c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkeyimport java.lang.ref.WeakReference; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.util.ArrayList; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.util.HashMap; 2265c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkeyimport java.util.List; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.util.StringTokenizer; 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.io.IOException; 2565c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.Log; 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.view.Surface; 280f28af209ac877091f4a096f7553f02a0b401596Jesse Wilsonimport android.view.SurfaceHolder; 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.graphics.ImageFormat; 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Handler; 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Looper; 3258a345936d7e2b66bdeefb492e4f777754792d7eBen Dodsonimport android.os.Message; 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 34ccae412deda8b0c165c86f395752c0667a3411a6Nick Pelly/** 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The Camera class is used to set image capture settings, start/stop preview, 3658a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * snap pictures, and retrieve frames for encoding for video. This class is a 370f28af209ac877091f4a096f7553f02a0b401596Jesse Wilson * client for the Camera service, which manages the actual camera hardware. 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>To access the device camera, you must declare the 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.Manifest.permission#CAMERA} permission in your Android 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Manifest. Also be sure to include the 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <a href="{@docRoot}guide/topics/manifest/uses-feature-element.html"><uses-feature></a> 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * manifest element to declare camera features used by your application. 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * For example, if you use the camera and auto-focus feature, your Manifest 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * should include the following:</p> 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <pre> <uses-permission android:name="android.permission.CAMERA" /> 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <uses-feature android:name="android.hardware.camera" /> 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <uses-feature android:name="android.hardware.camera.autofocus" /></pre> 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>To take pictures with this class, use the following steps:</p> 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ol> 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Obtain an instance of Camera from {@link #open(int)}. 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5558a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * <li>Get existing (default) settings with {@link #getParameters()}. 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>If necessary, modify the returned {@link Camera.Parameters} object and call 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setParameters(Camera.Parameters)}. 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>If desired, call {@link #setDisplayOrientation(int)}. 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li><b>Important</b>: Pass a fully initialized {@link SurfaceHolder} to 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setPreviewDisplay(SurfaceHolder)}. Without a surface, the camera 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be unable to start the preview. 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li><b>Important</b>: Call {@link #startPreview()} to start updating the 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * preview surface. Preview must be started before you can take a picture. 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>When you want, call {@link #takePicture(Camera.ShutterCallback, 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Camera.PictureCallback, Camera.PictureCallback, Camera.PictureCallback)} to 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * capture a photo. Wait for the callbacks to provide the actual image data. 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>After taking a picture, preview display will have stopped. To take more 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * photos, call {@link #startPreview()} again first. 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Call {@link #stopPreview()} to stop updating the preview surface. 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li><b>Important:</b> Call {@link #release()} to release the camera for 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * use by other applications. Applications should release the camera 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * immediately in {@link android.app.Activity#onPause()} (and re-{@link #open()} 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it in {@link android.app.Activity#onResume()}). 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ol> 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>To quickly switch to video recording mode, use these steps:</p> 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ol> 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Obtain and initialize a Camera and start preview as described above. 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Call {@link #unlock()} to allow the media process to access the camera. 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Pass the camera to {@link android.media.MediaRecorder#setCamera(Camera)}. 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See {@link android.media.MediaRecorder} information about video recording. 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>When finished recording, call {@link #reconnect()} to re-acquire 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and re-lock the camera. 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>If desired, restart preview and take more photos or videos. 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Call {@link #stopPreview()} and {@link #release()} as described above. 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ol> 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>This class is not thread-safe, and is meant for use from one event thread. 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Most long-running operations (preview, focus, photo capture, etc) happen 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * asynchronously and invoke callbacks as necessary. Callbacks will be invoked 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * on the event thread {@link #open(int)} was called from. This class's methods 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * must never be called from multiple threads at once.</p> 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p class="caution"><strong>Caution:</strong> Different Android-powered devices 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * may have different hardware specifications, such as megapixel ratings and 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * auto-focus capabilities. In order for your application to be compatible with 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * more devices, you should not make assumptions about the device camera 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specifications.</p> 113a8675f67e33bc7337d148358783b0fd138b501ffJean-Baptiste Queru */ 114a8675f67e33bc7337d148358783b0fd138b501ffJean-Baptiste Querupublic class Camera { 115a8675f67e33bc7337d148358783b0fd138b501ffJean-Baptiste Queru private static final String TAG = "Camera"; 116a8675f67e33bc7337d148358783b0fd138b501ffJean-Baptiste Queru 117a8675f67e33bc7337d148358783b0fd138b501ffJean-Baptiste Queru // These match the enums in frameworks/base/include/camera/Camera.h 118a8675f67e33bc7337d148358783b0fd138b501ffJean-Baptiste Queru private static final int CAMERA_MSG_ERROR = 0x001; 119a8675f67e33bc7337d148358783b0fd138b501ffJean-Baptiste Queru private static final int CAMERA_MSG_SHUTTER = 0x002; 120a8675f67e33bc7337d148358783b0fd138b501ffJean-Baptiste Queru private static final int CAMERA_MSG_FOCUS = 0x004; 121a8675f67e33bc7337d148358783b0fd138b501ffJean-Baptiste Queru private static final int CAMERA_MSG_ZOOM = 0x008; 122a8675f67e33bc7337d148358783b0fd138b501ffJean-Baptiste Queru private static final int CAMERA_MSG_PREVIEW_FRAME = 0x010; 123a8675f67e33bc7337d148358783b0fd138b501ffJean-Baptiste Queru private static final int CAMERA_MSG_VIDEO_FRAME = 0x020; 124a8675f67e33bc7337d148358783b0fd138b501ffJean-Baptiste Queru private static final int CAMERA_MSG_POSTVIEW_FRAME = 0x040; 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int CAMERA_MSG_RAW_IMAGE = 0x080; 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int CAMERA_MSG_COMPRESSED_IMAGE = 0x100; 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int CAMERA_MSG_ALL_MSGS = 0x1FF; 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mNativeContext; // accessed by native methods 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private EventHandler mEventHandler; 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private ShutterCallback mShutterCallback; 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private PictureCallback mRawImageCallback; 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private PictureCallback mJpegCallback; 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private PreviewCallback mPreviewCallback; 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private PictureCallback mPostviewCallback; 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private AutoFocusCallback mAutoFocusCallback; 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private OnZoomChangeListener mZoomListener; 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private ErrorCallback mErrorCallback; 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mOneShot; 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mWithBuffer; 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the number of physical cameras available on this device. 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native static int getNumberOfCameras(); 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the information about a particular camera. 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If {@link #getNumberOfCameras()} returns N, the valid id is 0 to N-1. 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native static void getCameraInfo(int cameraId, CameraInfo cameraInfo); 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Information about a camera 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static class CameraInfo { 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The facing of the camera is opposite to that of the screen. 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int CAMERA_FACING_BACK = 0; 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The facing of the camera is the same as that of the screen. 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int CAMERA_FACING_FRONT = 1; 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The direction that the camera faces to. It should be 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * CAMERA_FACING_BACK or CAMERA_FACING_FRONT. 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int facing; 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The orientation of the camera image. The value is the angle that the 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * camera image needs to be rotated clockwise so it shows correctly on 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the display in its natural orientation. It should be 0, 90, 180, or 270. 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * For example, suppose a device has a naturally tall screen, but the camera 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sensor is mounted in landscape. If the top side of the camera sensor is 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * aligned with the right edge of the display in natural orientation, the 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * value should be 90. 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setDisplayOrientation(int) 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRotation(int) 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int orientation; 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creates a new Camera object to access a particular hardware camera. 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>You must call {@link #release()} when you are done using the camera, 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * otherwise it will remain locked and be unavailable to other applications. 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Your application should only have one Camera object active at a time 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * for a particular hardware camera. 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Callbacks from other methods are delivered to the event loop of the 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * thread which called open(). If this thread has no event loop, then 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * callbacks are delivered to the main application event loop. If there 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no main application event loop, callbacks are not delivered. 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p class="caution"><b>Caution:</b> On some devices, this method may 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * take a long time to complete. It is best to call this method from a 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * worker thread (possibly using {@link android.os.AsyncTask}) to avoid 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * blocking the main application UI thread. 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cameraId the hardware camera to access, between 0 and 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getNumberOfCameras()}-1. Use {@link #CAMERA_ID_DEFAULT} 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to access the default camera. 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a new Camera object, connected, locked and ready for use. 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws RuntimeException if connection to the camera service fails (for 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * example, if the camera is in use by another process). 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Camera open(int cameraId) { 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new Camera(cameraId); 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The id for the default camera. 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #open(int) 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int CAMERA_ID_DEFAULT = 0; 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Equivalent to Camera.open(Camera.CAMERA_ID_DEFAULT). 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creates a new Camera object to access the default camera. 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #open(int) 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Camera open() { 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new Camera(CAMERA_ID_DEFAULT); 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Camera(int cameraId) { 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mShutterCallback = null; 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRawImageCallback = null; 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mJpegCallback = null; 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPreviewCallback = null; 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPostviewCallback = null; 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mZoomListener = null; 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Looper looper; 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((looper = Looper.myLooper()) != null) { 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mEventHandler = new EventHandler(this, looper); 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if ((looper = Looper.getMainLooper()) != null) { 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mEventHandler = new EventHandler(this, looper); 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mEventHandler = null; 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_setup(new WeakReference<Camera>(this), cameraId); 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void finalize() { 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_release(); 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_setup(Object camera_this, int cameraId); 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_release(); 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Disconnects and releases the Camera object resources. 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>You must call this as soon as you're done with the Camera object.</p> 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void release() { 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_release(); 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unlocks the camera to allow another process to access it. 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Normally, the camera is locked to the process with an active Camera 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * object until {@link #release()} is called. To allow rapid handoff 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * between processes, you can call this method to release the camera 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * temporarily for another process to use; once the other process is done 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you can call {@link #reconnect()} to reclaim the camera. 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>This must be done before calling 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.media.MediaRecorder#setCamera(Camera)}. 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>If you are not recording video, you probably do not need this method. 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws RuntimeException if the camera cannot be unlocked. 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native final void unlock(); 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Re-locks the camera to prevent other processes from accessing it. 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Camera objects are locked by default unless {@link #unlock()} is 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * called. Normally {@link #reconnect()} is used instead. 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>If you are not recording video, you probably do not need this method. 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws RuntimeException if the camera cannot be re-locked (for 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * example, if the camera is still in use by another process). 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native final void lock(); 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reconnects to the camera service after another process used it. 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * After {@link #unlock()} is called, another process may use the 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * camera; when the process is done, you must reconnect to the camera, 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * which will re-acquire the lock and allow you to continue using the 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * camera. 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>This must be done after {@link android.media.MediaRecorder} is 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * done recording if {@link android.media.MediaRecorder#setCamera(Camera)} 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * was used. 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>If you are not recording video, you probably do not need this method. 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IOException if a connection cannot be re-established (for 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * example, if the camera is still in use by another process). 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native final void reconnect() throws IOException; 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the {@link Surface} to be used for live preview. 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * A surface is necessary for preview, and preview is necessary to take 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * pictures. The same surface can be re-set without harm. 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>The {@link SurfaceHolder} must already contain a surface when this 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * method is called. If you are using {@link android.view.SurfaceView}, 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you will need to register a {@link SurfaceHolder.Callback} with 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link SurfaceHolder#addCallback(SurfaceHolder.Callback)} and wait for 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link SurfaceHolder.Callback#surfaceCreated(SurfaceHolder)} before 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * calling setPreviewDisplay() or starting preview. 3299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>This method must be called before {@link #startPreview()}. The 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * one exception is that if the preview surface is not set (or set to null) 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * before startPreview() is called, then this method may be called once 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * with a non-null parameter to set the preview surface. (This allows 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * camera setup and surface creation to happen in parallel, saving time.) 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The preview surface may not otherwise change while preview is running. 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param holder containing the Surface on which to place the preview, 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or null to remove the preview surface 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IOException if the method fails (for example, if the surface 3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is unavailable or unsuitable). 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void setPreviewDisplay(SurfaceHolder holder) throws IOException { 3439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (holder != null) { 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setPreviewDisplay(holder.getSurface()); 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setPreviewDisplay((Surface)null); 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void setPreviewDisplay(Surface surface); 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Callback interface used to deliver copies of preview frames as 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * they are displayed. 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setPreviewCallback(Camera.PreviewCallback) 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setOneShotPreviewCallback(Camera.PreviewCallback) 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setPreviewCallbackWithBuffer(Camera.PreviewCallback) 35990c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn * @see #startPreview() 36090c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn */ 36190c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn public interface PreviewCallback 36290c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn { 36390c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn /** 36490c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn * Called as preview frames are displayed. This callback is invoked 36590c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn * on the event thread {@link #open(int)} was called from. 36690c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn * 36790c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn * @param data the contents of the preview frame in the format defined 36890c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn * by {@link android.graphics.ImageFormat}, which can be queried 36990c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn * with {@link android.hardware.Camera.Parameters#getPreviewFormat()}. 37090c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn * If {@link android.hardware.Camera.Parameters#setPreviewFormat(int)} 37190c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn * is never called, the default will be the YCbCr_420_SP 37290c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn * (NV21) format. 37390c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn * @param camera the Camera service object. 37490c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn */ 37590c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn void onPreviewFrame(byte[] data, Camera camera); 37690c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn }; 37790c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn 37890c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn /** 37990c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn * Starts capturing and drawing preview frames to the screen. 38090c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn * Preview will not actually start until a surface is supplied with 38190c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn * {@link #setPreviewDisplay(SurfaceHolder)}. 38290c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn * 38390c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn * <p>If {@link #setPreviewCallback(Camera.PreviewCallback)}, 38490c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn * {@link #setOneShotPreviewCallback(Camera.PreviewCallback)}, or 38590c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn * {@link #setPreviewCallbackWithBuffer(Camera.PreviewCallback)} were 38690c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn * called, {@link Camera.PreviewCallback#onPreviewFrame(byte[], Camera)} 38790c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn * will be called when preview data becomes available. 38890c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn */ 38990c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn public native final void startPreview(); 39090c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn 39190c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn /** 39290c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn * Stops capturing and drawing preview frames to the surface, and 39390c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn * resets the camera for a future call to {@link #startPreview()}. 39490c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn */ 39590c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn public native final void stopPreview(); 39690c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn 39790c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn /** 39890c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn * Return current preview state. 39990c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn * 40090c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn * FIXME: Unhide before release 4019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native final boolean previewEnabled(); 4049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Installs a callback to be invoked for every preview frame in addition 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to displaying them on the screen. The callback will be repeatedly called 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * for as long as preview is active. This method can be called at any time, 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * even while preview is live. Any other preview callbacks are overridden. 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cb a callback object that receives a copy of each preview frame, 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or null to stop receiving callbacks. 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void setPreviewCallback(PreviewCallback cb) { 4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPreviewCallback = cb; 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mOneShot = false; 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mWithBuffer = false; 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Always use one-shot mode. We fake camera preview mode by 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // doing one-shot preview continuously. 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setHasPreviewCallback(cb != null, false); 4219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4248aa393b03f6d1f25313c658334e9b86a86a6f61fSimon Schoar * Installs a callback to be invoked for the next preview frame in addition 4259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to displaying it on the screen. After one invocation, the callback is 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * cleared. This method can be called any time, even when preview is live. 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Any other preview callbacks are overridden. 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cb a callback object that receives a copy of the next preview frame, 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or null to stop receiving callbacks. 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void setOneShotPreviewCallback(PreviewCallback cb) { 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPreviewCallback = cb; 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mOneShot = true; 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mWithBuffer = false; 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setHasPreviewCallback(cb != null, false); 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void setHasPreviewCallback(boolean installed, boolean manualBuffer); 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Installs a callback to be invoked for every preview frame, using buffers 4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * supplied with {@link #addCallbackBuffer(byte[])}, in addition to 4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * displaying them on the screen. The callback will be repeatedly called 4459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * for as long as preview is active and buffers are available. 4469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Any other preview callbacks are overridden. 4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>The purpose of this method is to improve preview efficiency and frame 4499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * rate by allowing preview frame memory reuse. You must call 4509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #addCallbackBuffer(byte[])} at some point -- before or after 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * calling this method -- or no callbacks will received. 4529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The buffer queue will be cleared if this method is called with a null 4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * callback, {@link #setPreviewCallback(Camera.PreviewCallback)} is called, 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or {@link #setOneShotPreviewCallback(Camera.PreviewCallback)} is called. 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cb a callback object that receives a copy of the preview frame, 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or null to stop receiving callbacks and clear the buffer queue. 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #addCallbackBuffer(byte[]) 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void setPreviewCallbackWithBuffer(PreviewCallback cb) { 4629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPreviewCallback = cb; 4639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mOneShot = false; 4649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mWithBuffer = true; 4659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setHasPreviewCallback(cb != null, true); 4669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Adds a pre-allocated buffer to the preview callback buffer queue. 4709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Applications can add one or more buffers to the queue. When a preview 4719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * frame arrives and there is still at least one available buffer, the 4729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * buffer will be used and removed from the queue. Then preview callback is 4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * invoked with the buffer. If a frame arrives and there is no buffer left, 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the frame is discarded. Applications should add buffers back when they 4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * finish processing the data in them. 4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>The size of the buffer is determined by multiplying the preview 4789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * image width, height, and bytes per pixel. The width and height can be 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * read from {@link Camera.Parameters#getPreviewSize()}. Bytes per pixel 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * can be computed from 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.graphics.ImageFormat#getBitsPerPixel(int)} / 8, 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * using the image format from {@link Camera.Parameters#getPreviewFormat()}. 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>This method is only necessary when 4859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setPreviewCallbackWithBuffer(PreviewCallback)} is used. When 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setPreviewCallback(PreviewCallback)} or 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setOneShotPreviewCallback(PreviewCallback)} are used, buffers 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are automatically allocated. 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param callbackBuffer the buffer to add to the queue. 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The size should be width * height * bits_per_pixel / 8. 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setPreviewCallbackWithBuffer(PreviewCallback) 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native final void addCallbackBuffer(byte[] callbackBuffer); 4959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private class EventHandler extends Handler 4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private Camera mCamera; 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public EventHandler(Camera c, Looper looper) { 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super(looper); 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mCamera = c; 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 5069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void handleMessage(Message msg) { 5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project switch(msg.what) { 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case CAMERA_MSG_SHUTTER: 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mShutterCallback != null) { 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mShutterCallback.onShutter(); 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case CAMERA_MSG_RAW_IMAGE: 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRawImageCallback != null) { 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRawImageCallback.onPictureTaken((byte[])msg.obj, mCamera); 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case CAMERA_MSG_COMPRESSED_IMAGE: 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mJpegCallback != null) { 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mJpegCallback.onPictureTaken((byte[])msg.obj, mCamera); 5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case CAMERA_MSG_PREVIEW_FRAME: 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mPreviewCallback != null) { 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project PreviewCallback cb = mPreviewCallback; 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mOneShot) { 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Clear the callback variable before the callback 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // in case the app calls setPreviewCallback from 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // the callback function 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPreviewCallback = null; 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (!mWithBuffer) { 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // We're faking the camera preview mode to prevent 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // the app from being flooded with preview frames. 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Set to oneshot mode again. 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setHasPreviewCallback(true, false); 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project cb.onPreviewFrame((byte[])msg.obj, mCamera); 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case CAMERA_MSG_POSTVIEW_FRAME: 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mPostviewCallback != null) { 5469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPostviewCallback.onPictureTaken((byte[])msg.obj, mCamera); 5479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 5499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case CAMERA_MSG_FOCUS: 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mAutoFocusCallback != null) { 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mAutoFocusCallback.onAutoFocus(msg.arg1 == 0 ? false : true, mCamera); 5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case CAMERA_MSG_ZOOM: 5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mZoomListener != null) { 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mZoomListener.onZoomChange(msg.arg1, msg.arg2 != 0, mCamera); 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case CAMERA_MSG_ERROR : 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Error " + msg.arg1); 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mErrorCallback != null) { 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mErrorCallback.onError(msg.arg1, mCamera); 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project default: 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Unknown message type " + msg.what); 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void postEventFromNative(Object camera_ref, 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int what, int arg1, int arg2, Object obj) 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Camera c = (Camera)((WeakReference)camera_ref).get(); 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (c == null) 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (c.mEventHandler != null) { 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Message m = c.mEventHandler.obtainMessage(what, arg1, arg2, obj); 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project c.mEventHandler.sendMessage(m); 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Callback interface used to notify on completion of camera auto focus. 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Devices that do not support auto-focus will receive a "fake" 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * callback to this interface. If your application needs auto-focus and 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * should not be installed on devices <em>without</em> auto-focus, you must 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * declare that your app uses the 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@code android.hardware.camera.autofocus} feature, in the 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <a href="{@docRoot}guide/topics/manifest/uses-feature-element.html"><uses-feature></a> 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * manifest element.</p> 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #autoFocus(AutoFocusCallback) 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public interface AutoFocusCallback 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when the camera auto focus completes. If the camera does not 6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * support auto-focus and autoFocus is called, onAutoFocus will be 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * called immediately with success. 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param success true if focus was successful, false if otherwise 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param camera the Camera service object 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onAutoFocus(boolean success, Camera camera); 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Starts camera auto-focus and registers a callback function to run when 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the camera is focused. This method is only valid when preview is active 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (between {@link #startPreview()} and before {@link #stopPreview()}). 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Callers should check 6219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.hardware.Camera.Parameters#getFocusMode()} to determine if 6229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this method should be called. If the camera does not support auto-focus, 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it is a no-op and {@link AutoFocusCallback#onAutoFocus(boolean, Camera)} 6249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * callback will be called immediately. 6259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>If your application should not be installed 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * on devices without auto-focus, you must declare that your application 6289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * uses auto-focus with the 6299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <a href="{@docRoot}guide/topics/manifest/uses-feature-element.html"><uses-feature></a> 6309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * manifest element.</p> 6319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>If the current flash mode is not 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.hardware.Camera.Parameters#FLASH_MODE_OFF}, flash may be 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * fired during auto-focus, depending on the driver and camera hardware.<p> 6359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cb the callback to run 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #cancelAutoFocus() 6389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void autoFocus(AutoFocusCallback cb) 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 6419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mAutoFocusCallback = cb; 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_autoFocus(); 6439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_autoFocus(); 6459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Cancels any auto-focus function in progress. 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Whether or not auto-focus is currently in progress, 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this function will return the focus position to the default. 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If the camera does not support auto-focus, this is a no-op. 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #autoFocus(Camera.AutoFocusCallback) 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void cancelAutoFocus() 6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 6569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mAutoFocusCallback = null; 6579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_cancelAutoFocus(); 6589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_cancelAutoFocus(); 6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Callback interface used to signal the moment of actual image capture. 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #takePicture(ShutterCallback, PictureCallback, PictureCallback, PictureCallback) 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public interface ShutterCallback 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 6689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called as near as possible to the moment when a photo is captured 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * from the sensor. This is a good opportunity to play a shutter sound 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or give other feedback of camera operation. This may be some time 6729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * after the photo was triggered, but some time before the actual data 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is available. 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onShutter(); 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Callback interface used to supply image data from a photo capture. 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #takePicture(ShutterCallback, PictureCallback, PictureCallback, PictureCallback) 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public interface PictureCallback { 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when image data is available after a picture is taken. 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The format of the data depends on the context of the callback 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and {@link Camera.Parameters} settings. 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param data a byte array of the picture data 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param camera the Camera service object 6919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onPictureTaken(byte[] data, Camera camera); 6939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Equivalent to takePicture(shutter, raw, null, jpeg). 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #takePicture(ShutterCallback, PictureCallback, PictureCallback, PictureCallback) 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void takePicture(ShutterCallback shutter, PictureCallback raw, 7019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project PictureCallback jpeg) { 7029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project takePicture(shutter, raw, null, jpeg); 7039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_takePicture(); 7059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Triggers an asynchronous image capture. The camera service will initiate 7089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a series of callbacks to the application as the image capture progresses. 7099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The shutter callback occurs after the image is captured. This can be used 7109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to trigger a sound to let the user know that image has been captured. The 7119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * raw callback occurs when the raw image data is available (NOTE: the data 7129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * may be null if the hardware does not have enough memory to make a copy). 7139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The postview callback occurs when a scaled, fully processed postview 7149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * image is available (NOTE: not all hardware supports this). The jpeg 7159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * callback occurs when the compressed image is available. If the 7169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * application does not need a particular callback, a null can be passed 7179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * instead of a callback method. 7189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>This method is only valid when preview is active (after 7209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #startPreview()}). Preview will be stopped after the image is 7219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * taken; callers must call {@link #startPreview()} again if they want to 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * re-start preview or take more pictures. 7239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>After calling this method, you must not call {@link #startPreview()} 7259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or take another picture until the JPEG callback has returned. 7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param shutter the callback for image capture moment, or null 7289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param raw the callback for raw (uncompressed) image data, or null 7299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param postview callback with postview image data, may be null 7309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param jpeg the callback for JPEG image data, or null 7319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void takePicture(ShutterCallback shutter, PictureCallback raw, 7339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project PictureCallback postview, PictureCallback jpeg) { 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mShutterCallback = shutter; 7359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRawImageCallback = raw; 7369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPostviewCallback = postview; 7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mJpegCallback = jpeg; 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_takePicture(); 7399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Zooms to the requested value smoothly. The driver will notify {@link 7439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * OnZoomChangeListener} of the zoom value and whether zoom is stopped at 7449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the time. For example, suppose the current zoom is 0 and startSmoothZoom 7459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is called with value 3. The 7469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Camera.OnZoomChangeListener#onZoomChange(int, boolean, Camera)} 7479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * method will be called three times with zoom values 1, 2, and 3. 7489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Applications can call {@link #stopSmoothZoom} to stop the zoom earlier. 7499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Applications should not call startSmoothZoom again or change the zoom 7509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * value before zoom stops. If the supplied zoom value equals to the current 7519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * zoom value, no zoom callback will be generated. This method is supported 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if {@link android.hardware.Camera.Parameters#isSmoothZoomSupported} 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * returns true. 7549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param value zoom value. The valid range is 0 to {@link 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * android.hardware.Camera.Parameters#getMaxZoom}. 7579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if the zoom value is invalid. 7589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws RuntimeException if the method fails. 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setZoomChangeListener(OnZoomChangeListener) 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native final void startSmoothZoom(int value); 7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Stops the smooth zoom. Applications should wait for the {@link 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * OnZoomChangeListener} to know when the zoom is actually stopped. This 7669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * method is supported if {@link 7679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * android.hardware.Camera.Parameters#isSmoothZoomSupported} is true. 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws RuntimeException if the method fails. 7709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native final void stopSmoothZoom(); 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set the display orientation. This affects the preview frames and the 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * picture displayed after snapshot. This method is useful for portrait 7769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * mode applications. 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This does not affect the order of byte array passed in 7799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link PreviewCallback#onPreviewFrame}. This method is not allowed to 7809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be called during preview. 7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If you want to make the camera image show in the same orientation as 7839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the display, you can use the following code.<p> 7849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <pre> 7859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * public static void setCameraDisplayOrientation(Activity activity, 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * int cameraId, android.hardware.Camera camera) { 7879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * android.hardware.Camera.CameraInfo info = 7889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * new android.hardware.Camera.CameraInfo(); 7899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * android.hardware.Camera.getCameraInfo(cameraId, info); 7909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * int rotation = activity.getWindowManager().getDefaultDisplay() 7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * .getRotation(); 7929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * int degrees = 0; 7939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * switch (rotation) { 7949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * case Surface.ROTATION_0: degrees = 0; break; 7959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * case Surface.ROTATION_90: degrees = 90; break; 7969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * case Surface.ROTATION_180: degrees = 180; break; 7979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * case Surface.ROTATION_270: degrees = 270; break; 7989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * } 7999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * int result = (info.orientation - degrees + 360) % 360; 8019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * camera.setDisplayOrientation(result); 8029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * } 8039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </pre> 8049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param degrees the angle that the picture will be rotated clockwise. 8059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Valid values are 0, 90, 180, and 270. The starting 8069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * position is 0 (landscape). 8079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native final void setDisplayOrientation(int degrees); 8099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Callback interface for zoom changes during a smooth zoom operation. 8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setZoomChangeListener(OnZoomChangeListener) 8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #startSmoothZoom(int) 8159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public interface OnZoomChangeListener 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 8189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when the zoom value has changed during a smooth zoom. 8209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param zoomValue the current zoom value. In smooth zoom mode, camera 8229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * calls this for every new zoom value. 8239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param stopped whether smooth zoom is stopped. If the value is true, 8249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this is the last zoom update for the application. 8259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param camera the Camera service object 8269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onZoomChange(int zoomValue, boolean stopped, Camera camera); 8289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 8299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Registers a listener to be notified when the zoom value is updated by the 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * camera driver during smooth zoom. 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param listener the listener to notify 8359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #startSmoothZoom(int) 8369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void setZoomChangeListener(OnZoomChangeListener listener) 8389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 8399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mZoomListener = listener; 8409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Error codes match the enum in include/ui/Camera.h 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unspecified camera error. 8469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see Camera.ErrorCallback 8479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int CAMERA_ERROR_UNKNOWN = 1; 8499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Media server died. In this case, the application must release the 8529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Camera object and instantiate a new one. 8539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see Camera.ErrorCallback 8549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int CAMERA_ERROR_SERVER_DIED = 100; 8569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Callback interface for camera error notification. 8599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setErrorCallback(ErrorCallback) 8619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public interface ErrorCallback 8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Callback for camera errors. 8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param error error code: 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 8689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>{@link #CAMERA_ERROR_UNKNOWN} 8699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>{@link #CAMERA_ERROR_SERVER_DIED} 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param camera the Camera service object 8729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onError(int error, Camera camera); 8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 8759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Registers a callback to be invoked when an error occurs. 8789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cb The callback to run 8799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void setErrorCallback(ErrorCallback cb) 8819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 8829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mErrorCallback = cb; 8839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_setParameters(String params); 8869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final String native_getParameters(); 8879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Changes the settings for this Camera service. 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param params the Parameters to use for this Camera service 8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getParameters() 8939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setParameters(Parameters params) { 8959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_setParameters(params.flatten()); 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current settings for this Camera service. 9009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If modifications are made to the returned Parameters, they must be passed 9019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to {@link #setParameters(Camera.Parameters)} to take effect. 9029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setParameters(Camera.Parameters) 9049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Parameters getParameters() { 9069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Parameters p = new Parameters(); 9079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String s = native_getParameters(); 9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project p.unflatten(s); 9099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return p; 9109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Image size (width and height dimensions). 9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public class Size { 9169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the dimensions for pictures. 9189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param w the photo width (pixels) 9209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param h the photo height (pixels) 9219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Size(int w, int h) { 9239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project width = w; 9249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project height = h; 9259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Compares {@code obj} to this size. 9289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param obj the object to compare this size with. 9309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the width and height of {@code obj} is the 9319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * same as those of this size. {@code false} otherwise. 9329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 9349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean equals(Object obj) { 9359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!(obj instanceof Size)) { 9369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 9379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Size s = (Size) obj; 9399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return width == s.width && height == s.height; 9409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 9429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int hashCode() { 9439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return width * 32713 + height; 9449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** width of the picture */ 9469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int width; 9479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** height of the picture */ 9489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int height; 9499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 9509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Camera service settings. 9539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>To make camera parameters take effect, applications have to call 9559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Camera#setParameters(Camera.Parameters)}. For example, after 9569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Camera.Parameters#setWhiteBalance} is called, white balance is not 9579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * actually changed until {@link Camera#setParameters(Camera.Parameters)} 9589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is called with the changed parameters object. 9599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Different devices may have different camera capabilities, such as 9619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * picture size or flash modes. The application should query the camera 9629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * capabilities before setting parameters. For example, the application 9639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * should call {@link Camera.Parameters#getSupportedColorEffects()} before 9649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * calling {@link Camera.Parameters#setColorEffect(String)}. If the 9659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * camera does not support color effects, 9669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Camera.Parameters#getSupportedColorEffects()} will return null. 9679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public class Parameters { 9699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Parameter keys to communicate with the camera driver. 9709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_PREVIEW_SIZE = "preview-size"; 9719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_PREVIEW_FORMAT = "preview-format"; 9729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_PREVIEW_FRAME_RATE = "preview-frame-rate"; 9739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_PREVIEW_FPS_RANGE = "preview-fps-range"; 9749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_PICTURE_SIZE = "picture-size"; 9759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_PICTURE_FORMAT = "picture-format"; 9769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_JPEG_THUMBNAIL_SIZE = "jpeg-thumbnail-size"; 9779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_JPEG_THUMBNAIL_WIDTH = "jpeg-thumbnail-width"; 9789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_JPEG_THUMBNAIL_HEIGHT = "jpeg-thumbnail-height"; 9799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_JPEG_THUMBNAIL_QUALITY = "jpeg-thumbnail-quality"; 9809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_JPEG_QUALITY = "jpeg-quality"; 9819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_ROTATION = "rotation"; 9829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_GPS_LATITUDE = "gps-latitude"; 9839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_GPS_LONGITUDE = "gps-longitude"; 9849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_GPS_ALTITUDE = "gps-altitude"; 9859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_GPS_TIMESTAMP = "gps-timestamp"; 9869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_GPS_PROCESSING_METHOD = "gps-processing-method"; 9879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_WHITE_BALANCE = "whitebalance"; 9889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_EFFECT = "effect"; 9899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_ANTIBANDING = "antibanding"; 9909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_SCENE_MODE = "scene-mode"; 9919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_FLASH_MODE = "flash-mode"; 9929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_FOCUS_MODE = "focus-mode"; 9939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_FOCAL_LENGTH = "focal-length"; 9949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_HORIZONTAL_VIEW_ANGLE = "horizontal-view-angle"; 9959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_VERTICAL_VIEW_ANGLE = "vertical-view-angle"; 9969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_EXPOSURE_COMPENSATION = "exposure-compensation"; 9979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_MAX_EXPOSURE_COMPENSATION = "max-exposure-compensation"; 9989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_MIN_EXPOSURE_COMPENSATION = "min-exposure-compensation"; 9999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_EXPOSURE_COMPENSATION_STEP = "exposure-compensation-step"; 10009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_ZOOM = "zoom"; 10019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_MAX_ZOOM = "max-zoom"; 10029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_ZOOM_RATIOS = "zoom-ratios"; 10039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_ZOOM_SUPPORTED = "zoom-supported"; 10049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_SMOOTH_ZOOM_SUPPORTED = "smooth-zoom-supported"; 10059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String KEY_FOCUS_DISTANCES = "focus-distances"; 10069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Parameter key suffix for supported values. 10089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String SUPPORTED_VALUES_SUFFIX = "-values"; 10099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String TRUE = "true"; 10119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Values for white balance settings. 10139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String WHITE_BALANCE_AUTO = "auto"; 10149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String WHITE_BALANCE_INCANDESCENT = "incandescent"; 10159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String WHITE_BALANCE_FLUORESCENT = "fluorescent"; 10169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String WHITE_BALANCE_WARM_FLUORESCENT = "warm-fluorescent"; 10179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String WHITE_BALANCE_DAYLIGHT = "daylight"; 10189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String WHITE_BALANCE_CLOUDY_DAYLIGHT = "cloudy-daylight"; 10199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String WHITE_BALANCE_TWILIGHT = "twilight"; 10209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String WHITE_BALANCE_SHADE = "shade"; 10219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Values for color effect settings. 10239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EFFECT_NONE = "none"; 10249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EFFECT_MONO = "mono"; 10259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EFFECT_NEGATIVE = "negative"; 10269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EFFECT_SOLARIZE = "solarize"; 10279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EFFECT_SEPIA = "sepia"; 10289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EFFECT_POSTERIZE = "posterize"; 10299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EFFECT_WHITEBOARD = "whiteboard"; 10309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EFFECT_BLACKBOARD = "blackboard"; 10319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EFFECT_AQUA = "aqua"; 10329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Values for antibanding settings. 10349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String ANTIBANDING_AUTO = "auto"; 10359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String ANTIBANDING_50HZ = "50hz"; 10369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String ANTIBANDING_60HZ = "60hz"; 10379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String ANTIBANDING_OFF = "off"; 10389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Values for flash mode settings. 10409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Flash will not be fired. 10429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String FLASH_MODE_OFF = "off"; 10449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Flash will be fired automatically when required. The flash may be fired 10479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * during preview, auto-focus, or snapshot depending on the driver. 10489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String FLASH_MODE_AUTO = "auto"; 10509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Flash will always be fired during snapshot. The flash may also be 10539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * fired during preview or auto-focus depending on the driver. 10549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String FLASH_MODE_ON = "on"; 10569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Flash will be fired in red-eye reduction mode. 10599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String FLASH_MODE_RED_EYE = "red-eye"; 10619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Constant emission of light during preview, auto-focus and snapshot. 10649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This can also be used for video recording. 10659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String FLASH_MODE_TORCH = "torch"; 10679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Scene mode is off. 10709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SCENE_MODE_AUTO = "auto"; 10729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Take photos of fast moving objects. Same as {@link 10759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * #SCENE_MODE_SPORTS}. 10769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SCENE_MODE_ACTION = "action"; 1078fc01794f33057862a361a0d0113630c58befc21bKenny Root 10799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Take people pictures. 10819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SCENE_MODE_PORTRAIT = "portrait"; 10839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Take pictures on distant objects. 10869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1087fc01794f33057862a361a0d0113630c58befc21bKenny Root public static final String SCENE_MODE_LANDSCAPE = "landscape"; 10889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1090fc01794f33057862a361a0d0113630c58befc21bKenny Root * Take photos at night. 1091fc01794f33057862a361a0d0113630c58befc21bKenny Root */ 10929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SCENE_MODE_NIGHT = "night"; 10939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Take people pictures at night. 10969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SCENE_MODE_NIGHT_PORTRAIT = "night-portrait"; 10989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Take photos in a theater. Flash light is off. 11019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SCENE_MODE_THEATRE = "theatre"; 1103fc01794f33057862a361a0d0113630c58befc21bKenny Root 11049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Take pictures on the beach. 11069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SCENE_MODE_BEACH = "beach"; 11089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Take pictures on the snow. 11119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SCENE_MODE_SNOW = "snow"; 11139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Take sunset photos. 11169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1117fc01794f33057862a361a0d0113630c58befc21bKenny Root public static final String SCENE_MODE_SUNSET = "sunset"; 11189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Avoid blurry pictures (for example, due to hand shake). 11219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SCENE_MODE_STEADYPHOTO = "steadyphoto"; 11239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * For shooting firework displays. 11269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SCENE_MODE_FIREWORKS = "fireworks"; 11289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Take photos of fast moving objects. Same as {@link 11319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * #SCENE_MODE_ACTION}. 11329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SCENE_MODE_SPORTS = "sports"; 11349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1135a8675f67e33bc7337d148358783b0fd138b501ffJean-Baptiste Queru /** 11369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Take indoor low-light shot. 11379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SCENE_MODE_PARTY = "party"; 11399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Capture the naturally warm color of scenes lit by candles. 11429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SCENE_MODE_CANDLELIGHT = "candlelight"; 1144a8675f67e33bc7337d148358783b0fd138b501ffJean-Baptiste Queru 1145a8675f67e33bc7337d148358783b0fd138b501ffJean-Baptiste Queru /** 1146a8675f67e33bc7337d148358783b0fd138b501ffJean-Baptiste Queru * Applications are looking for a barcode. Camera driver will be 1147a8675f67e33bc7337d148358783b0fd138b501ffJean-Baptiste Queru * optimized for barcode reading. 11489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SCENE_MODE_BARCODE = "barcode"; 11509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Auto-focus mode. Applications should call {@link 11539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * #autoFocus(AutoFocusCallback)} to start the focus in this mode. 11549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String FOCUS_MODE_AUTO = "auto"; 11569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Focus is set at infinity. Applications should not call 11599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #autoFocus(AutoFocusCallback)} in this mode. 11609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String FOCUS_MODE_INFINITY = "infinity"; 11629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Macro (close-up) focus mode. Applications should call 11659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #autoFocus(AutoFocusCallback)} to start the focus in this 11669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * mode. 11679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String FOCUS_MODE_MACRO = "macro"; 11699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Focus is fixed. The camera is always in this mode if the focus is not 11729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * adjustable. If the camera has auto-focus, this mode can fix the 11739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * focus, which is usually at hyperfocal distance. Applications should 11749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not call {@link #autoFocus(AutoFocusCallback)} in this mode. 11759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String FOCUS_MODE_FIXED = "fixed"; 11779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Extended depth of field (EDOF). Focusing is done digitally and 11809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * continuously. Applications should not call {@link 11819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * #autoFocus(AutoFocusCallback)} in this mode. 11829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String FOCUS_MODE_EDOF = "edof"; 11849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Continuous auto focus mode intended for video recording. The camera 11879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * continuously tries to focus. This is ideal for shooting video. 11889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Applications still can call {@link 11899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * #takePicture(Camera.ShutterCallback, Camera.PictureCallback, 11909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Camera.PictureCallback)} in this mode but the subject may not be in 11919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * focus. Auto focus starts when the parameter is set. Applications 11929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * should not call {@link #autoFocus(AutoFocusCallback)} in this mode. 11939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * To stop continuous focus, applications should change the focus mode 11949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to other modes. 11959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String FOCUS_MODE_CONTINUOUS_VIDEO = "continuous-video"; 11979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Indices for focus distance array. 11999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The array index of near focus distance for use with 12019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getFocusDistances(float[])}. 12029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FOCUS_DISTANCE_NEAR_INDEX = 0; 12049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The array index of optimal focus distance for use with 12079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getFocusDistances(float[])}. 12089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FOCUS_DISTANCE_OPTIMAL_INDEX = 1; 1210a8675f67e33bc7337d148358783b0fd138b501ffJean-Baptiste Queru 1211a8675f67e33bc7337d148358783b0fd138b501ffJean-Baptiste Queru /** 1212a8675f67e33bc7337d148358783b0fd138b501ffJean-Baptiste Queru * The array index of far focus distance for use with 1213a8675f67e33bc7337d148358783b0fd138b501ffJean-Baptiste Queru * {@link #getFocusDistances(float[])}. 12149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FOCUS_DISTANCE_FAR_INDEX = 2; 12169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The array index of minimum preview fps for use with {@link 12199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * #getPreviewFpsRange(int[])} or {@link 12209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * #getSupportedPreviewFpsRange()}. 1221a8675f67e33bc7337d148358783b0fd138b501ffJean-Baptiste Queru */ 12229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PREVIEW_FPS_MIN_INDEX = 0; 12239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The array index of maximum preview fps for use with {@link 12269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * #getPreviewFpsRange(int[])} or {@link 12279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * #getSupportedPreviewFpsRange()}. 12289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PREVIEW_FPS_MAX_INDEX = 1; 12309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Formats for setPreviewFormat and setPictureFormat. 12329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String PIXEL_FORMAT_YUV422SP = "yuv422sp"; 12339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String PIXEL_FORMAT_YUV420SP = "yuv420sp"; 12349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String PIXEL_FORMAT_YUV422I = "yuv422i-yuyv"; 12359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String PIXEL_FORMAT_RGB565 = "rgb565"; 12369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String PIXEL_FORMAT_JPEG = "jpeg"; 12379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private HashMap<String, String> mMap; 12399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private Parameters() { 12419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mMap = new HashMap<String, String>(); 12429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Writes the current Parameters to the log. 12469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 12479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated 12489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void dump() { 12509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "dump: size=" + mMap.size()); 12519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (String k : mMap.keySet()) { 12529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "dump: " + k + "=" + mMap.get(k)); 12539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creates a single string with all the parameters set in 12589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this Parameters object. 12599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>The {@link #unflatten(String)} method does the reverse.</p> 12609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a String with all values from this Parameters object, in 12629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * semi-colon delimited key-value pairs 12639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String flatten() { 12659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project StringBuilder flattened = new StringBuilder(); 12669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (String k : mMap.keySet()) { 12679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project flattened.append(k); 12689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project flattened.append("="); 12699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project flattened.append(mMap.get(k)); 12709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project flattened.append(";"); 12719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // chop off the extra semicolon at the end 12739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project flattened.deleteCharAt(flattened.length()-1); 12749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return flattened.toString(); 12759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Takes a flattened string of parameters and adds each one to 12799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this Parameters object. 12809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>The {@link #flatten()} method does the reverse.</p> 1281a8675f67e33bc7337d148358783b0fd138b501ffJean-Baptiste Queru * 12829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flattened a String of parameters (key-value paired) that 12839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are semi-colon delimited 12849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void unflatten(String flattened) { 12869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mMap.clear(); 12879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project StringTokenizer tokenizer = new StringTokenizer(flattened, ";"); 12899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project while (tokenizer.hasMoreElements()) { 12909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String kv = tokenizer.nextToken(); 12919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int pos = kv.indexOf('='); 12929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (pos == -1) { 12939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project continue; 12949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String k = kv.substring(0, pos); 12969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String v = kv.substring(pos + 1); 12979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mMap.put(k, v); 12989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void remove(String key) { 13029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mMap.remove(key); 13034e8620f868e2490782ebb960404140ea9482c91dBen Dodson } 13049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13064e8620f868e2490782ebb960404140ea9482c91dBen Dodson * Sets a String parameter. 13074e8620f868e2490782ebb960404140ea9482c91dBen Dodson * 13089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param key the key name for the parameter 13099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param value the String value of the parameter 13104e8620f868e2490782ebb960404140ea9482c91dBen Dodson */ 13110f28af209ac877091f4a096f7553f02a0b401596Jesse Wilson public void set(String key, String value) { 131258a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson if (key.indexOf('=') != -1 || key.indexOf(';') != -1) { 13139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Key \"" + key + "\" contains invalid character (= or ;)"); 13149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 13159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (value.indexOf('=') != -1 || value.indexOf(';') != -1) { 13179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Value \"" + value + "\" contains invalid character (= or ;)"); 13189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 13199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mMap.put(key, value); 13229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets an integer parameter. 13269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param key the key name for the parameter 13289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param value the int value of the parameter 13299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void set(String key, int value) { 13319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mMap.put(key, Integer.toString(value)); 13329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the value of a String parameter. 13369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param key the key name for the parameter 13389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the String value of the parameter 13399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String get(String key) { 13419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mMap.get(key); 13429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the value of an integer parameter. 13469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param key the key name for the parameter 13489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the int value of the parameter 13499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getInt(String key) { 13519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return Integer.parseInt(mMap.get(key)); 13529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the dimensions for preview pictures. 13569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The sides of width and height are based on camera orientation. That 13589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is, the preview size is the size before it is rotated by display 13599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * orientation. So applications need to consider the display orientation 13609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * while setting preview size. For example, suppose the camera supports 13619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * both 480x320 and 320x480 preview sizes. The application wants a 3:2 13629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * preview ratio. If the display orientation is set to 0 or 180, preview 13639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * size should be set to 480x320. If the display orientation is set to 13649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 90 or 270, preview size should be set to 320x480. The display 13659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * orientation should also be considered while setting picture size and 13669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * thumbnail size. 13679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width the width of the pictures, in pixels 13699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height the height of the pictures, in pixels 13709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setDisplayOrientation(int) 13719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getCameraInfo(int, CameraInfo) 13729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setPictureSize(int, int) 13739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setJpegThumbnailSize(int, int) 13749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setPreviewSize(int width, int height) { 13769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String v = Integer.toString(width) + "x" + Integer.toString(height); 13779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project set(KEY_PREVIEW_SIZE, v); 13789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the dimensions setting for preview pictures. 13829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a Size object with the height and width setting 13849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * for the preview picture 13859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Size getPreviewSize() { 13879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String pair = get(KEY_PREVIEW_SIZE); 13889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return strToSize(pair); 13899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the supported preview sizes. 13939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a list of Size object. This method will always return a list 13959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * with at least one element. 13969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<Size> getSupportedPreviewSizes() { 13989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String str = get(KEY_PREVIEW_SIZE + SUPPORTED_VALUES_SUFFIX); 13999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return splitSize(str); 14009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the dimensions for EXIF thumbnail in Jpeg picture. If 14049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * applications set both width and height to 0, EXIF will not contain 14059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * thumbnail. 14069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Applications need to consider the display orientation. See {@link 14089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * #setPreviewSize(int,int)} for reference. 14099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width the width of the thumbnail, in pixels 14119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height the height of the thumbnail, in pixels 14129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setPreviewSize(int,int) 14139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setJpegThumbnailSize(int width, int height) { 14159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project set(KEY_JPEG_THUMBNAIL_WIDTH, width); 14169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project set(KEY_JPEG_THUMBNAIL_HEIGHT, height); 14179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the dimensions for EXIF thumbnail in Jpeg picture. 14219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a Size object with the height and width setting for the EXIF 14239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * thumbnails 14249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Size getJpegThumbnailSize() { 14269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new Size(getInt(KEY_JPEG_THUMBNAIL_WIDTH), 14279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getInt(KEY_JPEG_THUMBNAIL_HEIGHT)); 14289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the supported jpeg thumbnail sizes. 14329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a list of Size object. This method will always return a list 14349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * with at least two elements. Size 0,0 (no thumbnail) is always 14359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * supported. 14369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<Size> getSupportedJpegThumbnailSizes() { 14389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String str = get(KEY_JPEG_THUMBNAIL_SIZE + SUPPORTED_VALUES_SUFFIX); 14399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return splitSize(str); 14409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the quality of the EXIF thumbnail in Jpeg picture. 14449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param quality the JPEG quality of the EXIF thumbnail. The range is 1 14469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to 100, with 100 being the best. 14479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setJpegThumbnailQuality(int quality) { 14499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project set(KEY_JPEG_THUMBNAIL_QUALITY, quality); 14509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the quality setting for the EXIF thumbnail in Jpeg picture. 14549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the JPEG quality setting of the EXIF thumbnail. 14569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getJpegThumbnailQuality() { 14589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return getInt(KEY_JPEG_THUMBNAIL_QUALITY); 14599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets Jpeg quality of captured picture. 14639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param quality the JPEG quality of captured picture. The range is 1 14659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to 100, with 100 being the best. 14669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setJpegQuality(int quality) { 14689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project set(KEY_JPEG_QUALITY, quality); 14699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the quality setting for the JPEG picture. 14739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the JPEG picture quality setting. 14759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getJpegQuality() { 14779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return getInt(KEY_JPEG_QUALITY); 14789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the rate at which preview frames are received. This is the 14829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * target frame rate. The actual frame rate depends on the driver. 14839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param fps the frame rate (frames per second) 14859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated replaced by {@link #setPreviewFpsRange(int,int)} 14869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Deprecated 14889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setPreviewFrameRate(int fps) { 14899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project set(KEY_PREVIEW_FRAME_RATE, fps); 14909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the setting for the rate at which preview frames are 14949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * received. This is the target frame rate. The actual frame rate 14959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * depends on the driver. 14969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the frame rate setting (frames per second) 14989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated replaced by {@link #getPreviewFpsRange(int[])} 149958a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson */ 150058a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson @Deprecated 150158a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson public int getPreviewFrameRate() { 150258a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson return getInt(KEY_PREVIEW_FRAME_RATE); 150358a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson } 150458a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson 150558a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson /** 15069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the supported preview frame rates. 15079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a list of supported preview frame rates. null if preview 15099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * frame rate setting is not supported. 15109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated replaced by {@link #getSupportedPreviewFpsRange()} 15119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Deprecated 15139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<Integer> getSupportedPreviewFrameRates() { 15149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String str = get(KEY_PREVIEW_FRAME_RATE + SUPPORTED_VALUES_SUFFIX); 15159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return splitInt(str); 15169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the maximum and maximum preview fps. This controls the rate of 15209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * preview frames received in {@link PreviewCallback}. The minimum and 15219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * maximum preview fps must be one of the elements from {@link 15229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * #getSupportedPreviewFpsRange}. 15239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param min the minimum preview fps (scaled by 1000). 15259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param max the maximum preview fps (scaled by 1000). 15269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws RuntimeException if fps range is invalid. 15279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setPreviewCallbackWithBuffer(Camera.PreviewCallback) 15289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getSupportedPreviewFpsRange() 15299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setPreviewFpsRange(int min, int max) { 15319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project set(KEY_PREVIEW_FPS_RANGE, "" + min + "," + max); 15329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current minimum and maximum preview fps. The values are 15369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * one of the elements returned by {@link #getSupportedPreviewFpsRange}. 15379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return range the minimum and maximum preview fps (scaled by 1000). 15399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #PREVIEW_FPS_MIN_INDEX 15409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #PREVIEW_FPS_MAX_INDEX 15419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getSupportedPreviewFpsRange() 15429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void getPreviewFpsRange(int[] range) { 15449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (range == null || range.length != 2) { 15459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException( 15469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "range must be an array with two elements."); 15479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project splitInt(get(KEY_PREVIEW_FPS_RANGE), range); 15499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 155058a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson 155158a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson /** 155258a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * Gets the supported preview fps (frame-per-second) ranges. Each range 155358a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * contains a minimum fps and maximum fps. If minimum fps equals to 155458a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * maximum fps, the camera outputs frames in fixed frame rate. If not, 155558a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * the camera outputs frames in auto frame rate. The actual frame rate 155658a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * fluctuates between the minimum and the maximum. The values are 155758a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * multiplied by 1000 and represented in integers. For example, if frame 155858a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * rate is 26.623 frames per second, the value is 26623. 155958a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * 156058a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * @return a list of supported preview fps ranges. This method returns a 156158a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * list with at least one element. Every element is an int array 156258a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * of two values - minimum fps and maximum fps. The list is 156358a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * sorted from small to large (first by maximum fps and then 156458a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * minimum fps). 156558a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * @see #PREVIEW_FPS_MIN_INDEX 156658a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * @see #PREVIEW_FPS_MAX_INDEX 156758a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson */ 156858a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson public List<int[]> getSupportedPreviewFpsRange() { 156958a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson String str = get(KEY_PREVIEW_FPS_RANGE + SUPPORTED_VALUES_SUFFIX); 157058a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson return splitRange(str); 157158a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson } 157258a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson 157358a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson /** 157458a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * Sets the image format for preview pictures. 157558a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * <p>If this is never called, the default format will be 157658a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * {@link android.graphics.ImageFormat#NV21}, which 157758a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * uses the NV21 encoding format.</p> 157858a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * 157958a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * @param pixel_format the desired preview picture format, defined 158058a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * by one of the {@link android.graphics.ImageFormat} constants. 158158a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * (E.g., <var>ImageFormat.NV21</var> (default), 158258a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * <var>ImageFormat.RGB_565</var>, or 158358a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * <var>ImageFormat.JPEG</var>) 158458a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * @see android.graphics.ImageFormat 158558a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson */ 158658a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson public void setPreviewFormat(int pixel_format) { 158758a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson String s = cameraFormatForPixelFormat(pixel_format); 158858a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson if (s == null) { 15899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException( 15909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "Invalid pixel_format=" + pixel_format); 15919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project set(KEY_PREVIEW_FORMAT, s); 15949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the image format for preview frames got from 15989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link PreviewCallback}. 15999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the preview format. 160158a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * @see android.graphics.ImageFormat 160258a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson */ 160358a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson public int getPreviewFormat() { 16049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return pixelFormatForCameraFormat(get(KEY_PREVIEW_FORMAT)); 1605a8675f67e33bc7337d148358783b0fd138b501ffJean-Baptiste Queru } 16069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the supported preview formats. 16099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a list of supported preview formats. This method will always 16119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * return a list with at least one element. 16129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see android.graphics.ImageFormat 16139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<Integer> getSupportedPreviewFormats() { 16159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String str = get(KEY_PREVIEW_FORMAT + SUPPORTED_VALUES_SUFFIX); 16169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ArrayList<Integer> formats = new ArrayList<Integer>(); 16179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (String s : split(str)) { 16189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int f = pixelFormatForCameraFormat(s); 16199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (f == ImageFormat.UNKNOWN) continue; 162058a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson formats.add(f); 162158a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson } 162258a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson return formats; 16239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 162458a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson 162558a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson /** 162658a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * Sets the dimensions for pictures. 16279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Applications need to consider the display orientation. See {@link 162958a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * #setPreviewSize(int,int)} for reference. 163058a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * 163158a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * @param width the width for pictures, in pixels 163258a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * @param height the height for pictures, in pixels 163358a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * @see #setPreviewSize(int,int) 163458a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * 163558a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson */ 16369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setPictureSize(int width, int height) { 16379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String v = Integer.toString(width) + "x" + Integer.toString(height); 163858a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson set(KEY_PICTURE_SIZE, v); 163958a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson } 164058a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson 164158a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson /** 164258a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * Returns the dimension setting for pictures. 164358a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * 164458a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * @return a Size object with the height and width setting 16459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * for pictures 16469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Size getPictureSize() { 16489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String pair = get(KEY_PICTURE_SIZE); 16499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return strToSize(pair); 16509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 165241e0839b136cdeccd2f45de1d9c56240f3933a1eJesse Wilson /** 165341e0839b136cdeccd2f45de1d9c56240f3933a1eJesse Wilson * Gets the supported picture sizes. 165441e0839b136cdeccd2f45de1d9c56240f3933a1eJesse Wilson * 16559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a list of supported picture sizes. This method will always 16569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * return a list with at least one element. 16579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<Size> getSupportedPictureSizes() { 16599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String str = get(KEY_PICTURE_SIZE + SUPPORTED_VALUES_SUFFIX); 16609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return splitSize(str); 16619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 166470ece8d334485af47edfb5bf3049bef2cf5f4df6Brad Fitzpatrick * Sets the image format for pictures. 1665f0cfe3438aea77b5193d94fb9fa0c8d37972b194Jeff Hamilton * 166670ece8d334485af47edfb5bf3049bef2cf5f4df6Brad Fitzpatrick * @param pixel_format the desired picture format 16679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (<var>ImageFormat.NV21</var>, 166870ece8d334485af47edfb5bf3049bef2cf5f4df6Brad Fitzpatrick * <var>ImageFormat.RGB_565</var>, or 16699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>ImageFormat.JPEG</var>) 16709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see android.graphics.ImageFormat 16719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setPictureFormat(int pixel_format) { 167370ece8d334485af47edfb5bf3049bef2cf5f4df6Brad Fitzpatrick String s = cameraFormatForPixelFormat(pixel_format); 167458a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson if (s == null) { 167558a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson throw new IllegalArgumentException( 167658a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson "Invalid pixel_format=" + pixel_format); 167758a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson } 167858a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson 16799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project set(KEY_PICTURE_FORMAT, s); 168058a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson } 168158a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson 168258a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson /** 168370ece8d334485af47edfb5bf3049bef2cf5f4df6Brad Fitzpatrick * Returns the image format for pictures. 168458a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * 168558a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * @return the picture format 168658a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * @see android.graphics.ImageFormat 168758a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson */ 16880f28af209ac877091f4a096f7553f02a0b401596Jesse Wilson public int getPictureFormat() { 168958a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson return pixelFormatForCameraFormat(get(KEY_PICTURE_FORMAT)); 16900f28af209ac877091f4a096f7553f02a0b401596Jesse Wilson } 16910f28af209ac877091f4a096f7553f02a0b401596Jesse Wilson 169270ece8d334485af47edfb5bf3049bef2cf5f4df6Brad Fitzpatrick /** 169358a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * Gets the supported picture formats. 169458a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * 169558a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * @return supported picture formats. This method will always return a 169658a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * list with at least one element. 169758a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson * @see android.graphics.ImageFormat 1698e41c317348cfe23a78bfd97609c3489c6cc4a786Keith Ito */ 169958a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson public List<Integer> getSupportedPictureFormats() { 17009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String str = get(KEY_PICTURE_FORMAT + SUPPORTED_VALUES_SUFFIX); 170158a345936d7e2b66bdeefb492e4f777754792d7eBen Dodson ArrayList<Integer> formats = new ArrayList<Integer>(); 170270ece8d334485af47edfb5bf3049bef2cf5f4df6Brad Fitzpatrick for (String s : split(str)) { 17039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int f = pixelFormatForCameraFormat(s); 17049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (f == ImageFormat.UNKNOWN) continue; 1705f0cfe3438aea77b5193d94fb9fa0c8d37972b194Jeff Hamilton formats.add(f); 1706f0cfe3438aea77b5193d94fb9fa0c8d37972b194Jeff Hamilton } 1707f0cfe3438aea77b5193d94fb9fa0c8d37972b194Jeff Hamilton return formats; 1708f0cfe3438aea77b5193d94fb9fa0c8d37972b194Jeff Hamilton } 1709f0cfe3438aea77b5193d94fb9fa0c8d37972b194Jeff Hamilton 1710f0cfe3438aea77b5193d94fb9fa0c8d37972b194Jeff Hamilton private String cameraFormatForPixelFormat(int pixel_format) { 1711f0cfe3438aea77b5193d94fb9fa0c8d37972b194Jeff Hamilton switch(pixel_format) { 1712f0cfe3438aea77b5193d94fb9fa0c8d37972b194Jeff Hamilton case ImageFormat.NV16: return PIXEL_FORMAT_YUV422SP; 1713f0cfe3438aea77b5193d94fb9fa0c8d37972b194Jeff Hamilton case ImageFormat.NV21: return PIXEL_FORMAT_YUV420SP; 1714f0cfe3438aea77b5193d94fb9fa0c8d37972b194Jeff Hamilton case ImageFormat.YUY2: return PIXEL_FORMAT_YUV422I; 1715f0cfe3438aea77b5193d94fb9fa0c8d37972b194Jeff Hamilton case ImageFormat.RGB_565: return PIXEL_FORMAT_RGB565; 1716f0cfe3438aea77b5193d94fb9fa0c8d37972b194Jeff Hamilton case ImageFormat.JPEG: return PIXEL_FORMAT_JPEG; 1717f0cfe3438aea77b5193d94fb9fa0c8d37972b194Jeff Hamilton default: return null; 1718f0cfe3438aea77b5193d94fb9fa0c8d37972b194Jeff Hamilton } 1719f0cfe3438aea77b5193d94fb9fa0c8d37972b194Jeff Hamilton } 1720f0cfe3438aea77b5193d94fb9fa0c8d37972b194Jeff Hamilton 1721f0cfe3438aea77b5193d94fb9fa0c8d37972b194Jeff Hamilton private int pixelFormatForCameraFormat(String format) { 1722f0cfe3438aea77b5193d94fb9fa0c8d37972b194Jeff Hamilton if (format == null) 1723ccae412deda8b0c165c86f395752c0667a3411a6Nick Pelly return ImageFormat.UNKNOWN; 1724abc43ddd8ae098de7a56afc55909f904cd933016Jesse Wilson 1725ccae412deda8b0c165c86f395752c0667a3411a6Nick Pelly if (format.equals(PIXEL_FORMAT_YUV422SP)) 1726ccae412deda8b0c165c86f395752c0667a3411a6Nick Pelly return ImageFormat.NV16; 1727ccae412deda8b0c165c86f395752c0667a3411a6Nick Pelly 1728ccae412deda8b0c165c86f395752c0667a3411a6Nick Pelly if (format.equals(PIXEL_FORMAT_YUV420SP)) 1729ccae412deda8b0c165c86f395752c0667a3411a6Nick Pelly return ImageFormat.NV21; 1730ccae412deda8b0c165c86f395752c0667a3411a6Nick Pelly 1731ccae412deda8b0c165c86f395752c0667a3411a6Nick Pelly if (format.equals(PIXEL_FORMAT_YUV422I)) 1732ccae412deda8b0c165c86f395752c0667a3411a6Nick Pelly return ImageFormat.YUY2; 1733ccae412deda8b0c165c86f395752c0667a3411a6Nick Pelly 1734ccae412deda8b0c165c86f395752c0667a3411a6Nick Pelly if (format.equals(PIXEL_FORMAT_RGB565)) 1735ccae412deda8b0c165c86f395752c0667a3411a6Nick Pelly return ImageFormat.RGB_565; 1736ccae412deda8b0c165c86f395752c0667a3411a6Nick Pelly 1737ccae412deda8b0c165c86f395752c0667a3411a6Nick Pelly if (format.equals(PIXEL_FORMAT_JPEG)) 1738ccae412deda8b0c165c86f395752c0667a3411a6Nick Pelly return ImageFormat.JPEG; 1739ccae412deda8b0c165c86f395752c0667a3411a6Nick Pelly 1740ccae412deda8b0c165c86f395752c0667a3411a6Nick Pelly return ImageFormat.UNKNOWN; 1741ccae412deda8b0c165c86f395752c0667a3411a6Nick Pelly } 1742ccae412deda8b0c165c86f395752c0667a3411a6Nick Pelly 1743ccae412deda8b0c165c86f395752c0667a3411a6Nick Pelly /** 1744abc43ddd8ae098de7a56afc55909f904cd933016Jesse Wilson * Sets the rotation angle in degrees relative to the orientation of 1745ccae412deda8b0c165c86f395752c0667a3411a6Nick Pelly * the camera. This affects the pictures returned from JPEG {@link 1746ccae412deda8b0c165c86f395752c0667a3411a6Nick Pelly * PictureCallback}. The camera driver may set orientation in the 1747ccae412deda8b0c165c86f395752c0667a3411a6Nick Pelly * EXIF header without rotating the picture. Or the driver may rotate 1748ccae412deda8b0c165c86f395752c0667a3411a6Nick Pelly * the picture and the EXIF thumbnail. If the Jpeg picture is rotated, 1749ccae412deda8b0c165c86f395752c0667a3411a6Nick Pelly * the orientation in the EXIF header will be missing or 1 (row #0 is 1750ccae412deda8b0c165c86f395752c0667a3411a6Nick Pelly * top and column #0 is left side). 1751ccae412deda8b0c165c86f395752c0667a3411a6Nick Pelly * 1752ccae412deda8b0c165c86f395752c0667a3411a6Nick Pelly * If appplications want to rotate the picture to match the 17539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * orientation of what users see, apps should use {@link 17549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * android.view.OrientationEventListener} and {@link CameraInfo}. 17559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The value from OrientationEventListener is relative to the natural 17569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * orientation of the device. CameraInfo.mOrientation is the angle 17579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * between camera orientation and natural device orientation. The sum 17589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the two is the angle for rotation. 17599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * For example, suppose the natural orientation of the device is 17619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * portrait. The device is rotated 270 degrees clockwise, so the device 17629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * orientation is 270. Suppose the camera sensor is mounted in landscape 17639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and the top side of the camera sensor is aligned with the right edge 17649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the display in natural orientation. So the camera orientation is 17659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 90. The rotation should be set to 0 (270 + 90). 17669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The reference code is as follows. 17689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * public void public void onOrientationChanged(int orientation) { 17709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if (orientation == ORIENTATION_UNKNOWN) return; 17718e8d65ff5fdef12c6af3d003dfef19aadc39bea9Dianne Hackborn * android.hardware.Camera.CameraInfo info = 17729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * new android.hardware.Camera.CameraInfo(); 17739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * android.hardware.Camera.getCameraInfo(cameraId, info); 17749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * orientation = (orientation + 45) / 90 * 90; 17759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * mParameters.setRotation((orientation + info.mOrientation) % 360); 17769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * } 17779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rotation The rotation angle in degrees relative to the 17799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * orientation of the camera. Rotation can only be 0, 17809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 90, 180 or 270. 17819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if rotation value is invalid. 17829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see android.view.OrientationEventListener 17839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getCameraInfo(int, CameraInfo) 17849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setRotation(int rotation) { 17869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (rotation == 0 || rotation == 90 || rotation == 180 17879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project || rotation == 270) { 17889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project set(KEY_ROTATION, Integer.toString(rotation)); 17899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 17909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException( 17919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "Invalid rotation=" + rotation); 17929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets GPS latitude coordinate. This will be stored in JPEG EXIF 17979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * header. 17989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param latitude GPS latitude coordinate. 18009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setGpsLatitude(double latitude) { 18029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project set(KEY_GPS_LATITUDE, Double.toString(latitude)); 18039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets GPS longitude coordinate. This will be stored in JPEG EXIF 18079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * header. 18089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param longitude GPS longitude coordinate. 18109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setGpsLongitude(double longitude) { 18129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project set(KEY_GPS_LONGITUDE, Double.toString(longitude)); 18139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets GPS altitude. This will be stored in JPEG EXIF header. 18179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param altitude GPS altitude in meters. 18199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setGpsAltitude(double altitude) { 18219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project set(KEY_GPS_ALTITUDE, Double.toString(altitude)); 18229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets GPS timestamp. This will be stored in JPEG EXIF header. 18269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param timestamp GPS timestamp (UTC in seconds since January 1, 18289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1970). 18299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setGpsTimestamp(long timestamp) { 18319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project set(KEY_GPS_TIMESTAMP, Long.toString(timestamp)); 18329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets GPS processing method. It will store up to 32 characters 18369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in JPEG EXIF header. 18379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param processing_method The processing method to get this location. 18399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setGpsProcessingMethod(String processing_method) { 18419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project set(KEY_GPS_PROCESSING_METHOD, processing_method); 18429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Removes GPS latitude, longitude, altitude, and timestamp from the 18469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * parameters. 18479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void removeGpsData() { 18499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project remove(KEY_GPS_LATITUDE); 18509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project remove(KEY_GPS_LONGITUDE); 18519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project remove(KEY_GPS_ALTITUDE); 18529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project remove(KEY_GPS_TIMESTAMP); 18539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project remove(KEY_GPS_PROCESSING_METHOD); 18549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the current white balance setting. 18589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return current white balance. null if white balance setting is not 18609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * supported. 18619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WHITE_BALANCE_AUTO 18629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WHITE_BALANCE_INCANDESCENT 18639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WHITE_BALANCE_FLUORESCENT 18649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WHITE_BALANCE_WARM_FLUORESCENT 18659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WHITE_BALANCE_DAYLIGHT 18669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WHITE_BALANCE_CLOUDY_DAYLIGHT 18679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WHITE_BALANCE_TWILIGHT 18689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WHITE_BALANCE_SHADE 18699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String getWhiteBalance() { 18729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return get(KEY_WHITE_BALANCE); 18739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the white balance. 18779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param value new white balance. 18799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWhiteBalance() 18809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setWhiteBalance(String value) { 18829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project set(KEY_WHITE_BALANCE, value); 18839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the supported white balance. 18879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a list of supported white balance. null if white balance 18899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * setting is not supported. 18909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWhiteBalance() 18919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<String> getSupportedWhiteBalance() { 18939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String str = get(KEY_WHITE_BALANCE + SUPPORTED_VALUES_SUFFIX); 18949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return split(str); 18959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the current color effect setting. 18999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 19009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return current color effect. null if color effect 19019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * setting is not supported. 19029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EFFECT_NONE 19039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EFFECT_MONO 19049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EFFECT_NEGATIVE 19059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EFFECT_SOLARIZE 19069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EFFECT_SEPIA 19079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EFFECT_POSTERIZE 19089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EFFECT_WHITEBOARD 19099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EFFECT_BLACKBOARD 19109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EFFECT_AQUA 19119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 19129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String getColorEffect() { 19139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return get(KEY_EFFECT); 19149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 19179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the current color effect setting. 19189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 19199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param value new color effect. 19209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getColorEffect() 19219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 19229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setColorEffect(String value) { 19239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project set(KEY_EFFECT, value); 19249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 19279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the supported color effects. 19289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 19299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a list of supported color effects. null if color effect 19300f28af209ac877091f4a096f7553f02a0b401596Jesse Wilson * setting is not supported. 19319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getColorEffect() 19329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 19339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<String> getSupportedColorEffects() { 19349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String str = get(KEY_EFFECT + SUPPORTED_VALUES_SUFFIX); 19359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return split(str); 19369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 19409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the current antibanding setting. 19419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 19429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return current antibanding. null if antibanding setting is not 19439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * supported. 19449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #ANTIBANDING_AUTO 19459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #ANTIBANDING_50HZ 19469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #ANTIBANDING_60HZ 19479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #ANTIBANDING_OFF 19489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 19499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String getAntibanding() { 19509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return get(KEY_ANTIBANDING); 19519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 19549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the antibanding. 19559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 19569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param antibanding new antibanding value. 19579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getAntibanding() 19589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 19599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setAntibanding(String antibanding) { 19609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project set(KEY_ANTIBANDING, antibanding); 19619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 19649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the supported antibanding values. 19659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 19669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a list of supported antibanding values. null if antibanding 19679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * setting is not supported. 19689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getAntibanding() 19699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 19709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<String> getSupportedAntibanding() { 19719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String str = get(KEY_ANTIBANDING + SUPPORTED_VALUES_SUFFIX); 19729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return split(str); 19739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 19769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the current scene mode setting. 19779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 19789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return one of SCENE_MODE_XXX string constant. null if scene mode 19799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * setting is not supported. 19809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #SCENE_MODE_AUTO 19818e8d65ff5fdef12c6af3d003dfef19aadc39bea9Dianne Hackborn * @see #SCENE_MODE_ACTION 19829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #SCENE_MODE_PORTRAIT 19839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #SCENE_MODE_LANDSCAPE 19849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #SCENE_MODE_NIGHT 19859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #SCENE_MODE_NIGHT_PORTRAIT 19869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #SCENE_MODE_THEATRE 19879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #SCENE_MODE_BEACH 19889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #SCENE_MODE_SNOW 19899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #SCENE_MODE_SUNSET 19909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #SCENE_MODE_STEADYPHOTO 19919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #SCENE_MODE_FIREWORKS 19929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #SCENE_MODE_SPORTS 19939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #SCENE_MODE_PARTY 19949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #SCENE_MODE_CANDLELIGHT 19959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 19969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String getSceneMode() { 19979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return get(KEY_SCENE_MODE); 19989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 20009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 20019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the scene mode. Changing scene mode may override other 20029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * parameters (such as flash mode, focus mode, white balance). For 20039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * example, suppose originally flash mode is on and supported flash 20049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * modes are on/off. In night scene mode, both flash mode and supported 20059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * flash mode may be changed to off. After setting scene mode, 20069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * applications should call getParameters to know if some parameters are 20079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * changed. 20089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 20099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param value scene mode. 20109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getSceneMode() 20119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 20129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setSceneMode(String value) { 20139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project set(KEY_SCENE_MODE, value); 20149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 20159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 20169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 20179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the supported scene modes. 20189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 20199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a list of supported scene modes. null if scene mode setting 20209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is not supported. 20219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getSceneMode() 20228e8d65ff5fdef12c6af3d003dfef19aadc39bea9Dianne Hackborn */ 20238e8d65ff5fdef12c6af3d003dfef19aadc39bea9Dianne Hackborn public List<String> getSupportedSceneModes() { 20249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String str = get(KEY_SCENE_MODE + SUPPORTED_VALUES_SUFFIX); 20259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return split(str); 20269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 20279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 20289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 20299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the current flash mode setting. 20309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 20319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return current flash mode. null if flash mode setting is not 20329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * supported. 20339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #FLASH_MODE_OFF 20349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #FLASH_MODE_AUTO 20359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #FLASH_MODE_ON 20369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #FLASH_MODE_RED_EYE 20379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #FLASH_MODE_TORCH 20389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 20399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String getFlashMode() { 20409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return get(KEY_FLASH_MODE); 20419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 20429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 20439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 20449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the flash mode. 20459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 20469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param value flash mode. 20479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getFlashMode() 20489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 20499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setFlashMode(String value) { 20509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project set(KEY_FLASH_MODE, value); 20519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 20529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 20539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 20549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the supported flash modes. 20559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 20569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a list of supported flash modes. null if flash mode setting 20579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is not supported. 20589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getFlashMode() 20599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 20609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<String> getSupportedFlashModes() { 20619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String str = get(KEY_FLASH_MODE + SUPPORTED_VALUES_SUFFIX); 20629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return split(str); 20639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 20649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 20659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 20669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the current focus mode setting. 20679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 20689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return current focus mode. This method will always return a non-null 20699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * value. Applications should call {@link 20709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * #autoFocus(AutoFocusCallback)} to start the focus if focus 20719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * mode is FOCUS_MODE_AUTO or FOCUS_MODE_MACRO. 20729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #FOCUS_MODE_AUTO 20739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #FOCUS_MODE_INFINITY 20749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #FOCUS_MODE_MACRO 20759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #FOCUS_MODE_FIXED 20769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #FOCUS_MODE_EDOF 20779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #FOCUS_MODE_CONTINUOUS_VIDEO 20789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 20799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String getFocusMode() { 20809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return get(KEY_FOCUS_MODE); 20819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 20829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 20839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 20849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the focus mode. 20859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 20869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param value focus mode. 20879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getFocusMode() 20889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 20899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setFocusMode(String value) { 20909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project set(KEY_FOCUS_MODE, value); 20919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 20929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 20939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 20949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the supported focus modes. 20959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 20969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a list of supported focus modes. This method will always 20979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * return a list with at least one element. 20989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getFocusMode() 20999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 21009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<String> getSupportedFocusModes() { 21019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String str = get(KEY_FOCUS_MODE + SUPPORTED_VALUES_SUFFIX); 21029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return split(str); 21039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 21049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 21059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 21069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the focal length (in millimeter) of the camera. 21079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 21089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the focal length. This method will always return a valid 21099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * value. 21109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 21119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public float getFocalLength() { 21129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return Float.parseFloat(get(KEY_FOCAL_LENGTH)); 21139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 21149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 21159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 21169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the horizontal angle of view in degrees. 21179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 21189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return horizontal angle of view. This method will always return a 21199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * valid value. 21209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 21219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public float getHorizontalViewAngle() { 21229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return Float.parseFloat(get(KEY_HORIZONTAL_VIEW_ANGLE)); 21239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 21249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 21259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 21269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the vertical angle of view in degrees. 21279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 21289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return vertical angle of view. This method will always return a 21299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * valid value. 21309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 21319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public float getVerticalViewAngle() { 21329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return Float.parseFloat(get(KEY_VERTICAL_VIEW_ANGLE)); 21339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 21349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 21359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 21369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the current exposure compensation index. 21379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 21389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return current exposure compensation index. The range is {@link 21399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * #getMinExposureCompensation} to {@link 21409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * #getMaxExposureCompensation}. 0 means exposure is not 21419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * adjusted. 21429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 21439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getExposureCompensation() { 21449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return getInt(KEY_EXPOSURE_COMPENSATION, 0); 21459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 21469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 21479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 21489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the exposure compensation index. 21499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 21509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param value exposure compensation index. The valid value range is 21519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * from {@link #getMinExposureCompensation} (inclusive) to {@link 21529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * #getMaxExposureCompensation} (inclusive). 0 means exposure is 21539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not adjusted. Application should call 21549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * getMinExposureCompensation and getMaxExposureCompensation to 21559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * know if exposure compensation is supported. 21569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 21579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setExposureCompensation(int value) { 21589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project set(KEY_EXPOSURE_COMPENSATION, value); 21599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 21609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 21619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 21629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the maximum exposure compensation index. 21639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 21649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return maximum exposure compensation index (>=0). If both this 21659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * method and {@link #getMinExposureCompensation} return 0, 21669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * exposure compensation is not supported. 21679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 21689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getMaxExposureCompensation() { 21699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return getInt(KEY_MAX_EXPOSURE_COMPENSATION, 0); 21709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 21719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 21729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 21739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the minimum exposure compensation index. 21749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 21759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return minimum exposure compensation index (<=0). If both this 21769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * method and {@link #getMaxExposureCompensation} return 0, 21779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * exposure compensation is not supported. 21789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 21799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getMinExposureCompensation() { 21809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return getInt(KEY_MIN_EXPOSURE_COMPENSATION, 0); 21819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 21829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 21839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 21849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the exposure compensation step. 21859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 21869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return exposure compensation step. Applications can get EV by 21879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * multiplying the exposure compensation index and step. Ex: if 21889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * exposure compensation index is -6 and step is 0.333333333, EV 21899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is -2. 21909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 21919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public float getExposureCompensationStep() { 21929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return getFloat(KEY_EXPOSURE_COMPENSATION_STEP, 0); 21939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 21949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 21959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 21969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets current zoom value. This also works when smooth zoom is in 21979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * progress. Applications should check {@link #isZoomSupported} before 21989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * using this method. 21999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 22009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the current zoom value. The range is 0 to {@link 22019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * #getMaxZoom}. 0 means the camera is not zoomed. 22029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 22039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getZoom() { 22049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return getInt(KEY_ZOOM, 0); 22059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 22078e8d65ff5fdef12c6af3d003dfef19aadc39bea9Dianne Hackborn /** 22089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets current zoom value. If the camera is zoomed (value > 0), the 22099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * actual picture size may be smaller than picture size setting. 22109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Applications can check the actual picture size after picture is 22119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * returned from {@link PictureCallback}. The preview size remains the 22129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * same in zoom. Applications should check {@link #isZoomSupported} 22139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * before using this method. 22149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 22159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param value zoom value. The valid range is 0 to {@link #getMaxZoom}. 22169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 22179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setZoom(int value) { 22189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project set(KEY_ZOOM, value); 22199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 22219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 22229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns true if zoom is supported. Applications should call this 22239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * before using other zoom methods. 22249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 22259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if zoom is supported. 22269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 22279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isZoomSupported() { 22289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String str = get(KEY_ZOOM_SUPPORTED); 22299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return TRUE.equals(str); 22309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 22329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 22339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the maximum zoom value allowed for snapshot. This is the maximum 22349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * value that applications can set to {@link #setZoom(int)}. 22359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Applications should call {@link #isZoomSupported} before using this 22369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * method. This value may change in different preview size. Applications 22379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * should call this again after setting preview size. 22389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 22399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the maximum zoom value supported by the camera. 22409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 22419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getMaxZoom() { 22429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return getInt(KEY_MAX_ZOOM, 0); 22439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 22459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 22469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the zoom ratios of all zoom values. Applications should check 22479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #isZoomSupported} before using this method. 22489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 22499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the zoom ratios in 1/100 increments. Ex: a zoom of 3.2x is 22509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * returned as 320. The number of elements is {@link 22519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * #getMaxZoom} + 1. The list is sorted from small to large. The 22529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * first element is always 100. The last element is the zoom 22539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ratio of the maximum zoom value. 22549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 22559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<Integer> getZoomRatios() { 22569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return splitInt(get(KEY_ZOOM_RATIOS)); 22579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 22599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 22609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns true if smooth zoom is supported. Applications should call 22619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this before using other smooth zoom methods. 22629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 22639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if smooth zoom is supported. 22649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 22659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isSmoothZoomSupported() { 22669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String str = get(KEY_SMOOTH_ZOOM_SUPPORTED); 22679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return TRUE.equals(str); 22689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 22709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 22719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the distances from the camera to where an object appears to be 22729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in focus. The object is sharpest at the optimal focus distance. The 22739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * depth of field is the far focus distance minus near focus distance. 22749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 22759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Focus distances may change after calling {@link 22769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * #autoFocus(AutoFocusCallback)}, {@link #cancelAutoFocus}, or {@link 22779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * #startPreview()}. Applications can call {@link #getParameters()} 22789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and this method anytime to get the latest focus distances. If the 22799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * focus mode is FOCUS_MODE_CONTINUOUS_VIDEO, focus distances may change 22809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * from time to time. 22819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 22829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This method is intended to estimate the distance between the camera 22839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and the subject. After autofocus, the subject distance may be within 22849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * near and far focus distance. However, the precision depends on the 22850f28af209ac877091f4a096f7553f02a0b401596Jesse Wilson * camera hardware, autofocus algorithm, the focus area, and the scene. 22869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The error can be large and it should be only used as a reference. 22879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 22889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Far focus distance >= optimal focus distance >= near focus distance. 22899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If the focus distance is infinity, the value will be 22909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Float.POSITIVE_INFINITY. 22919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 22929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param output focus distances in meters. output must be a float 22939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * array with three elements. Near focus distance, optimal focus 229465c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey * distance, and far focus distance will be filled in the array. 229565c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey * @see #FOCUS_DISTANCE_NEAR_INDEX 229665c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey * @see #FOCUS_DISTANCE_OPTIMAL_INDEX 229765c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey * @see #FOCUS_DISTANCE_FAR_INDEX 229865c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey */ 229965c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey public void getFocusDistances(float[] output) { 230065c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey if (output == null || output.length != 3) { 230165c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey throw new IllegalArgumentException( 230265c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey "output must be an float array with three elements."); 230365c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey } 230465c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey splitFloat(get(KEY_FOCUS_DISTANCES), output); 230565c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey } 230665c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey 230765c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey // Splits a comma delimited string to an ArrayList of String. 230865c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey // Return null if the passing string is null or the size is 0. 230965c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey private ArrayList<String> split(String str) { 231065c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey if (str == null) return null; 231165c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey 231265c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey // Use StringTokenizer because it is faster than split. 231365c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey StringTokenizer tokenizer = new StringTokenizer(str, ","); 231465c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey ArrayList<String> substrings = new ArrayList<String>(); 231565c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey while (tokenizer.hasMoreElements()) { 231665c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey substrings.add(tokenizer.nextToken()); 231765c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey } 231865c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey return substrings; 231965c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey } 232065c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey 232165c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey // Splits a comma delimited string to an ArrayList of Integer. 232265c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey // Return null if the passing string is null or the size is 0. 232365c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey private ArrayList<Integer> splitInt(String str) { 232465c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey if (str == null) return null; 232565c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey 232665c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey StringTokenizer tokenizer = new StringTokenizer(str, ","); 232765c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey ArrayList<Integer> substrings = new ArrayList<Integer>(); 232865c4a2b26cd8776b0927e9b0e07ecf53bd31b627Jeff Sharkey while (tokenizer.hasMoreElements()) { 23299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String token = tokenizer.nextToken(); 2330 substrings.add(Integer.parseInt(token)); 2331 } 2332 if (substrings.size() == 0) return null; 2333 return substrings; 2334 } 2335 2336 private void splitInt(String str, int[] output) { 2337 if (str == null) return; 2338 2339 StringTokenizer tokenizer = new StringTokenizer(str, ","); 2340 int index = 0; 2341 while (tokenizer.hasMoreElements()) { 2342 String token = tokenizer.nextToken(); 2343 output[index++] = Integer.parseInt(token); 2344 } 2345 } 2346 2347 // Splits a comma delimited string to an ArrayList of Float. 2348 private void splitFloat(String str, float[] output) { 2349 if (str == null) return; 2350 2351 StringTokenizer tokenizer = new StringTokenizer(str, ","); 2352 int index = 0; 2353 while (tokenizer.hasMoreElements()) { 2354 String token = tokenizer.nextToken(); 2355 output[index++] = Float.parseFloat(token); 2356 } 2357 } 2358 2359 // Returns the value of a float parameter. 2360 private float getFloat(String key, float defaultValue) { 2361 try { 2362 return Float.parseFloat(mMap.get(key)); 2363 } catch (NumberFormatException ex) { 2364 return defaultValue; 2365 } 2366 } 2367 2368 // Returns the value of a integer parameter. 2369 private int getInt(String key, int defaultValue) { 2370 try { 2371 return Integer.parseInt(mMap.get(key)); 2372 } catch (NumberFormatException ex) { 2373 return defaultValue; 2374 } 2375 } 2376 2377 // Splits a comma delimited string to an ArrayList of Size. 2378 // Return null if the passing string is null or the size is 0. 2379 private ArrayList<Size> splitSize(String str) { 2380 if (str == null) return null; 2381 2382 StringTokenizer tokenizer = new StringTokenizer(str, ","); 2383 ArrayList<Size> sizeList = new ArrayList<Size>(); 2384 while (tokenizer.hasMoreElements()) { 2385 Size size = strToSize(tokenizer.nextToken()); 2386 if (size != null) sizeList.add(size); 2387 } 2388 if (sizeList.size() == 0) return null; 2389 return sizeList; 2390 } 2391 2392 // Parses a string (ex: "480x320") to Size object. 2393 // Return null if the passing string is null. 2394 private Size strToSize(String str) { 2395 if (str == null) return null; 2396 2397 int pos = str.indexOf('x'); 2398 if (pos != -1) { 2399 String width = str.substring(0, pos); 2400 String height = str.substring(pos + 1); 2401 return new Size(Integer.parseInt(width), 2402 Integer.parseInt(height)); 2403 } 2404 Log.e(TAG, "Invalid size parameter string=" + str); 2405 return null; 2406 } 2407 2408 // Splits a comma delimited string to an ArrayList of int array. 2409 // Example string: "(10000,26623),(10000,30000)". Return null if the 2410 // passing string is null or the size is 0. 2411 private ArrayList<int[]> splitRange(String str) { 2412 if (str == null || str.charAt(0) != '(' 2413 || str.charAt(str.length() - 1) != ')') { 2414 Log.e(TAG, "Invalid range list string=" + str); 2415 return null; 2416 } 2417 2418 ArrayList<int[]> rangeList = new ArrayList<int[]>(); 2419 int endIndex, fromIndex = 1; 2420 do { 2421 int[] range = new int[2]; 2422 endIndex = str.indexOf("),(", fromIndex); 2423 if (endIndex == -1) endIndex = str.length() - 1; 2424 splitInt(str.substring(fromIndex, endIndex), range); 2425 rangeList.add(range); 2426 fromIndex = endIndex + 3; 2427 } while (endIndex != str.length() - 1); 2428 2429 if (rangeList.size() == 0) return null; 2430 return rangeList; 2431 } 2432 }; 2433} 2434