Share via


OutputConfiguration.TimestampBaseDefault Field

Definition

Caution

This constant will be removed in the future version. Use Android.Hardware.Camera2.Params.TimestampBase enum directly instead of this field.

Default timestamp base.

[Android.Runtime.Register("TIMESTAMP_BASE_DEFAULT", ApiSince=33)]
[System.Obsolete("This constant will be removed in the future version. Use Android.Hardware.Camera2.Params.TimestampBase enum directly instead of this field.", true)]
public const Android.Hardware.Camera2.Params.TimestampBase TimestampBaseDefault = 0;
[<Android.Runtime.Register("TIMESTAMP_BASE_DEFAULT", ApiSince=33)>]
[<System.Obsolete("This constant will be removed in the future version. Use Android.Hardware.Camera2.Params.TimestampBase enum directly instead of this field.", true)>]
val mutable TimestampBaseDefault : Android.Hardware.Camera2.Params.TimestampBase

Field Value

Value = 0

Implements

Attributes

Remarks

Default timestamp base.

The camera device decides the timestamp based on the properties of the output surface.

<li> For a SurfaceView output surface, the timestamp base is #TIMESTAMP_BASE_CHOREOGRAPHER_SYNCED. The timestamp is overridden with choreographer pulses from the display subsystem for smoother display of camera frames when the camera device runs in fixed frame rate. The timestamp is roughly in the same time base as android.os.SystemClock#uptimeMillis.</li> <li> For an output surface of MediaRecorder, MediaCodec, or ImageReader with android.hardware.HardwareBuffer#USAGE_VIDEO_ENCODE usage flag, the timestamp base is #TIMESTAMP_BASE_MONOTONIC, which is roughly the same time base as android.os.SystemClock#uptimeMillis.</li> <li> For all other cases, the timestamp base is #TIMESTAMP_BASE_SENSOR, the same as what's specified by 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 #TIMESTAMP_BASE_SENSOR.</li></ul></li>

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, #TIMESTAMP_BASE_SENSOR should be used instead.

Java documentation for android.hardware.camera2.params.OutputConfiguration.TIMESTAMP_BASE_DEFAULT.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to