Struct Texture 

pub struct Texture {
    pub data: &'static [Rgb565],
    pub width: u32,
    pub height: u32,
    /* private fields */
}

A 2D texture with RGB565 pixel data

Textures must have power-of-2 dimensions (8, 16, 32, 64, 128, 256, etc.) for efficient wrapping using bit masks instead of modulo operations.

Fields

data: &'static [Rgb565]

Texture pixel data in RGB565 format

width: u32

Width of the texture (must be power of 2)

height: u32

Height of the texture (must be power of 2)

Implementations

impl Texture

pub fn new(data: &'static [Rgb565], width: u32, height: u32) -> Self

Create a new texture

Arguments

• data - Static RGB565 pixel array (must be width × height elements)
• width - Texture width (must be power of 2)
• height - Texture height (must be power of 2)

Panics

Panics if width or height is not a power of 2, or if data length doesn’t match dimensions

pub fn sample(&self, u: f32, v: f32) -> Rgb565

Sample the texture at UV coordinates

Uses nearest-neighbor sampling with wrapping (repeat mode). UV coordinates are in the range [0.0, 1.0] where:

• (0, 0) is the top-left corner
• (1, 1) is the bottom-right corner

Arguments

• u - Horizontal texture coordinate (0.0-1.0+, wraps)
• v - Vertical texture coordinate (0.0-1.0+, wraps)

pub fn sample_fixed(&self, u_fixed: u32, v_fixed: u32) -> Rgb565

Sample the texture at UV coordinates (integer version for performance)

Uses fixed-point UV coordinates (16.16 format) for faster inner loops.

Arguments

• u_fixed - Horizontal texture coordinate in 16.16 fixed-point
• v_fixed - Vertical texture coordinate in 16.16 fixed-point

pub fn sample_affine_q16(&self, u_q16: u32, v_q16: u32) -> Rgb565

Sample the texture at Q16.16 fixed-point UV coordinates using fast affine indexing.

u_q16 and v_q16 are 16.16 fixed-point numbers where 65536 represents 1.0.

pub fn sample_affine_2xssaa_q16(&self, u_q16: u32, v_q16: u32) -> Rgb565

Sample the texture at Q16.16 fixed-point UV coordinates using 2xSSAA (4-sample sub-pixel anti-aliasing).

Offsets 4 sub-pixel samples by ±0.25 in Q16 (±0x4000) and averages their colors to reduce texture aliasing at non-rectilinear angles.

pub fn sample_affine_scanline_q16( &self, u_q16: u32, v_q16: u32, du_q16: u32, dv_q16: u32, out_buffer: &mut [Rgb565], )

Sample a horizontal scanline using Q16.16 fixed-point affine UV stepping.

pub fn dimensions(&self) -> (u32, u32)

Get texture dimensions

Trait Implementations

impl Clone for Texture

fn clone(&self) -> Texture

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Texture

impl Debug for Texture

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

Formats the value using the given formatter.