Struct SpriteInstance 

#[repr(C)]
pub struct SpriteInstance {
    pub pos: [f32; 2],
    pub size: [f32; 2],
    pub uv_min: [f32; 2],
    pub uv_max: [f32; 2],
    pub color: [f32; 4],
    pub rotation: f32,
    pub _pad: [f32; 3],
}

Fields

pos: [f32; 2]

size: [f32; 2]

uv_min: [f32; 2]

uv_max: [f32; 2]

color: [f32; 4]

rotation: f32

_pad: [f32; 3]

Padding to a 16-byte multiple. _pad[0] doubles as the CPU-side marker for SpriteInstance::with_pixel_region; leave it zeroed.

Implementations

impl SpriteInstance

pub fn at(pos: [f32; 2], size: [f32; 2]) -> SpriteInstance

pub fn with_color(self, c: impl Into<Color>) -> SpriteInstance

pub fn with_rotation(self, r: f32) -> SpriteInstance

pub fn with_uv(self, min: [f32; 2], max: [f32; 2]) -> SpriteInstance

Sample the UV rectangle min..max ([0.0, 0.0]..[1.0, 1.0] is the whole texture). Beyond 0..1 the texture tiles only if it was set to crate::TextureWrap::Repeat (or MirrorRepeat) with Graphics::set_texture_wrap; by default it clamps to the edge texels.

pub fn with_region( self, min: [f32; 2], size: [f32; 2], tex_size: [u32; 2], ) -> SpriteInstance

Sample the size pixel rectangle at min (top-left, in pixels) of a texture that is tex_size pixels large, e.g. one sprite of an atlas. Get tex_size from Graphics::texture_size / Painter::texture_size, which never reports a zero side; a zero tex_size side would produce non-finite UVs and is a debug-build panic.

pub fn with_pixel_region(self, min: [f32; 2], size: [f32; 2]) -> SpriteInstance

Sample the size pixel rectangle at min (top-left, in pixels) of whatever texture this is drawn with, like with_region but without passing the texture size: crate::Painter::sprite_ex looks it up when the sprite is drawn, and draws nothing for an unknown texture. Combine freely with flip_x / flip_y, and draw the instance only through sprite_ex.

pub fn flip_x(self) -> SpriteInstance

Mirror horizontally by swapping the u bounds. Works with any UV range or region; apply it after with_uv / with_region.

pub fn flip_y(self) -> SpriteInstance

Mirror vertically by swapping the v bounds. Works with any UV range or region; apply it after with_uv / with_region.

Trait Implementations

impl Clone for SpriteInstance

fn clone(&self) -> SpriteInstance

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for SpriteInstance

impl Debug for SpriteInstance

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

Formats the value using the given formatter.

impl Pod for SpriteInstance

impl Zeroable for SpriteInstance

fn zeroed() -> Self

Calls zeroed.