Struct three_d::core::ColorTargetTexture2D

pub struct ColorTargetTexture2D<T: TextureValueType> { /* fields omitted */ }

A 2D color texture that can be rendered into and read from.

Note: Depth test is disabled if not also writing to a depth texture. Use a RenderTarget to write to both color and depth.

Implementations

impl<T: TextureValueType> ColorTargetTexture2D<T>

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

Constructs a new 2D color target texture.

pub fn write<F: FnOnce() -> Result<(), Error>>(
    &self,
    clear_state: ClearState,
    render: F
) -> Result<(), Error>

Renders whatever rendered in the render closure into the texture. Before writing, the texture is cleared based on the given clear state.

Note: Depth test is disabled if not also writing to a depth texture. Use a RenderTarget to write to both color and depth.

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

Copies the content of the color texture 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.

pub fn read(&self, viewport: Viewport) -> Result<Vec<T>, Error>

Returns the color values of the pixels in this color texture inside the given viewport.

Note: Only works for the RGBA format.

Errors

Will return an error if the color texture is not RGBA format.

Trait Implementations

impl<T: TextureValueType> Drop for ColorTargetTexture2D<T>

fn drop(&mut self)

Executes the destructor for this type.

impl<T: TextureValueType> Texture for ColorTargetTexture2D<T>

fn bind(&self, location: u32)

Binds this texture to the current shader program.

fn width(&self) -> usize

The width of this texture.

fn height(&self) -> usize

The height of this texture.