Struct TextureFile 

pub struct TextureFile {
    pub bytes: Vec<u8>,
    pub size: Size2D,
    pub fmt: ImgFormat,
    pub filter: ImgFilter,
    pub wrap: ImgWrap,
}

A texture loaded from disk (or cache) with metadata.

Loading

use optic_render::asset::TextureFile;

let tex = TextureFile::from_disk("textures/wood.png")?;
let gpu_tex = tex.ship(); // uploads to GPU

Caching

In debug builds, from_disk loads the source image and writes a binary cache (.otxtr). In release builds, it reads the cache directly for faster startup.

Fields

bytes: Vec<u8>

size: Size2D

fmt: ImgFormat

filter: ImgFilter

wrap: ImgWrap

Implementations

impl TextureFile

pub fn pixel_count(&self) -> usize

Returns the total pixel count (width × height).

pub fn set_wrap(&mut self, wrap: ImgWrap)

Overrides the wrap mode (used before ship).

pub fn set_filter(&mut self, filter: ImgFilter)

Overrides the filter mode (used before ship).

pub fn ship(&self) -> Texture2D

Uploads this texture to the GPU and returns a Texture2D handle.

pub fn fallback() -> OpticResult<Self>

Loads the fallback texture from optic/assets/txtr/fallback.png.

impl TextureFile

pub fn from_disk(path: &str) -> OpticResult<Self>

Loads a texture from disk, caching it for release builds.

impl TextureFile

pub fn save_cached(&self, path: &str) -> OpticResult<()>

Saves this texture to a binary cache file.