Merge "Camera: Update doc to describe tradeoff of DEFAULT timestamp base" into tm-dev am: b15596cb67
Original change: https://googleplex-android-review.googlesource.com/c/platform/frameworks/base/+/18322257 Change-Id: I7ced63c3e66fc4275382d8801cc950b55a17ec06 Signed-off-by: Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
This commit is contained in:
@@ -166,7 +166,16 @@ public final class OutputConfiguration implements Parcelable {
|
|||||||
* {@link #TIMESTAMP_BASE_MONOTONIC}, which is roughly the same time base as
|
* {@link #TIMESTAMP_BASE_MONOTONIC}, which is roughly the same time base as
|
||||||
* {@link android.os.SystemClock#uptimeMillis}.</li>
|
* {@link android.os.SystemClock#uptimeMillis}.</li>
|
||||||
* <li> For all other cases, the timestamp base is {@link #TIMESTAMP_BASE_SENSOR}, the same
|
* <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_CHOREOGRAPHER_SYNCED
|
||||||
* @see #TIMESTAMP_BASE_MONOTONIC
|
* @see #TIMESTAMP_BASE_MONOTONIC
|
||||||
|
|||||||
Reference in New Issue
Block a user