Struct MediaCodecFrame 

pub struct MediaCodecFrame { /* private fields */ }

Available on Android only.

MediaCodec decoder output frame in SurfaceTexture-backed mode.

Implementations

impl MediaCodecFrame

pub unsafe fn try_from_raw( buffer: *mut c_void, surface_texture: *mut c_void, format: PixelFormat, width: u32, height: u32, serial: u64, keep_alive: Option<KeepAlive>, ) -> Result<Self, InvalidHandleError>

Wrap a MediaCodec output buffer together with the SurfaceTexture it will be rendered into. Borrowing: the handle is stored non-owningly, this type has no Drop, and every obligation below extends to each Clone.

Safety

• buffer must point to a live, not yet released MediaCodec output buffer — an AVMediaCodecBuffer* from FFmpeg’s mediacodec hwaccel, or the AMediaCodecBufferInfo* of an NDK-dequeued output index. The import path hands it to av_mediacodec_release_buffer / AMediaCodec_releaseOutputBuffer with render = true to push the frame onto the surface, so a buffer that was already released is a double release. Null is rejected as InvalidHandleError::NullPointer and is not a caller obligation.
• Each buffer may be wrapped once. Rendering is a one-shot consuming act on the codec’s side; because this newtype is Clone and takes no ownership, two live carriers naming the same buffer will each try to release it.
• surface_texture must be a JNI global reference (not a local ref, which is invalid outside the JNI frame that made it) to the android.graphics.SurfaceTexture that backs the Surface this codec was configured with. It is not null-checked here.
• width, height and format must describe the frame the codec will render; the importer sizes its destination texture from them.
• Thread affinity — the sharp edge. MediaCodecFrame is Send + Sync, but SurfaceTexture.updateTexImage() is only legal on a thread with the OES texture’s GL context current, and only one updateTexImage may be in flight per texture. The caller asserts the consumer will be driven from such a thread, and that serial is monotonically increasing so the importer can detect out-of-order or repeated presentation.
• Lifetime: nothing is retained and there is no Drop. The codec, its output surface and the SurfaceTexture global ref must all outlive this value and every Clone of it — keep_alive exists to anchor them.

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

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

pub fn format(&self) -> PixelFormat

pub fn width(&self) -> u32

pub fn height(&self) -> u32

pub fn serial(&self) -> u64

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

Trait Implementations

impl Clone for MediaCodecFrame

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 MediaCodecFrame

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

Formats the value using the given formatter.

impl Send for MediaCodecFrame

impl Sync for MediaCodecFrame