diff options
| author | 2023-09-11 14:12:13 -0700 | |
|---|---|---|
| committer | 2023-09-26 18:20:14 +0000 | |
| commit | ec0262ef15ac10666be379976f4590b7c1104452 (patch) | |
| tree | 2a39e8ecf8fed4c7a9b4d72c00a5089999bb0971 | |
| parent | 7fb5f474b4f94ac5d0b90b4b1211feb1ba15e7c7 (diff) | |
Camera: Clarify interaction between fpsRange and minFrameDuration
Test: Build and read docs
Bug: 294619809
Change-Id: I775265312f30a45282343926ccadba4715a68e17
| -rw-r--r-- | core/java/android/hardware/camera2/CaptureRequest.java | 6 | ||||
| -rw-r--r-- | core/java/android/hardware/camera2/CaptureResult.java | 6 |
2 files changed, 12 insertions, 0 deletions
diff --git a/core/java/android/hardware/camera2/CaptureRequest.java b/core/java/android/hardware/camera2/CaptureRequest.java index 703f16553ddb..25c84e5e9c58 100644 --- a/core/java/android/hardware/camera2/CaptureRequest.java +++ b/core/java/android/hardware/camera2/CaptureRequest.java @@ -1468,6 +1468,12 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> * <p>Only constrains auto-exposure (AE) algorithm, not * manual control of {@link CaptureRequest#SENSOR_EXPOSURE_TIME android.sensor.exposureTime} and * {@link CaptureRequest#SENSOR_FRAME_DURATION android.sensor.frameDuration}.</p> + * <p>Note that the actual achievable max framerate also depends on the minimum frame + * duration of the output streams. The max frame rate will be + * <code>min(aeTargetFpsRange.maxFps, 1 / max(individual stream min durations)</code>. For example, + * if the application sets this key to <code>{60, 60}</code>, but the maximum minFrameDuration among + * all configured streams is 33ms, the maximum framerate won't be 60fps, but will be + * 30fps.</p> * <p>To start a CaptureSession with a target FPS range different from the * capture request template's default value, the application * is strongly recommended to call diff --git a/core/java/android/hardware/camera2/CaptureResult.java b/core/java/android/hardware/camera2/CaptureResult.java index 746648ba7ac5..986dd889520d 100644 --- a/core/java/android/hardware/camera2/CaptureResult.java +++ b/core/java/android/hardware/camera2/CaptureResult.java @@ -887,6 +887,12 @@ public class CaptureResult extends CameraMetadata<CaptureResult.Key<?>> { * <p>Only constrains auto-exposure (AE) algorithm, not * manual control of {@link CaptureRequest#SENSOR_EXPOSURE_TIME android.sensor.exposureTime} and * {@link CaptureRequest#SENSOR_FRAME_DURATION android.sensor.frameDuration}.</p> + * <p>Note that the actual achievable max framerate also depends on the minimum frame + * duration of the output streams. The max frame rate will be + * <code>min(aeTargetFpsRange.maxFps, 1 / max(individual stream min durations)</code>. For example, + * if the application sets this key to <code>{60, 60}</code>, but the maximum minFrameDuration among + * all configured streams is 33ms, the maximum framerate won't be 60fps, but will be + * 30fps.</p> * <p>To start a CaptureSession with a target FPS range different from the * capture request template's default value, the application * is strongly recommended to call |