Struct GPUCubemap 

pub struct GPUCubemap { /* private fields */ }

A cubemap uploaded to the GPU, ready to bind (e.g. via BindingInstanceEntry::Cubemap). Opaque — bind it via BindGroupBuilder::texture_cubemap.

empty’s documented use case — rendering into per-face views for environment capture (a skybox capture, an irradiance/specular IBL prefilter pass, a reflection probe, …) — is face_attachment.

Implementations

impl GPUCubemap

pub fn write_face(&self, face: u32, pixels: &[u8])

Overwrites one face’s level-0 pixel data (+X, -X, +Y, -Y, +Z, -Z is face 0..=5, matching CubemapDescriptor::from_faces’s order). See GPUTexture::write for the same caveat about mip levels not being regenerated.

pub fn face_attachment(&self, face: u32, mip_level: u32) -> TextureView

A render-target view onto one face at one mip level, for rendering into directly — an environment-map capture, a specular IBL prefilter pass writing successive mip levels, a reflection probe. face is 0..=5 in the same order as CubemapDescriptor::from_faces’s array (+X, -X, +Y, -Y, +Z, -Z); mip_level is 0 unless this cubemap was built with_mips, in which case a prefilter pass typically writes one mip level per roughness step.

Only meaningful for a cubemap allocated with RENDER_ATTACHMENT usage, which CubemapDescriptor::empty sets automatically. Panics if face is out of range.

pub fn size(&self) -> u32

Edge length in pixels.

Trait Implementations

impl Asset<WGPUBackend> for GPUCubemap

type Source = CubemapDescriptor

The raw source representation stored in Assets.

type Deps<'a> = Res<'a, MipmapGenerator>

Resources (beyond B itself) required to perform the conversion. Use () when there are no extra dependencies.

fn upload<'a>( source: &CubemapDescriptor, backend: &WGPUBackend, mipmap_generator: &Res<'a, MipmapGenerator>, ) -> Option<Self>

Convert source into a processed asset using backend and deps.