Struct AImageFrame 

pub struct AImageFrame { /* private fields */ }

Available on Android only.

AImage* with extracted AHB + per-frame metadata.

Implementations

impl AImageFrame

pub unsafe fn try_from_raw( image: *mut c_void, hardware: *mut c_void, timestamp_ns: i64, crop: Option<(i32, i32, i32, i32)>, format: PixelFormat, color: Option<ColorMetadata>, keep_alive: Option<KeepAlive>, ) -> Result<Self, InvalidHandleError>

Wrap an AImage* together with the AHardwareBuffer* extracted from it. Borrowing: the handle is stored non-owningly, this type has no Drop, and every obligation below extends to each Clone.

Safety

• image must point to a live AImage that has not been AImage_deleted, and hardware to the AHardwareBuffer* obtained from that AImage via AImage_getHardwareBuffer. Both nulls are rejected as InvalidHandleError::NullPointer and are not caller obligations.
• AImage_getHardwareBuffer returns a borrowed pointer. The returned buffer’s reference belongs to the AImage and is invalidated by AImage_delete. Neither pointer is retained here and there is no Drop, so keep_alive must hold whatever keeps the AImage — and therefore the buffer — alive for the lifetime of this value and every Clone of it. With keep_alive == None the caller carries that directly. Releasing the image while a clone survives is a use-after-free in the importer.
• crop, when Some, must be (left, top, right, bottom) from AImage_getCropRect and must lie inside the buffer’s dimensions; consumers sample only that rectangle.
• format must be the buffer’s real layout and timestamp_ns the value from AImage_getTimestamp.
• color, when Some, overrides the AHB driver’s suggested YCbCr model on the compute-unpack path (see the field docs above). It must be the stream’s true matrix and range: a wrong value is not unsound, but it silently decodes with the wrong matrix, which is exactly the failure it exists to prevent.
• No thread affinity for the handle itself; the usual acquire-fence discipline still applies before reading the buffer’s pixels.

pub fn image(&self) -> *mut c_void

pub fn hardware(&self) -> *mut c_void

pub fn timestamp_ns(&self) -> i64

pub fn crop(&self) -> Option<(i32, i32, i32, i32)>

pub fn format(&self) -> PixelFormat

pub fn color(&self) -> Option<ColorMetadata>

Caller-known color metadata, when the producer signalled it. See the field docs — authoritative over the AHB driver’s suggested YCbCr model on the compute-unpack path.

pub fn keep_alive(&self) -> Option<&KeepAlive>

Trait Implementations

impl Clone for AImageFrame

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AImageFrame

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Send for AImageFrame

impl Sync for AImageFrame