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

Commit 882446d7 authored by TreeHugger Robot's avatar TreeHugger Robot Committed by Automerger Merge Worker
Browse files

Merge "Camera: Clarify timestamp behavior for VIDEO_RECORD usage flag" into rvc-dev am: 26bf8c7a 

Original change: https://googleplex-android-review.googlesource.com/c/platform/frameworks/base/+/12002522

Change-Id: I2f33806d11d7b7ac91a00a045cc4b420a3e438f1
parents 420ee31b 26bf8c7a

media/java/android/media/ImageReader.java

+14 −0
Original line number Original line Diff line number Diff line
@@ -200,6 +200,20 @@ public class ImageReader implements AutoCloseable { 
     * </table>

     * </table>

     * Using other combinations may result in {@link IllegalArgumentException}.

     * Using other combinations may result in {@link IllegalArgumentException}.

     * </p>

     * </p>

     * <p>

     * If the {@link ImageReader} is used as an output target for a {@link

     * android.hardware.camera2.CameraDevice}, and if the usage flag contains

     * {@link HardwareBuffer#USAGE_VIDEO_ENCODE}, the timestamps of the

     * {@link Image images} produced by the {@link ImageReader} won't be in the same timebase as

     * {@link android.os.SystemClock#elapsedRealtimeNanos}, even if

     * {@link android.hardware.camera2.CameraCharacteristics#SENSOR_INFO_TIMESTAMP_SOURCE} is

     * {@link android.hardware.camera2.CameraCharacteristics#SENSOR_INFO_TIMESTAMP_SOURCE_REALTIME}.

     * Instead, the timestamps will be roughly in the same timebase as in

     * {@link android.os.SystemClock#uptimeMillis}, so that A/V synchronization could work for

     * video recording. In this case, the timestamps from the {@link ImageReader} with

     * {@link HardwareBuffer#USAGE_VIDEO_ENCODE} usage flag may not be directly comparable with

     * timestamps of other streams or capture result metadata.

     * </p>

     * @param width The default width in pixels of the Images that this reader will produce.

     * @param width The default width in pixels of the Images that this reader will produce.

     * @param height The default height in pixels of the Images that this reader will produce.

     * @param height The default height in pixels of the Images that this reader will produce.

     * @param format The format of the Image that this reader will produce. This must be one of the

     * @param format The format of the Image that this reader will produce. This must be one of the