Merge "Camera: Improve docs for getOutputMinFrameDuration" into rvc-dev am: 174fd34cba am: 990429b7dc

Change-Id: I66ee0c161553b0c9d400b7eb10bae708c441c1fe
This commit is contained in:
Eino-Ville Talvala
2020-03-23 23:16:16 +00:00
committed by Automerger Merge Worker

View File

@@ -865,22 +865,21 @@ public final class StreamConfigurationMap {
* <p>{@code size} should be one of the ones returned by * <p>{@code size} should be one of the ones returned by
* {@link #getOutputSizes(int)}.</p> * {@link #getOutputSizes(int)}.</p>
* *
* <p>This should correspond to the frame duration when only that stream is active, with all * <p>This corresponds to the minimum frame duration (maximum frame rate) possible when only
* processing (typically in {@code android.*.mode}) set to either {@code OFF} or {@code FAST}. * that stream is configured in a session, with all processing (typically in
* </p> * {@code android.*.mode}) set to either {@code OFF} or {@code FAST}. </p>
* *
* <p>When multiple streams are used in a request, the minimum frame duration will be * <p>When multiple streams are used in a session, the minimum frame duration will be
* {@code max(individual stream min durations)}.</p> * {@code max(individual stream min durations)}. See {@link #getOutputStallDuration} for
* details of timing for formats that may cause frame rate slowdown when they are targeted by a
* capture request.</p>
* *
* <p>For devices that do not support manual sensor control * <p>For devices that do not support manual sensor control
* ({@link android.hardware.camera2.CameraMetadata#REQUEST_AVAILABLE_CAPABILITIES_MANUAL_SENSOR}), * ({@link android.hardware.camera2.CameraMetadata#REQUEST_AVAILABLE_CAPABILITIES_MANUAL_SENSOR}),
* this function may return 0.</p> * this function may return 0.</p>
* *
* <!--
* TODO: uncomment after adding input stream support
* <p>The minimum frame duration of a stream (of a particular format, size) is the same * <p>The minimum frame duration of a stream (of a particular format, size) is the same
* regardless of whether the stream is input or output.</p> * regardless of whether the stream is input or output.</p>
* -->
* *
* @param format an image format from {@link ImageFormat} or {@link PixelFormat} * @param format an image format from {@link ImageFormat} or {@link PixelFormat}
* @param size an output-compatible size * @param size an output-compatible size
@@ -918,22 +917,21 @@ public final class StreamConfigurationMap {
* <p>{@code size} should be one of the ones returned by * <p>{@code size} should be one of the ones returned by
* {@link #getOutputSizes(int)}.</p> * {@link #getOutputSizes(int)}.</p>
* *
* <p>This should correspond to the frame duration when only that stream is active, with all * <p>This corresponds to the minimum frame duration (maximum frame rate) possible when only
* processing (typically in {@code android.*.mode}) set to either {@code OFF} or {@code FAST}. * that stream is configured in a session, with all processing (typically in
* </p> * {@code android.*.mode}) set to either {@code OFF} or {@code FAST}. </p>
* *
* <p>When multiple streams are used in a request, the minimum frame duration will be * <p>When multiple streams are used in a session, the minimum frame duration will be
* {@code max(individual stream min durations)}.</p> * {@code max(individual stream min durations)}. See {@link #getOutputStallDuration} for
* details of timing for formats that may cause frame rate slowdown when they are targeted by a
* capture request.</p>
* *
* <p>For devices that do not support manual sensor control * <p>For devices that do not support manual sensor control
* ({@link android.hardware.camera2.CameraMetadata#REQUEST_AVAILABLE_CAPABILITIES_MANUAL_SENSOR}), * ({@link android.hardware.camera2.CameraMetadata#REQUEST_AVAILABLE_CAPABILITIES_MANUAL_SENSOR}),
* this function may return 0.</p> * this function may return 0.</p>
* *
* <!--
* TODO: uncomment after adding input stream support
* <p>The minimum frame duration of a stream (of a particular format, size) is the same * <p>The minimum frame duration of a stream (of a particular format, size) is the same
* regardless of whether the stream is input or output.</p> * regardless of whether the stream is input or output.</p>
* -->
* *
* @param klass * @param klass
* a class which is supported by {@link #isOutputSupportedFor(Class)} and has a * a class which is supported by {@link #isOutputSupportedFor(Class)} and has a