public final class CameraFrame

Object
CameraFrame

A single frame delivered to a FrameListener.

Lifetime: the byte arrays returned by this class are valid only while FrameListener#onFrame(CameraFrame) is on the stack. After it returns the framework may reuse or release the underlying buffers. Clone any data you need to keep.

Constructors

public CameraFrame(byte[] jpegBytes, byte[] rawBytes, int width, int height, int rotationDegrees, long timestampNanos, FrameFormat format) Used by platform implementations.

Methods

`public byte[] getJpegBytes()`	JPEG-encoded bytes for this frame.
`public byte[] getRawBytes()`	Raw pixel bytes in the format requested via `CameraSessionOptions#frameFormat(FrameFormat)`.
`public int getWidth()`	Pixel width of the frame.
`public int getHeight()`	Pixel height of the frame.
`public int getRotationDegrees()`	Clockwise rotation in degrees (0, 90, 180, 270) that should be applied to the bytes to display them upright.
`public long getTimestampNanos()`	Monotonic timestamp in nanoseconds.
`public` `FrameFormat getFormat()`	Pixel format requested for this frame.

Inherited methods

From Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait, clone

Constructor details

CameraFrame

public CameraFrame(byte[] jpegBytes, byte[] rawBytes, int width, int height, int rotationDegrees, long timestampNanos, FrameFormat format)

Used by platform implementations.

Method details

getJpegBytes

public byte[] getJpegBytes()

JPEG-encoded bytes for this frame. Always non-null regardless of the requested FrameFormat; use this when encoded image data is needed. VisionImage#fromCameraFrame(CameraFrame) instead selects the raw buffer for NV21 and RGBA8888 frames.

getRawBytes

public byte[] getRawBytes()

Raw pixel bytes in the format requested via CameraSessionOptions#frameFormat(FrameFormat). This is null for JPEG requests and may also be null when the current port cannot expose the requested raw format. In that case getJpegBytes() remains available as a fallback.

getWidth

public int getWidth()

Pixel width of the frame.

getHeight

public int getHeight()

Pixel height of the frame.

getRotationDegrees

public int getRotationDegrees()

Clockwise rotation in degrees (0, 90, 180, 270) that should be applied to the bytes to display them upright.

getTimestampNanos

public long getTimestampNanos()

Monotonic timestamp in nanoseconds. Useful for measuring inter-frame intervals.

getFormat

public FrameFormat getFormat()

Pixel format requested for this frame. A non-JPEG value describes getRawBytes() when that buffer is available; ports that cannot expose raw pixels may return null there while still reporting the requested format. JPEG bytes returned by getJpegBytes() are always JPEG-encoded regardless of this value.