Files
Pac-Man/src/texture/sprite.rs

370 lines
10 KiB
Rust

use anyhow::Result;
use glam::U16Vec2;
use sdl2::pixels::Color;
use sdl2::rect::Rect;
use sdl2::render::{Canvas, RenderTarget, Texture};
use serde::Deserialize;
use std::collections::HashMap;
#[derive(Clone, Debug, Deserialize)]
pub struct AtlasMapper {
pub frames: HashMap<String, MapperFrame>,
}
#[derive(Copy, Clone, Debug, Deserialize)]
pub struct MapperFrame {
pub x: u16,
pub y: u16,
pub width: u16,
pub height: u16,
}
#[derive(Copy, Clone, Debug)]
pub struct AtlasTile {
pub pos: U16Vec2,
pub size: U16Vec2,
pub color: Option<Color>,
}
impl AtlasTile {
pub fn render<C: RenderTarget>(&mut self, canvas: &mut Canvas<C>, atlas: &mut SpriteAtlas, dest: Rect) -> Result<()> {
let color = self.color.unwrap_or(atlas.default_color.unwrap_or(Color::WHITE));
self.render_with_color(canvas, atlas, dest, color)
}
pub fn render_with_color<C: RenderTarget>(
&mut self,
canvas: &mut Canvas<C>,
atlas: &mut SpriteAtlas,
dest: Rect,
color: Color,
) -> Result<()> {
let src = Rect::new(self.pos.x as i32, self.pos.y as i32, self.size.x as u32, self.size.y as u32);
if atlas.last_modulation != Some(color) {
atlas.texture.set_color_mod(color.r, color.g, color.b);
atlas.last_modulation = Some(color);
}
canvas.copy(&atlas.texture, src, dest).map_err(anyhow::Error::msg)?;
Ok(())
}
/// Creates a new atlas tile.
#[allow(dead_code)]
pub fn new(pos: U16Vec2, size: U16Vec2, color: Option<Color>) -> Self {
Self { pos, size, color }
}
/// Sets the color of the tile.
#[allow(dead_code)]
pub fn with_color(mut self, color: Color) -> Self {
self.color = Some(color);
self
}
}
pub struct SpriteAtlas {
texture: Texture<'static>,
tiles: HashMap<String, MapperFrame>,
default_color: Option<Color>,
last_modulation: Option<Color>,
}
impl SpriteAtlas {
pub fn new(texture: Texture<'static>, mapper: AtlasMapper) -> Self {
Self {
texture,
tiles: mapper.frames,
default_color: None,
last_modulation: None,
}
}
pub fn get_tile(&self, name: &str) -> Option<AtlasTile> {
self.tiles.get(name).map(|frame| AtlasTile {
pos: U16Vec2::new(frame.x, frame.y),
size: U16Vec2::new(frame.width, frame.height),
color: None,
})
}
#[allow(dead_code)]
pub fn set_color(&mut self, color: Color) {
self.default_color = Some(color);
}
#[allow(dead_code)]
pub fn texture(&self) -> &Texture<'static> {
&self.texture
}
/// Returns the number of tiles in the atlas.
#[allow(dead_code)]
pub fn tiles_count(&self) -> usize {
self.tiles.len()
}
/// Returns true if the atlas has a tile with the given name.
#[allow(dead_code)]
pub fn has_tile(&self, name: &str) -> bool {
self.tiles.contains_key(name)
}
/// Returns the default color of the atlas.
#[allow(dead_code)]
pub fn default_color(&self) -> Option<Color> {
self.default_color
}
}
/// Converts a `Texture` to a `Texture<'static>` using transmute.
///
/// # Safety
///
/// This function is unsafe because it uses `std::mem::transmute` to change the lifetime
/// of the texture from the original lifetime to `'static`. The caller must ensure that:
///
/// - The original `Texture` will live for the entire duration of the program
/// - No references to the original texture exist that could become invalid
/// - The texture is not dropped while still being used as a `'static` reference
///
/// This is typically used when you have a texture that you know will live for the entire
/// program duration and need to store it in a structure that requires a `'static` lifetime.
pub unsafe fn texture_to_static(texture: Texture) -> Texture<'static> {
std::mem::transmute(texture)
}
#[cfg(test)]
mod tests {
use super::*;
use sdl2::pixels::Color;
// Mock texture for testing - we'll use a dummy approach since we can't create real SDL2 textures
fn mock_texture() -> Texture<'static> {
// This is unsafe and only for testing - in real usage this would be a proper texture
unsafe { std::mem::transmute(0usize) }
}
#[test]
fn test_atlas_tile_new() {
let pos = U16Vec2::new(10, 20);
let size = U16Vec2::new(32, 32);
let tile = AtlasTile::new(pos, size, None);
assert_eq!(tile.pos, pos);
assert_eq!(tile.size, size);
assert_eq!(tile.color, None);
}
#[test]
fn test_atlas_tile_with_color() {
let pos = U16Vec2::new(10, 20);
let size = U16Vec2::new(32, 32);
let color = Color::RGB(255, 0, 0);
let tile = AtlasTile::new(pos, size, None).with_color(color);
assert_eq!(tile.pos, pos);
assert_eq!(tile.size, size);
assert_eq!(tile.color, Some(color));
}
#[test]
fn test_mapper_frame() {
let frame = MapperFrame {
x: 10,
y: 20,
width: 32,
height: 32,
};
assert_eq!(frame.x, 10);
assert_eq!(frame.y, 20);
assert_eq!(frame.width, 32);
assert_eq!(frame.height, 32);
}
#[test]
fn test_atlas_mapper_new() {
let mut frames = HashMap::new();
frames.insert(
"test".to_string(),
MapperFrame {
x: 0,
y: 0,
width: 32,
height: 32,
},
);
let mapper = AtlasMapper { frames };
assert_eq!(mapper.frames.len(), 1);
assert!(mapper.frames.contains_key("test"));
}
#[test]
fn test_sprite_atlas_new() {
let mut frames = HashMap::new();
frames.insert(
"test".to_string(),
MapperFrame {
x: 0,
y: 0,
width: 32,
height: 32,
},
);
let mapper = AtlasMapper { frames };
let texture = mock_texture();
let atlas = SpriteAtlas::new(texture, mapper);
assert_eq!(atlas.tiles_count(), 1);
assert!(atlas.has_tile("test"));
assert_eq!(atlas.default_color(), None);
}
#[test]
fn test_sprite_atlas_get_tile() {
let mut frames = HashMap::new();
frames.insert(
"test".to_string(),
MapperFrame {
x: 10,
y: 20,
width: 32,
height: 64,
},
);
let mapper = AtlasMapper { frames };
let texture = mock_texture();
let atlas = SpriteAtlas::new(texture, mapper);
let tile = atlas.get_tile("test");
assert!(tile.is_some());
let tile = tile.unwrap();
assert_eq!(tile.pos, U16Vec2::new(10, 20));
assert_eq!(tile.size, U16Vec2::new(32, 64));
assert_eq!(tile.color, None);
}
#[test]
fn test_sprite_atlas_get_tile_nonexistent() {
let mapper = AtlasMapper { frames: HashMap::new() };
let texture = mock_texture();
let atlas = SpriteAtlas::new(texture, mapper);
let tile = atlas.get_tile("nonexistent");
assert!(tile.is_none());
}
#[test]
fn test_sprite_atlas_set_color() {
let mapper = AtlasMapper { frames: HashMap::new() };
let texture = mock_texture();
let mut atlas = SpriteAtlas::new(texture, mapper);
assert_eq!(atlas.default_color(), None);
let color = Color::RGB(255, 0, 0);
atlas.set_color(color);
assert_eq!(atlas.default_color(), Some(color));
}
#[test]
fn test_sprite_atlas_empty() {
let mapper = AtlasMapper { frames: HashMap::new() };
let texture = mock_texture();
let atlas = SpriteAtlas::new(texture, mapper);
assert_eq!(atlas.tiles_count(), 0);
assert!(!atlas.has_tile("any"));
}
#[test]
fn test_sprite_atlas_multiple_tiles() {
let mut frames = HashMap::new();
frames.insert(
"tile1".to_string(),
MapperFrame {
x: 0,
y: 0,
width: 32,
height: 32,
},
);
frames.insert(
"tile2".to_string(),
MapperFrame {
x: 32,
y: 0,
width: 64,
height: 64,
},
);
let mapper = AtlasMapper { frames };
let texture = mock_texture();
let atlas = SpriteAtlas::new(texture, mapper);
assert_eq!(atlas.tiles_count(), 2);
assert!(atlas.has_tile("tile1"));
assert!(atlas.has_tile("tile2"));
assert!(!atlas.has_tile("tile3"));
}
#[test]
fn test_atlas_tile_clone() {
let pos = U16Vec2::new(10, 20);
let size = U16Vec2::new(32, 32);
let color = Color::RGB(255, 0, 0);
let tile = AtlasTile::new(pos, size, Some(color));
let cloned = tile;
assert_eq!(tile.pos, cloned.pos);
assert_eq!(tile.size, cloned.size);
assert_eq!(tile.color, cloned.color);
}
#[test]
fn test_mapper_frame_clone() {
let frame = MapperFrame {
x: 10,
y: 20,
width: 32,
height: 64,
};
let cloned = frame;
assert_eq!(frame.x, cloned.x);
assert_eq!(frame.y, cloned.y);
assert_eq!(frame.width, cloned.width);
assert_eq!(frame.height, cloned.height);
}
#[test]
fn test_atlas_mapper_clone() {
let mut frames = HashMap::new();
frames.insert(
"test".to_string(),
MapperFrame {
x: 0,
y: 0,
width: 32,
height: 32,
},
);
let mapper = AtlasMapper { frames };
let cloned = mapper.clone();
assert_eq!(mapper.frames.len(), cloned.frames.len());
assert!(mapper.frames.contains_key("test"));
assert!(cloned.frames.contains_key("test"));
}
}