Struct three_d::core::texture::ColorTargetTexture2DArray

pub struct ColorTargetTexture2DArray<T: TextureDataType> { /* fields omitted */ }

A array of 2D color textures that can be rendered into.

Note: DepthTest is disabled if not also writing to a depth texture array. Use a RenderTargetArray to write to both color and depth.

Implementations

impl<T: TextureDataType> ColorTargetTexture2DArray<T>

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

Creates a new array of color target textures.

pub fn write<F: FnOnce() -> ThreeDResult<()>>(
    &self,
    color_layers: &[u32],
    clear_state: ClearState,
    render: F
) -> ThreeDResult<()>

Renders whatever rendered in the render closure into the textures defined by the input parameters color_layers. Output at location i defined in the fragment shader is written to the color texture layer at the ith index in color_layers. Before writing, the textures are cleared based on the given clear state.

Note: DepthTest is disabled if not also writing to a depth texture array. Use a RenderTargetArray to write to both color and depth.

pub fn copy_to(
    &self,
    color_layer: u32,
    destination: CopyDestination<'_, '_, '_, '_, T>,
    viewport: Viewport,
    write_mask: WriteMask
) -> ThreeDResult<()>

Copies the content of the color texture at the given layer to the specified destination at the given viewport. Will only copy the channels specified by the write mask.

Errors

Will return an error if the destination is a depth texture.

Trait Implementations

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

fn drop(&mut self)

Executes the destructor for this type.

impl<T: TextureDataType> TextureArray for ColorTargetTexture2DArray<T>

fn bind(&self, location: u32)

Binds this texture array to the current shader program.

fn width(&self) -> u32

The width of this texture.

fn height(&self) -> u32

The height of this texture.

fn depth(&self) -> u32

The depth of this texture, ie. the number of layers.

fn format(&self) -> Format

The format of this texture.