From 53f91c5c260b25e4763efe52212c1cf404946e27 Mon Sep 17 00:00:00 2001 From: Igor Murashkin Date: Fri, 9 Aug 2013 16:26:14 -0700 Subject: [PATCH] camera2: Clear up docs for CameraDevice#configureOutputs Change-Id: Id2397ca17c5968cb4dfdb337ea56be9d5f481669 --- core/java/android/hardware/camera2/CameraDevice.java | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/core/java/android/hardware/camera2/CameraDevice.java b/core/java/android/hardware/camera2/CameraDevice.java index 422d82781ad32..c3b532da5c7be 100644 --- a/core/java/android/hardware/camera2/CameraDevice.java +++ b/core/java/android/hardware/camera2/CameraDevice.java @@ -173,6 +173,11 @@ public interface CameraDevice extends AutoCloseable { *

This function can take several hundred milliseconds to execute, since * camera hardware may need to be powered on or reconfigured.

* + *

The camera device will query each Surface's size and formats upon this + * call, so they must be set to a valid setting at this time (in particular: + * if the format is user-visible, it must be one of android.scaler.availableFormats; + * and the size must be one of android.scaler.available[Processed|Jpeg]Sizes).

+ * *

To change the configuration after requests have been submitted to the * device, the camera device must be idle. To idle the device, stop any * repeating requests with {@link #stopRepeating stopRepeating}, and then