Struct SpriteSheet 

pub struct SpriteSheet {
    pub cell_width: u32,
    pub cell_height: u32,
    pub cols: u32,
    pub rows: u32,
    pub sheet_width: u32,
    pub sheet_height: u32,
    pub data: Vec<u8>,
    pub timestamps_ms: Vec<u64>,
}

A sprite sheet: a single wide RGBA image that tiles multiple thumbnails left-to-right, top-to-bottom.

Each cell in the sprite sheet corresponds to one thumbnail at a known timestamp. The sheet is intended for use with an accompanying VTT file so that video players can display scrubber previews.

Fields

cell_width: u32

Width of each individual thumbnail cell in pixels.

cell_height: u32

Height of each individual thumbnail cell in pixels.

cols: u32

Number of columns in the sheet.

rows: u32

Number of rows in the sheet.

sheet_width: u32

Total width of the assembled image (cols * cell_width).

sheet_height: u32

Total height of the assembled image (rows * cell_height).

data: Vec<u8>

Raw RGBA pixel data (row-major, top-to-bottom).

timestamps_ms: Vec<u64>

Timestamps (ms) for each cell, in row-major order.

Implementations

impl SpriteSheet

pub fn from_thumbnails(thumbnails: &[Thumbnail], cols: u32) -> Option<Self>

Assembles a sprite sheet from a collection of Thumbnails.

Thumbnails are laid out left-to-right, top-to-bottom. All thumbnails must have the same dimensions; if they differ they are silently scaled to the first thumbnail’s dimensions using nearest-neighbour sampling.

Returns None when thumbnails is empty.

pub fn cell_origin(&self, idx: usize) -> (u32, u32)

Returns the pixel coordinate (x, y) of the top-left corner of the cell at idx within the sprite sheet.

pub fn to_vtt(&self, sprite_url: &str) -> String

Generates a WebVTT cue file (.vtt) for this sprite sheet.

Arguments

• sprite_url – URL of the sprite sheet image referenced from the VTT.

The returned string is a complete WebVTT document that can be written to disk and served alongside the sprite sheet image.

pub fn cell_count(&self) -> usize

Returns the total number of cells in the sprite sheet.

pub fn byte_len(&self) -> usize

Returns the total byte length of the raw RGBA data.

Trait Implementations

impl Clone for SpriteSheet

fn clone(&self) -> SpriteSheet

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SpriteSheet

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

Formats the value using the given formatter.