Struct Encoder

pub struct Encoder { /* private fields */ }

Encoder config builder

Implementations

impl Encoder

Builder methods

pub fn new() -> Self

Start here

pub fn with_quality(self, quality: f32) -> Self

Quality 1..=100. Panics if out of range.

pub fn with_depth(self, depth: Option<u8>) -> Self

Depth 8 or 10. None picks automatically.

pub fn with_alpha_quality(self, quality: f32) -> Self

Quality for the alpha channel only. 1..=100. Panics if out of range.

pub fn with_speed(self, speed: u8) -> Self

1..=10. 1 = very very slow, but max compression. 10 = quick, but larger file sizes and lower quality.

pub fn with_internal_color_space(self, color_space: ColorSpace) -> Self

Changes how color channels are stored in the image. The default is YCbCr.

Note that this is only internal detail for the AVIF file, and doesn’t change color space of inputs to encode functions.

pub fn with_num_threads(self, num_threads: Option<usize>) -> Self

Configures rayon thread pool size. The default None is to use all threads in the default rayon thread pool.

pub fn with_alpha_color_mode(self, mode: AlphaColorMode) -> Self

Configure handling of color channels in transparent images

impl Encoder

Once done with config, call one of the encode_* functions

pub fn encode_rgba( &self, in_buffer: Img<&[RGBA<u8>]>, ) -> Result<EncodedImage, Error>

Make a new AVIF image from RGBA pixels (non-premultiplied, alpha last)

Make the Img for the buffer like this:

Img::new(&pixels_rgba[..], width, height)

If you have pixels as u8 slice, then first do:

use rgb::ComponentSlice;
let pixels_rgba = pixels_u8.as_rgba();

If all pixels are opaque, the alpha channel will be left out automatically.

This function takes 8-bit inputs, but will generate an AVIF file using 10-bit depth.

returns AVIF file with info about sizes about AV1 payload.

pub fn encode_rgb(&self, buffer: Img<&[RGB8]>) -> Result<EncodedImage, Error>

Make a new AVIF image from RGB pixels

Make the Img for the buffer like this:

Img::new(&pixels_rgb[..], width, height)

If you have pixels as u8 slice, then first do:

use rgb::ComponentSlice;
let pixels_rgb = pixels_u8.as_rgb();

returns AVIF file, size of color metadata

pub fn encode_raw_planes_8_bit( &self, width: usize, height: usize, planes: impl IntoIterator<Item = [u8; 3]> + Send, alpha: Option<impl IntoIterator<Item = u8> + Send>, color_pixel_range: PixelRange, matrix_coefficients: MatrixCoefficients, ) -> Result<EncodedImage, Error>

Encodes AVIF from 3 planar channels that are in the color space described by matrix_coefficients, with sRGB transfer characteristics and color primaries.

Alpha always uses full range. Chroma subsampling is not supported, and it’s a bad idea for AVIF anyway. If there’s no alpha, use None::<[_; 0]>.

returns AVIF file, size of color metadata, size of alpha metadata overhead

pub fn encode_raw_planes_10_bit( &self, width: usize, height: usize, planes: impl IntoIterator<Item = [u16; 3]> + Send, alpha: Option<impl IntoIterator<Item = u16> + Send>, color_pixel_range: PixelRange, matrix_coefficients: MatrixCoefficients, ) -> Result<EncodedImage, Error>

Encodes AVIF from 3 planar channels that are in the color space described by matrix_coefficients, with sRGB transfer characteristics and color primaries.

The pixels are 10-bit (values 0.=1023).

Alpha always uses full range. Chroma subsampling is not supported, and it’s a bad idea for AVIF anyway. If there’s no alpha, use None::<[_; 0]>.

returns AVIF file, size of color metadata, size of alpha metadata overhead

Trait Implementations

impl Clone for Encoder

fn clone(&self) -> Encoder

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Encoder

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

Formats the value using the given formatter.