diff options
| author | 2022-05-14 20:07:46 +0000 | |
|---|---|---|
| committer | 2022-05-14 20:07:46 +0000 | |
| commit | cda2f8b06b6b5443463b22b1275340ef8fcb33ab (patch) | |
| tree | e8e2aa22236968dd6b1260dc36db037c38e4b097 | |
| parent | 2ca986cd50ba3c1e0d643abf345d9bee325f9767 (diff) | |
| parent | 065c279cb6a79ff0953f986d58f2687eb32a90e7 (diff) | |
Merge "Camera: Update doc to describe tradeoff of DEFAULT timestamp base" into tm-dev am: b15596cb67 am: 065c279cb6
Original change: https://googleplex-android-review.googlesource.com/c/platform/frameworks/base/+/18322257
Change-Id: I6ff627ac95497938f78c42f57463755ecbeb15ac
Signed-off-by: Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
| -rw-r--r-- | core/java/android/hardware/camera2/params/OutputConfiguration.java | 11 |
1 files changed, 10 insertions, 1 deletions
diff --git a/core/java/android/hardware/camera2/params/OutputConfiguration.java b/core/java/android/hardware/camera2/params/OutputConfiguration.java index 204e6b60d3dc..9e8703779863 100644 --- a/core/java/android/hardware/camera2/params/OutputConfiguration.java +++ b/core/java/android/hardware/camera2/params/OutputConfiguration.java @@ -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 |