Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Camera: Clarify timestamp behavior for VIDEO_RECORD usage flag

Browse Source 
Test: make docs and read the doc
Bug: 143240912
Change-Id: I64032c7e2644680888979696968bdebd772530cc
This commit is contained in:
Shuzhen Wang
2020-06-25 15:12:34 -07:00
parent d65287ec7b
commit f09a4cdbd6
1 changed files with 14 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
media/java/android/media/ImageReader.java
View File

@@ -200,6 +200,20 @@ public class ImageReader implements AutoCloseable {
* </table>
* Using other combinations may result in {@link IllegalArgumentException}.
* </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 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