diff options
author | Wu-cheng Li <wuchengli@google.com> | 2010-03-29 16:21:12 +0800 |
---|---|---|
committer | Wu-cheng Li <wuchengli@google.com> | 2010-03-29 16:21:12 +0800 |
commit | 0ca25191c663ef229f1f475b17899f2017ed6980 (patch) | |
tree | f4e9d6450f00ae8da4cc604c5d8cabad786229a3 /core/java/android | |
parent | 4a65900cd69b79e6e47d275575eaeb5bb2487f9f (diff) | |
download | frameworks_base-0ca25191c663ef229f1f475b17899f2017ed6980.zip frameworks_base-0ca25191c663ef229f1f475b17899f2017ed6980.tar.gz frameworks_base-0ca25191c663ef229f1f475b17899f2017ed6980.tar.bz2 |
Add some comments for zoom methods.
Also change RuntimeException to IllegalArgumentException.
bug:2458926
Change-Id: I87af31f5f3f10244131a1117bd1725c2d292b587
Diffstat (limited to 'core/java/android')
-rw-r--r-- | core/java/android/hardware/Camera.java | 10 |
1 files changed, 8 insertions, 2 deletions
diff --git a/core/java/android/hardware/Camera.java b/core/java/android/hardware/Camera.java index 4dddfd8..abebdeb 100644 --- a/core/java/android/hardware/Camera.java +++ b/core/java/android/hardware/Camera.java @@ -532,11 +532,15 @@ public class Camera { * called with value 3. Three ZoomCallback will be generated with zoom value * 1, 2, and 3. The applications can call {@link #stopSmoothZoom} to stop * the zoom earlier. The applications should not call startSmoothZoom again - * or change the zoom value before zoom stops. This method is supported if - * {@link android.hardware.Camera.Parameters#isSmoothZoomSupported} is true. + * or change the zoom value before zoom stops. If the passing zoom value + * equals to the current zoom value, no zoom callback will be generated. + * This method is supported if {@link + * android.hardware.Camera.Parameters#isSmoothZoomSupported} is true. * * @param value zoom value. The valid range is 0 to {@link * android.hardware.Camera.Parameters#getMaxZoom}. + * @throws IllegalArgumentException if the zoom value is invalid. + * @throws RuntimeException if the method fails. */ public native final void startSmoothZoom(int value); @@ -545,6 +549,8 @@ public class Camera { * ZoomCallback} to know when the zoom is actually stopped. This method is * supported if {@link * android.hardware.Camera.Parameters#isSmoothZoomSupported} is true. + * + * @throws RuntimeException if the method fails. */ public native final void stopSmoothZoom(); |