Struct three_d::core::texture::TextureCubeMap

pub struct TextureCubeMap<T: TextureDataType> { /* private fields */ }

A texture that covers all 6 sides of a cube.

Implementations

impl<T: TextureDataType> TextureCubeMap<T>

pub fn new(
    context: &Context,
    cpu_texture: &CPUTextureCube<T>
) -> ThreeDResult<TextureCubeMap<T>>

Creates a new texture cube map from the given cpu texture. The cpu texture must contain 6 images all with the width and height specified in the cpu texture. The images are used in the following order; right, left, top, bottom, front, back.

pub fn new_empty(
    context: &Context,
    width: u32,
    height: u32,
    min_filter: Interpolation,
    mag_filter: Interpolation,
    mip_map_filter: Option<Interpolation>,
    wrap_s: Wrapping,
    wrap_t: Wrapping,
    wrap_r: Wrapping,
    format: Format
) -> ThreeDResult<Self>

Creates a new texture cube map.

pub fn fill(
    &mut self,
    right_data: &[T],
    left_data: &[T],
    top_data: &[T],
    bottom_data: &[T],
    front_data: &[T],
    back_data: &[T]
) -> ThreeDResult<()>

Fills the cube map texture with the given pixel data for the 6 images.

Errors

Returns an error if the length of the data for all 6 images does not correspond to the width, height and format specified at construction.

pub fn new_from_equirectangular<U: TextureDataType>(
    context: &Context,
    cpu_texture: &CPUTexture<U>
) -> ThreeDResult<Self>

Creates a new cube texture generated from the equirectangular texture given as input.

pub fn write(
    &mut self,
    side: CubeMapSide,
    clear_state: ClearState,
    render: impl FnOnce() -> ThreeDResult<()>
) -> ThreeDResult<()>

Writes whatever rendered in the render closure into the color texture at the cube map side given by the input parameter side. Before writing, the texture side is cleared based on the given clear state.

pub fn write_to_mip_level(
    &mut self,
    side: CubeMapSide,
    mip_level: u32,
    clear_state: ClearState,
    render: impl FnOnce() -> ThreeDResult<()>
) -> ThreeDResult<()>

Writes whatever rendered in the render closure into the given mip level of the color texture at the cube map side given by the input parameter side. Before writing, the texture side is cleared based on the given clear state.

Trait Implementations

impl<T: TextureDataType> Drop for TextureCubeMap<T>

fn drop(&mut self)

Executes the destructor for this type.

impl<T: TextureDataType> TextureCube for TextureCubeMap<T>

fn bind(&self, location: u32)

Binds this texture cube to the current shader program.

fn width(&self) -> u32

The width of one of the sides of this texture.

fn height(&self) -> u32

The height of one of the sides of this texture.

fn format(&self) -> Format

The format of this texture.

fn is_hdr(&self) -> bool

Whether or not this texture contain hdr information.