Struct three_d::core::texture::Texture2DArray

pub struct Texture2DArray { /* private fields */ }

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

Note: DepthTest is disabled if not also writing to a DepthTarget. Use a RenderTarget to write to both color and depth.

Implementations

impl Texture2DArray

pub fn new_empty<T: TextureDataType>(
    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
) -> ThreeDResult<Self>

Creates a new array of 2D textures.

pub fn as_color_target<'a>(
    &'a mut self,
    layers: &'a [u32],
    mip_level: Option<u32>
) -> ColorTarget<'a>

Returns a ColorTarget which can be used to clear, write to and read from the given layers and mip level of this texture. Combine this together with a DepthTarget with RenderTarget::new to be able to write to both a depth and color target at the same time. If None is specified as the mip level, the 0 level mip level is used and mip maps are generated after a write operation if a mip map filter is specified. Otherwise, the given mip level is used and no mip maps are generated.

Note: DepthTest is disabled if not also writing to a depth texture.

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

👎 Deprecated:

use as_color_target followed by clear and write

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

Note: DepthTest is disabled if not also writing to a DepthTarget. Use a RenderTarget to write to both color and depth.

pub fn width(&self) -> u32

The width of this texture.

pub fn height(&self) -> u32

The height of this texture.

pub fn depth(&self) -> u32

The number of layers.

Trait Implementations

impl Drop for Texture2DArray

fn drop(&mut self)

Executes the destructor for this type.