Struct Texture 

pub struct Texture<'a> { /* private fields */ }

A parsed 2D texture backed by slices into the caller’s cooked blob. Pixel data is already packed into the halfword-nibble layout the PSX GPU reads; the CLUT (if any) is a slice of RGB555 halfwords.

Construct by Texture::from_bytes(&blob); upload to VRAM via [Texture::upload], which returns the matching TexturePage + Clut handles ready to feed into primitive constructors.

Implementations

impl<'a> Texture<'a>

pub fn from_bytes(bytes: &'a [u8]) -> Result<Self, ParseError>

Parse a cooked .psxt blob. Returns a Texture view that borrows into bytes. Cheap – header decode + two slice computations.

pub fn width(&self) -> u16

Width in texels.

pub fn height(&self) -> u16

Height in texels.

pub fn depth(&self) -> Depth

Colour depth.

pub fn clut_entries(&self) -> u16

Number of CLUT entries in the blob. Normal textures use 16 for 4bpp, 256 for 8bpp, or 0 for 15bpp; specialized 4bpp assets may concatenate multiple 16-entry CLUT rows.

pub fn flags(&self) -> u16

Texture feature flags from the shared asset header.

pub fn is_index_zero_transparent(&self) -> bool

True when indexed palette entry 0 should remain transparent.

pub fn pixel_bytes(&self) -> &'a [u8]

Raw packed pixel halfwords, as bytes. Suitable for halfword-level DMA upload; caller pairs this with a VramRect describing the halfword footprint, not the texel width.

pub fn clut_bytes(&self) -> &'a [u8]

Raw CLUT halfwords, as bytes. Empty for 15bpp.

pub fn halfwords_per_row(&self) -> u16

Halfwords-per-row at this texture’s depth (rows padded up to a full halfword). Needed when computing the VRAM rect for upload: VRAM measures in halfwords regardless of the texel depth the GPU will fetch them at.

Trait Implementations

impl<'a> Clone for Texture<'a>

fn clone(&self) -> Texture<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Texture<'a>

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

Formats the value using the given formatter.

impl<'a> Copy for Texture<'a>