diff options
author | Eino-Ville Talvala <etalvala@google.com> | 2012-11-06 16:10:52 -0800 |
---|---|---|
committer | Android Git Automerger <android-git-automerger@android.com> | 2012-11-06 16:10:52 -0800 |
commit | 688d98fe2185774322aa87dffd656fad471823ef (patch) | |
tree | 40bf7d47254b12c4af9e8aeb386bf2496d1fd7fa /core/java | |
parent | 7136544c06c2d10c7a1c6aa8715d2b717221aee8 (diff) | |
parent | 4a1b6e42424d08da0d22a24464e568034ea557ee (diff) | |
download | frameworks_base-688d98fe2185774322aa87dffd656fad471823ef.zip frameworks_base-688d98fe2185774322aa87dffd656fad471823ef.tar.gz frameworks_base-688d98fe2185774322aa87dffd656fad471823ef.tar.bz2 |
am 4a1b6e42: Merge "Camera: Document new video snapshot picture size behavior." into jb-mr1-dev
* commit '4a1b6e42424d08da0d22a24464e568034ea557ee':
Camera: Document new video snapshot picture size behavior.
Diffstat (limited to 'core/java')
-rw-r--r-- | core/java/android/hardware/Camera.java | 36 |
1 files changed, 20 insertions, 16 deletions
diff --git a/core/java/android/hardware/Camera.java b/core/java/android/hardware/Camera.java index 6624eb8..a300776 100644 --- a/core/java/android/hardware/Camera.java +++ b/core/java/android/hardware/Camera.java @@ -3495,25 +3495,29 @@ public class Camera { } /** - * Returns true if video snapshot is supported. That is, applications + * <p>Returns true if video snapshot is supported. That is, applications * can call {@link #takePicture(Camera.ShutterCallback, - * Camera.PictureCallback, Camera.PictureCallback, Camera.PictureCallback)} - * during recording. Applications do not need to call {@link - * #startPreview()} after taking a picture. The preview will be still - * active. Other than that, taking a picture during recording is - * identical to taking a picture normally. All settings and methods - * related to takePicture work identically. Ex: {@link - * #getPictureSize()}, {@link #getSupportedPictureSizes()}, {@link - * #setJpegQuality(int)}, {@link #setRotation(int)}, and etc. The - * picture will have an EXIF header. {@link #FLASH_MODE_AUTO} and {@link - * #FLASH_MODE_ON} also still work, but the video will record the flash. - * - * Applications can set shutter callback as null to avoid the shutter + * Camera.PictureCallback, Camera.PictureCallback, + * Camera.PictureCallback)} during recording. Applications do not need + * to call {@link #startPreview()} after taking a picture. The preview + * will be still active. Other than that, taking a picture during + * recording is identical to taking a picture normally. All settings and + * methods related to takePicture work identically. Ex: + * {@link #getPictureSize()}, {@link #getSupportedPictureSizes()}, + * {@link #setJpegQuality(int)}, {@link #setRotation(int)}, and etc. The + * picture will have an EXIF header. {@link #FLASH_MODE_AUTO} and + * {@link #FLASH_MODE_ON} also still work, but the video will record the + * flash.</p> + * + * <p>Applications can set shutter callback as null to avoid the shutter * sound. It is also recommended to set raw picture and post view - * callbacks to null to avoid the interrupt of preview display. + * callbacks to null to avoid the interrupt of preview display.</p> * - * Field-of-view of the recorded video may be different from that of the - * captured pictures. + * <p>Field-of-view of the recorded video may be different from that of the + * captured pictures. The maximum size of a video snapshot may be + * smaller than that for regular still captures. If the current picture + * size is set higher than can be supported by video snapshot, the + * picture will be captured at the maximum supported size instead.</p> * * @return true if video snapshot is supported. */ |