diff options
author | Eino-Ville Talvala <etalvala@google.com> | 2012-11-05 10:33:55 -0800 |
---|---|---|
committer | Eino-Ville Talvala <etalvala@google.com> | 2012-11-05 10:57:27 -0800 |
commit | 1cab31a45d9455a7b5a25c0deb447c455be4a178 (patch) | |
tree | 9647cd38698e085d750b2826ce52cd7a954a3bd6 /core/java/android/hardware | |
parent | 37238e5a4e10c5c5439f6864dd19049a5544e01a (diff) | |
download | frameworks_base-1cab31a45d9455a7b5a25c0deb447c455be4a178.zip frameworks_base-1cab31a45d9455a7b5a25c0deb447c455be4a178.tar.gz frameworks_base-1cab31a45d9455a7b5a25c0deb447c455be4a178.tar.bz2 |
Camera: Document new video snapshot picture size behavior.
On some devices, video snapshot may return pictures that are smaller
than requested. Make that clear.
Bug: 7475089
Change-Id: I0bd759072a7f954e517f3d09cb676fb23f863912
Diffstat (limited to 'core/java/android/hardware')
-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. */ |