Struct EncoderInput 

pub struct EncoderInput {
    pub pixel_format: AVPixelFormat,
    pub hw_frames_ctx: Option<AvBuffer>,
    pub hw_device_ctx: Option<AvBuffer>,
    pub color_matrix: YuvMatrix,
}

What the video encoders of a render are opened with, the outcome of FFramesRenderBackend::negotiate_encoder_input. Every VideoFrame submitted to the render has to match it.

Fields

pixel_format: AVPixelFormat

AVCodecContext::pix_fmt: a software format, or a hardware one together with hw_frames_ctx.

hw_frames_ctx: Option<AvBuffer>

The pool the hardware frames come from (AVCodecContext::hw_frames_ctx).

hw_device_ctx: Option<AvBuffer>

AVCodecContext::hw_device_ctx for encoders that want the device only.

color_matrix: YuvMatrix

The matrix the frames are converted to YUV with. The encoder tags the stream with it.

Implementations

impl EncoderInput

pub fn software(pixel_format: AVPixelFormat) -> Self

Frames with pixels in memory, converted with BT.601.

pub fn for_options(options: &EncoderOptions<'_>) -> Self

Frames with pixels in memory in the pixel format and color matrix of options.

pub fn with_color_matrix(self, color_matrix: YuvMatrix) -> Self

The same frames converted with color_matrix.

pub fn requested(encoder: &VideoEncoderInfo<'_>) -> RenderEncodingResult<Self>

The pixel format the user requested, as long as the encoder takes it.

pub fn hardware_frames( device: &AvBuffer, format: AVPixelFormat, sw_format: AVPixelFormat, (width, height): (i32, i32), configure: impl FnOnce(&mut AVHWFramesContext), ) -> RenderEncodingResult<Self>

Hardware frames of format holding sw_format pixels, allocated by libav on device (see hardware_device). Get the frames with VideoFrame::from_hw_frames. They are converted with BT.601 unless Self::with_color_matrix says otherwise.

configure runs before the pool is initialized and may adjust the API specific context (AVHWFramesContext::hwctx).

pub fn is_hardware(&self) -> bool

pub fn software_format(&self) -> AVPixelFormat

The format of the pixels: pixel_format itself, or what the hardware frames hold.

Trait Implementations

impl Clone for EncoderInput

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 EncoderInput

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

Formats the value using the given formatter.