Merge "Camera: Improve docs for getOutputMinFrameDuration" into rvc-dev am: 174fd34cba (79c5024b) · Commits · e / os / android_frameworks_base

core/java/android/hardware/camera2/params/StreamConfigurationMap.java

+14 −16

Original line number	Diff line number	Diff line
		@@ -865,22 +865,21 @@ public final class StreamConfigurationMap {
		* <p>{@code size} should be one of the ones returned by
		* {@link #getOutputSizes(int)}.</p>
		*
		* <p>This should correspond to the frame duration when only that stream is active, with all
		* processing (typically in {@code android.*.mode}) set to either {@code OFF} or {@code FAST}.
		* </p>
		* <p>This corresponds to the minimum frame duration (maximum frame rate) possible when only
		* that stream is configured in a session, with all processing (typically in
		* {@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
		* {@code max(individual stream min durations)}.</p>
		* <p>When multiple streams are used in a session, the minimum frame duration will be
		* {@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
		* ({@link android.hardware.camera2.CameraMetadata#REQUEST_AVAILABLE_CAPABILITIES_MANUAL_SENSOR}),
		* 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
		* regardless of whether the stream is input or output.</p>
		* -->
		*
		* @param format an image format from {@link ImageFormat} or {@link PixelFormat}
		* @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
		* {@link #getOutputSizes(int)}.</p>
		*
		* <p>This should correspond to the frame duration when only that stream is active, with all
		* processing (typically in {@code android.*.mode}) set to either {@code OFF} or {@code FAST}.
		* </p>
		* <p>This corresponds to the minimum frame duration (maximum frame rate) possible when only
		* that stream is configured in a session, with all processing (typically in
		* {@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
		* {@code max(individual stream min durations)}.</p>
		* <p>When multiple streams are used in a session, the minimum frame duration will be
		* {@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
		* ({@link android.hardware.camera2.CameraMetadata#REQUEST_AVAILABLE_CAPABILITIES_MANUAL_SENSOR}),
		* 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
		* regardless of whether the stream is input or output.</p>
		* -->
		*
		* @param klass
		* a class which is supported by {@link #isOutputSupportedFor(Class)} and has a