From e90c6d0ad2ed2f3dd789ba49df354c902bd3d2dd Mon Sep 17 00:00:00 2001 From: Chien-Yu Chen Date: Tue, 25 Aug 2015 11:31:58 -0700 Subject: Camera: Update for reprocess session Document that some devices may not support submitting multiple outputs in a single reprocess capture requests. Remove the guaranteed reprocess session configurations that are less common and may not be supported by all devices. Bug: 23422291 Change-Id: I1c869612e9a83ef480113ca2628f68511a150b64 --- core/java/android/hardware/camera2/CameraDevice.java | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) (limited to 'core/java/android/hardware/camera2') diff --git a/core/java/android/hardware/camera2/CameraDevice.java b/core/java/android/hardware/camera2/CameraDevice.java index 4a71aa0..20b0be1 100644 --- a/core/java/android/hardware/camera2/CameraDevice.java +++ b/core/java/android/hardware/camera2/CameraDevice.java @@ -480,8 +480,11 @@ public abstract class CameraDevice implements AutoCloseable { * the configurations in the tables below are also guaranteed for creating a reprocessable * capture session if the camera device supports YUV reprocessing or PRIVATE reprocessing. * However, not all output targets used to create a reprocessable session may be used in a - * {@link CaptureRequest} simultaneously. The guaranteed output targets that can be included - * in a {@link CaptureRequest} simultaneously are listed in the tables under + * {@link CaptureRequest} simultaneously. For devices that support only 1 output target in a + * reprocess {@link CaptureRequest}, submitting a reprocess {@link CaptureRequest} with multiple + * output targets will result in a {@link CaptureFailure}. For devices that support multiple + * output targets in a reprocess {@link CaptureRequest}, the guaranteed output targets that can + * be included in a {@link CaptureRequest} simultaneously are listed in the tables under * {@link #createCaptureSession createCaptureSession}. For example, with a FULL-capability * ({@link CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL} {@code == } * {@link CameraMetadata#INFO_SUPPORTED_HARDWARE_LEVEL_FULL FULL}) device that supports PRIVATE @@ -532,8 +535,6 @@ public abstract class CameraDevice implements AutoCloseable { * {@code PRIV}/{@code YUV}{@code MAXIMUM} Same as input{@code MAXIMUM} {@code PRIV}{@code PREVIEW} {@code YUV}{@code RECORD} High-resolution ZSL in-app video processing with regular preview. * {@code PRIV}{@code MAXIMUM} {@code PRIV}{@code MAXIMUM} {@code PRIV}{@code PREVIEW} {@code YUV}{@code MAXIMUM} Maximum-resolution ZSL in-app processing with regular preview. * {@code PRIV}{@code MAXIMUM} {@code PRIV}{@code MAXIMUM} {@code YUV}{@code PREVIEW} {@code YUV}{@code MAXIMUM} Maximum-resolution two-input ZSL in-app processing. - * {@code PRIV}/{@code YUV}{@code MAXIMUM} Same as input{@code MAXIMUM} {@code PRIV}{@code PREVIEW} {@code YUV}{@code RECORD} {@code JPEG}{@code RECORD} High-resolution ZSL in-app video processing and video snapshot with regular preview. - * {@code PRIV}{@code MAXIMUM} {@code PRIV}{@code MAXIMUM} {@code YUV}{@code PREVIEW} {@code PRIV}{@code PREVIEW} {@code YUV}{@code MAXIMUM} Maximum-resolution two-input ZSL in-app processing with regular preview. * {@code PRIV}/{@code YUV}{@code MAXIMUM} Same as input{@code MAXIMUM} {@code PRIV}{@code PREVIEW} {@code YUV}{@code PREVIEW} {@code JPEG}{@code MAXIMUM} ZSL still capture and in-app processing. *
*

@@ -711,7 +712,9 @@ public abstract class CameraDevice implements AutoCloseable { * provide input images to camera device via {@link android.media.ImageWriter#queueInputImage}. * The application must use the capture result of one of those output images to create a * reprocess capture request so that the camera device can use the information to achieve - * optimal reprocess image quality. + * optimal reprocess image quality. For camera devices that support only 1 output + * {@link Surface}, submitting a reprocess {@link CaptureRequest} with multiple + * output targets will result in a {@link CaptureFailure}. * * @param inputResult The capture result of the output image or one of the output images used * to generate the reprocess input image for this capture request. -- cgit v1.1