Struct Av1TileConfig 

pub struct Av1TileConfig {
    pub tile_cols_log2: u8,
    pub tile_rows_log2: u8,
    pub threads: usize,
    pub row_mt: bool,
}

Configuration for AV1 tile-based parallel encoding.

AV1 supports dividing each frame into an M × N grid of independently encodable tiles. Encoding multiple tiles in parallel with rayon reduces wall-clock time on multi-core systems while producing a bitstream that is backward-compatible with single-threaded decoders.

tile_cols and tile_rows are specified as log2 values following the AV1 specification (e.g. 2 → 4 tile columns). Use Av1TileConfig::auto to pick sensible defaults for a given resolution.

Fields

tile_cols_log2: u8

Log2 number of tile columns (0–6).

tile_rows_log2: u8

Log2 number of tile rows (0–6).

threads: usize

Number of rayon worker threads (0 = auto).

row_mt: bool

Enable row-based multi-threading within each tile.

Implementations

impl Av1TileConfig

pub fn new( tile_cols_log2: u8, tile_rows_log2: u8, threads: usize, ) -> Result<Self>

Creates a new AV1 tile configuration with explicit log2 tile counts.

Errors

Returns an error when tile_cols_log2 or tile_rows_log2 exceeds 6.

pub fn auto(_width: u32, height: u32, threads: usize) -> Self

Automatically selects tile counts appropriate for the given resolution.

Resolution	tile_cols_log2	tile_rows_log2
≤ 720p	1 (2 cols)	0 (1 row)
1080p	1 (2 cols)	1 (2 rows)
4K (2160p)	2 (4 cols)	2 (4 rows)
8K (4320p)	3 (8 cols)	2 (4 rows)

pub fn tile_cols(&self) -> u32

Returns the actual number of tile columns (2^tile_cols_log2).

pub fn tile_rows(&self) -> u32

Returns the actual number of tile rows (2^tile_rows_log2).

pub fn total_tiles(&self) -> u32

Returns the total number of tiles per frame.

pub fn validate_for_frame(&self, width: u32, height: u32) -> Result<()>

Validates the configuration against frame dimensions.

Errors

Returns an error if the tile grid would produce tiles smaller than 64×64 pixels (the AV1 minimum superblock size).

Trait Implementations

impl Clone for Av1TileConfig

fn clone(&self) -> Av1TileConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Av1TileConfig

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

Formats the value using the given formatter.

impl Default for Av1TileConfig

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for Av1TileConfig

fn eq(&self, other: &Av1TileConfig) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Av1TileConfig

impl StructuralPartialEq for Av1TileConfig