Enum TextureFormat 

pub enum TextureFormat {
    R8Unorm,
    R8Srgb,
    Rg8Unorm,
    Rgba8Unorm,
    Rgba8Srgb,
    Bgra8Unorm,
    Bgra8Srgb,
    R16Unorm,
    Rg16Unorm,
    Rgba16Unorm,
    R32Float,
    Rg32Float,
    Rgba32Float,
}

Exhaustive GPU texture format descriptors for fovea pixel types.

This enum is always available (no feature flag required). It is a pure Rust data type that downstream consumers (egui, bevy, raw Vulkan, wgpu) can match on directly.

Adding a variant is semver-major.

Design decisions

• No 3-channel formats. GPU APIs generally do not support 3-channel textures (Rgb8, Bgr8, RgbF32). Users must convert to 4-channel before GPU upload. This is explicit per fovea Philosophy #4.

• R8Srgb included. Not all GPU APIs support R8_SRGB (WebGPU/wgpu notably do not), but the enum models the logical format. Downstream integrations that target such an API should map R8Srgb to the nearest available format (typically R8Unorm).

• Bgra8Srgb reserved. fovea has no SrgbBgra8 type today, but the format is common in GPU APIs. Included for forward-compatibility.

Examples

use fovea_display::TextureFormat;

let fmt = TextureFormat::Rgba8Srgb;
assert_eq!(fmt.bytes_per_pixel(), 4);
assert_eq!(fmt.channel_count(), 4);

Variants

R8Unorm

Single-channel 8-bit unsigned normalized (linear). Maps to Mono8.

R8Srgb

Single-channel 8-bit sRGB. Maps to SrgbMono8.

Rg8Unorm

Two-channel 8-bit unsigned normalized. Maps to MonoA8.

Rgba8Unorm

Four-channel 8-bit unsigned normalized (linear). Maps to Rgba8.

Rgba8Srgb

Four-channel 8-bit sRGB with alpha. Maps to Srgba8.

Bgra8Unorm

Four-channel 8-bit BGRA unsigned normalized (linear). Maps to Bgra8.

Bgra8Srgb

Four-channel 8-bit BGRA sRGB. Reserved for future SrgbBgra8.

R16Unorm

Single-channel 16-bit unsigned normalized. Maps to Mono16.

Rg16Unorm

Two-channel 16-bit unsigned normalized. Maps to MonoA16.

Rgba16Unorm

Four-channel 16-bit unsigned normalized. Maps to Rgba16.

R32Float

Single-channel 32-bit float. Maps to MonoF32.

Rg32Float

Two-channel 32-bit float. Maps to MonoAF32.

Rgba32Float

Four-channel 32-bit float. Maps to RgbaF32.

Implementations

impl TextureFormat

pub const fn bytes_per_pixel(&self) -> usize

Returns the total number of bytes per pixel for this format.

Examples

use fovea_display::TextureFormat;

assert_eq!(TextureFormat::R8Unorm.bytes_per_pixel(), 1);
assert_eq!(TextureFormat::Rg16Unorm.bytes_per_pixel(), 4);
assert_eq!(TextureFormat::Rgba32Float.bytes_per_pixel(), 16);

pub const fn channel_count(&self) -> usize

Returns the number of channels in this format.

Examples

use fovea_display::TextureFormat;

assert_eq!(TextureFormat::R8Unorm.channel_count(), 1);
assert_eq!(TextureFormat::Rg8Unorm.channel_count(), 2);
assert_eq!(TextureFormat::Rgba8Srgb.channel_count(), 4);

Trait Implementations

impl Clone for TextureFormat

fn clone(&self) -> TextureFormat

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for TextureFormat

impl Debug for TextureFormat

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

Formats the value using the given formatter.

impl Eq for TextureFormat

impl Hash for TextureFormat

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for TextureFormat

fn eq(&self, other: &TextureFormat) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for TextureFormat