Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit bca2a32c authored by Shuzhen Wang's avatar Shuzhen Wang
Browse files

Camera: Update doc to describe tradeoff of DEFAULT timestamp base 

Describe the tradeoffs of preview jitter reduction, and mention that
the application can turn off jitter reduction for better latency.

Test: Build
Bug: 195025014
Change-Id: I68f99efe6a35ae9db0f4cdf75ef31879f8550ff8
parent 89c33258

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

+10 −1
Original line number Diff line number Diff line
@@ -166,7 +166,16 @@ public final class OutputConfiguration implements Parcelable { 
     * {@link #TIMESTAMP_BASE_MONOTONIC}, which is roughly the same time base as

     * {@link android.os.SystemClock#uptimeMillis}.</li>

     * <li> For all other cases, the timestamp base is {@link #TIMESTAMP_BASE_SENSOR}, the same

     * as what's specified by {@link CameraCharacteristics#SENSOR_INFO_TIMESTAMP_SOURCE}.</li>

     * as what's specified by {@link CameraCharacteristics#SENSOR_INFO_TIMESTAMP_SOURCE}.

     * <ul><li> For a SurfaceTexture output surface, the camera system re-spaces the delivery

     * of output frames based on image readout intervals, reducing viewfinder jitter. The timestamps

     * of images remain to be {@link #TIMESTAMP_BASE_SENSOR}.</li></ul></li>

     *

     * <p>Note that the reduction of frame jitter for SurfaceView and SurfaceTexture comes with

     * slight increase in photon-to-photon latency, which is the time from when photons hit the

     * scene to when the corresponding pixels show up on the screen. If the photon-to-photon latency

     * is more important than the smoothness of viewfinder, {@link #TIMESTAMP_BASE_SENSOR} should be

     * used instead.</p>

     *

     * @see #TIMESTAMP_BASE_CHOREOGRAPHER_SYNCED

     * @see #TIMESTAMP_BASE_MONOTONIC