Struct TextureAsset 

pub struct TextureAsset {
    pub data: Vec<u8>,
    pub width: u32,
    pub height: u32,
    pub format: TextureFormat,
}

A loaded texture asset containing image data.

TextureAsset stores decoded image data in memory. It does not contain GPU resources - those should be created separately from this data.

Fields

• data: Raw pixel data in RGBA8 format (4 bytes per pixel)
• width: Image width in pixels
• height: Image height in pixels
• format: The original image format (PNG, JPG, etc.)

Example

use goud_engine::assets::{Asset, loaders::TextureAsset};

let texture = TextureAsset {
    data: vec![255; 64 * 64 * 4], // 64x64 white texture
    width: 64,
    height: 64,
    format: goud_engine::assets::loaders::TextureFormat::Png,
};

assert_eq!(texture.pixel_count(), 64 * 64);
assert_eq!(texture.bytes_per_pixel(), 4);

Fields

data: Vec<u8>

Raw pixel data in RGBA8 format (4 bytes per pixel).

width: u32

Width of the texture in pixels.

height: u32

Height of the texture in pixels.

format: TextureFormat

The original image format this texture was loaded from.

Implementations

impl TextureAsset

pub fn new( data: Vec<u8>, width: u32, height: u32, format: TextureFormat, ) -> Self

Creates a new texture asset from raw RGBA8 data.

Arguments

• data: Raw pixel data in RGBA8 format (must be width × height × 4 bytes)
• width: Image width in pixels
• height: Image height in pixels
• format: The image format this data represents

Panics

Panics if data length doesn’t match width × height × 4.

Example

use goud_engine::assets::loaders::{TextureAsset, TextureFormat};

let data = vec![255; 4 * 4 * 4]; // 4x4 white texture
let texture = TextureAsset::new(data, 4, 4, TextureFormat::Png);
assert_eq!(texture.pixel_count(), 16);

pub fn pixel_count(&self) -> u32

Returns the total number of pixels in the texture.

pub const fn bytes_per_pixel(&self) -> u32

Returns the number of bytes per pixel (always 4 for RGBA8).

pub fn size_bytes(&self) -> usize

Returns the total size of the texture data in bytes.

pub fn aspect_ratio(&self) -> f32

Returns the aspect ratio (width / height) of the texture.

pub fn is_power_of_two(&self) -> bool

Returns true if the texture dimensions are powers of two.

Power-of-two textures are required by some older GPUs and can be more efficient for certain operations.

pub fn get_pixel(&self, x: u32, y: u32) -> Option<&[u8]>

Returns a slice of the pixel data for a specific pixel.

Returns None if the coordinates are out of bounds.

Example

use goud_engine::assets::loaders::{TextureAsset, TextureFormat};

let data = vec![255, 0, 0, 255, 0, 255, 0, 255]; // 2 pixels: red, green
let texture = TextureAsset::new(data, 2, 1, TextureFormat::Png);

let pixel = texture.get_pixel(0, 0).unwrap();
assert_eq!(pixel, &[255, 0, 0, 255]); // Red

let pixel = texture.get_pixel(1, 0).unwrap();
assert_eq!(pixel, &[0, 255, 0, 255]); // Green

Trait Implementations

impl Asset for TextureAsset

fn asset_type_name() -> &'static str

Returns the human-readable name of this asset type.

fn asset_type() -> AssetType

Returns the category of this asset type.

fn extensions() -> &'static [&'static str]

Returns the file extensions typically associated with this asset type.

impl Clone for TextureAsset

fn clone(&self) -> TextureAsset

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TextureAsset

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

Formats the value using the given formatter.