diff options
-rw-r--r-- | camera/docs/docs.html | 12 | ||||
-rw-r--r-- | camera/docs/metadata_definitions.xml | 7 |
2 files changed, 19 insertions, 0 deletions
diff --git a/camera/docs/docs.html b/camera/docs/docs.html index 6e0e9a7c..ca2c4a29 100644 --- a/camera/docs/docs.html +++ b/camera/docs/docs.html @@ -3021,6 +3021,12 @@ exposure.<wbr/></p> <p>Only constrains auto-exposure (AE) algorithm,<wbr/> not manual control of <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a> and <a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a>.<wbr/></p> +<p>Note that the actual achievable max framerate also depends on the minimum frame +duration of the output streams.<wbr/> The max frame rate will be +<code>min(aeTargetFpsRange.<wbr/>maxFps,<wbr/> 1 /<wbr/> max(individual stream min durations)</code>.<wbr/> For example,<wbr/> +if the application sets this key to <code>{60,<wbr/> 60}</code>,<wbr/> but the maximum minFrameDuration among +all configured streams is 33ms,<wbr/> the maximum framerate won't be 60fps,<wbr/> but will be +30fps.<wbr/></p> <p>To start a CaptureSession with a target FPS range different from the capture request template's default value,<wbr/> the application is strongly recommended to call @@ -8297,6 +8303,12 @@ exposure.<wbr/></p> <p>Only constrains auto-exposure (AE) algorithm,<wbr/> not manual control of <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a> and <a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a>.<wbr/></p> +<p>Note that the actual achievable max framerate also depends on the minimum frame +duration of the output streams.<wbr/> The max frame rate will be +<code>min(aeTargetFpsRange.<wbr/>maxFps,<wbr/> 1 /<wbr/> max(individual stream min durations)</code>.<wbr/> For example,<wbr/> +if the application sets this key to <code>{60,<wbr/> 60}</code>,<wbr/> but the maximum minFrameDuration among +all configured streams is 33ms,<wbr/> the maximum framerate won't be 60fps,<wbr/> but will be +30fps.<wbr/></p> <p>To start a CaptureSession with a target FPS range different from the capture request template's default value,<wbr/> the application is strongly recommended to call diff --git a/camera/docs/metadata_definitions.xml b/camera/docs/metadata_definitions.xml index c401dc09..533c1d29 100644 --- a/camera/docs/metadata_definitions.xml +++ b/camera/docs/metadata_definitions.xml @@ -827,6 +827,13 @@ xsi:schemaLocation="http://schemas.android.com/service/camera/metadata/ metadata manual control of android.sensor.exposureTime and android.sensor.frameDuration. + Note that the actual achievable max framerate also depends on the minimum frame + duration of the output streams. The max frame rate will be + `min(aeTargetFpsRange.maxFps, 1 / max(individual stream min durations)`. For example, + if the application sets this key to `{60, 60}`, but the maximum minFrameDuration among + all configured streams is 33ms, the maximum framerate won't be 60fps, but will be + 30fps. + 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 |