Struct TextureMaterial 

pub struct TextureMaterial { /* private fields */ }

Textured primitive material.

clut_word is the packed CLUT handle used by indexed textures. tpage_word is the packed tpage word normally produced by TexturePage::uv_word(0). The material rewrites the tpage blend bits from BlendMode so one base tpage can be reused across opaque and translucent variants.

Implementations

impl TextureMaterial

pub const fn new(clut_word: u16, tpage_word: u16) -> Self

Build an opaque, unmodulated texture material.

pub const fn opaque(clut_word: u16, tpage_word: u16, tint: (u8, u8, u8)) -> Self

Build an opaque texture material with a flat tint.

pub const fn blended( clut_word: u16, tpage_word: u16, tint: (u8, u8, u8), blend_mode: BlendMode, ) -> Self

Build a translucent texture material with a flat tint.

Textured primitives still follow PS1 texel rules: the primitive command enables transparency, and sampled texels with bit 15 set actually blend through the selected mode.

pub const fn with_blend_mode(self, blend_mode: BlendMode) -> Self

Return a copy using blend_mode.

For a textured primitive this only selects the blending equation. Which texels actually blend is decided per texel by bit 15 of the palette entry (psx_vram::Color555::with_stp); a CLUT without that bit draws fully opaque whatever is set here, and nothing reports it. For an untextured primitive the mode applies to the whole polygon.

pub const fn with_tint(self, tint: (u8, u8, u8)) -> Self

Return a copy using tint.

pub const fn with_clut_bank(self, bank: u8) -> Self

Return a copy selecting a consecutive 16-entry 4bpp CLUT bank.

pub const fn with_texture_window(self, texture_window: TextureWindow) -> Self

Return a copy using texture_window.

pub const fn with_raw_texture(self, raw_texture: bool) -> Self

Return a copy with raw texture modulation enabled or disabled.

Raw-texture mode bypasses RGB tint modulation. It is useful for palettes or direct textures that already carry final colors.

pub const fn with_dither(self, dither: bool) -> Self

Return a copy with draw-mode dithering enabled or disabled.

pub const fn clut_word(self) -> u16

Packed CLUT word for the first textured UV word.

pub const fn texture_page_word(self) -> u16

Packed tpage word for textured polygon UV words.

The material owns the tpage blend and dither bits; all other tpage address/depth bits are preserved from the original word.

pub const fn texture_window_word(self) -> u32

GP0(E2) texture-window word for this material.

pub const fn tint(self) -> (u8, u8, u8)

Flat tint used by non-Gouraud textured primitives.

pub const fn blend_mode(self) -> BlendMode

Active blend mode.

pub const fn is_translucent(self) -> bool

True when the primitive command should set its semi-transparent bit.

pub const fn is_raw_texture(self) -> bool

True when the primitive command should set its raw-texture bit.

pub const fn is_dithered(self) -> bool

True when the material asks GP0(E1) / primitive tpage state for dithering.

pub const fn textured_polygon_command(self, gouraud: bool, quad: bool) -> u32

Textured polygon command bits without the low RGB payload.

pub const fn textured_gouraud_packet_material( self, ) -> TexturedGouraudPacketMaterial

Prepacked words for textured Gouraud triangle packet emission.

pub const fn textured_packet_material(self) -> TexturedPacketMaterial

Prepacked words for flat textured triangle packet emission.

pub const fn flat_textured_polygon_header(self, quad: bool) -> u32

Textured polygon header with the material’s flat tint.

pub const fn textured_rect_header(self) -> u32

Textured rectangle command with the material’s flat tint.

pub const fn draw_mode_word(self) -> u32

GP0(E1) draw-mode word implied by this material.

Textured rectangles read their tpage from this state. Textured polygons embed the tpage word directly, but applying the same material state before drawing keeps subsequent sprite draws in sync.

pub fn apply_draw_mode(self)

👎Deprecated:

use Gpu::set_draw_mode

Apply this material’s tpage, blend, depth, dither, and texture-window state.

Trait Implementations

impl Clone for TextureMaterial

fn clone(&self) -> TextureMaterial

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TextureMaterial

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

Formats the value using the given formatter.

impl PartialEq for TextureMaterial

fn eq(&self, other: &TextureMaterial) -> 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 Copy for TextureMaterial

impl Eq for TextureMaterial

impl StructuralPartialEq for TextureMaterial