translate to english!

This commit is contained in:
2026-03-24 13:40:18 +00:00
parent 4e633163ce
commit 9ba2aab1a5
49 changed files with 2488 additions and 2488 deletions
@@ -33,7 +33,7 @@ impl DirectoryCartridgeLoader {
let manifest_content = fs::read_to_string(manifest_path).map_err(|_| CartridgeError::IoError)?;
let manifest: CartridgeManifest = serde_json::from_str(&manifest_content).map_err(|_| CartridgeError::InvalidManifest)?;
// Validação adicional conforme requisitos
// Additional validation as per requirements
if manifest.magic != "PMTU" {
return Err(CartridgeError::InvalidManifest);
}
@@ -73,7 +73,6 @@ pub struct PackedCartridgeLoader;
impl PackedCartridgeLoader {
pub fn load(_path: &Path) -> Result<Cartridge, CartridgeError> {
// Stub inicialmente, como solicitado
Err(CartridgeError::InvalidFormat)
}
}
+6 -6
View File
@@ -1,10 +1,10 @@
/// Cor simples em RGB565 (0bRRRRRGGGGGGBBBBB).
/// Simple RGB565 color (0bRRRRRGGGGGGBBBBB).
/// - 5 bits Red
/// - 6 bits Green
/// - 5 bits Blue
///
/// Não há canal alpha.
/// Transparência é tratada via Color Key ou Blend Mode.
/// There is no alpha channel.
/// Transparency is handled via Color Key or Blend Mode.
#[derive(Clone, Copy, Debug, Default, PartialEq, Eq)]
pub struct Color(pub u16);
@@ -23,7 +23,7 @@ impl Color {
pub const COLOR_KEY: Self = Self::MAGENTA;
pub const TRANSPARENT: Self = Self::MAGENTA;
/// Extrai canais já na faixa nativa do RGB565:
/// Extracts channels in the native RGB565 range:
/// R: 0..31, G: 0..63, B: 0..31
#[inline(always)]
pub const fn unpack_to_native(px: u16) -> (u8, u8, u8) {
@@ -33,14 +33,14 @@ impl Color {
(r, g, b)
}
/// Incorpora canais já na faixa nativa do RGB565 em um pixel:
/// Packs channels from the native RGB565 range into a pixel:
/// R: 0..31, G: 0..63, B: 0..31
#[inline(always)]
pub const fn pack_from_native(r: u8, g: u8, b: u8) -> u16 {
((r as u16 & 0x1F) << 11) | ((g as u16 & 0x3F) << 5) | (b as u16 & 0x1F)
}
/// Cria uma cor RGB565 a partir de componentes 8-bit (0..255).
/// Creates an RGB565 color from 8-bit components (0..255).
pub const fn rgb(r: u8, g: u8, b: u8) -> Self {
let r5 = (r as u16 >> 3) & 0x1F;
let g6 = (g as u16 >> 2) & 0x3F;
+11 -12
View File
@@ -9,13 +9,12 @@ pub enum TileSize {
pub struct TileBank {
pub tile_size: TileSize,
pub width: usize, // em pixels
pub height: usize, // em pixels
// pub pixels: Vec<Color>,
pub width: usize, // in pixels
pub height: usize, // in pixels
/// Agora guardamos índices de 0 a 15 (4 bits por pixel simulados em 8 bits)
/// Now we store indices from 0 to 15 (4 bits per pixel simulated in 8 bits)
pub pixel_indices: Vec<u8>,
/// 256 paletas, cada uma com 16 cores (RGB565 como u16)
/// 256 palettes, each with 16 colors (RGB565 as u16)
pub palettes: [[Color; 16]; 256],
}
@@ -25,14 +24,14 @@ impl TileBank {
tile_size,
width,
height,
pixel_indices: vec![0; width * height], // Índice 0 = Transparente
pixel_indices: vec![0; width * height], // Index 0 = Transparent
palettes: [[Color::BLACK; 16]; 256],
}
}
/// Retorna a cor de um pixel específico dentro de um tile.
/// tile_id: o índice do tile no banco
/// local_x, local_y: a posição do pixel dentro do tile (0 até tile_size-1)
/// Returns the color of a specific pixel inside a tile.
/// tile_id: the tile index in the bank
/// local_x, local_y: the pixel position inside the tile (0 to tile_size-1)
pub fn get_pixel_index(&self, tile_id: u16, local_x: usize, local_y: usize) -> u8 {
let size = self.tile_size as usize;
let tiles_per_row = self.width / size;
@@ -45,13 +44,13 @@ impl TileBank {
if pixel_x < self.width && pixel_y < self.height {
self.pixel_indices[pixel_y * self.width + pixel_x]
} else {
0 // Fora do banco = Transparente
0 // Outside the bank = Transparent
}
}
/// Resolve um índice de pixel para uma Color real usando uma paleta.
/// Resolves a pixel index to a real Color using a palette.
pub fn resolve_color(&self, palette_id: u8, pixel_index: u8) -> Color {
// Regra: Índice 0 é sempre transparente (usamos MAGENTA/COLOR_KEY como vácuo)
// Rule: Index 0 is always transparent (we use MAGENTA/COLOR_KEY as vacuum)
if pixel_index == 0 {
return Color::COLOR_KEY;
}