Struct three_d::core::render_target::RenderTarget

pub struct RenderTarget<'a, 'b, T: TextureDataType> { /* fields omitted */ }

Adds additional functionality to write to and copy from both a ColorTargetTexture2D and a DepthTargetTexture2D at the same time. It purely adds functionality, so it can be created each time it is needed, the data is saved in the textures.

Implementations

impl<'a, 'b> RenderTarget<'a, 'b, u8>

pub fn new_depth(
    context: &Context,
    depth_texture: &'b mut DepthTargetTexture2D
) -> ThreeDResult<Self>

Constructs a new render target that enables rendering into the given DepthTargetTexture2D.

impl<'a, 'b, T: TextureDataType> RenderTarget<'a, 'b, T>

pub fn new(
    context: &Context,
    color_texture: &'a mut Texture2D<T>,
    depth_texture: &'b mut DepthTargetTexture2D
) -> ThreeDResult<Self>

Constructs a new render target that enables rendering into the given ColorTargetTexture2D and DepthTargetTexture2D textures.

pub fn new_color(
    context: &Context,
    color_texture: &'a mut Texture2D<T>
) -> ThreeDResult<Self>

Constructs a new render target that enables rendering into the given ColorTargetTexture2D.

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

Renders whatever rendered in the render closure into the textures defined at construction. Before writing, the textures are cleared based on the given clear state.

pub fn copy_from<U: TextureDataType>(
    &self,
    color_texture: Option<&Texture2D<U>>,
    depth_texture: Option<&DepthTargetTexture2D>,
    viewport: Viewport,
    write_mask: WriteMask
) -> ThreeDResult<()>

Copies the content of the color and depth texture to the specified viewport of this render target. Only copies the channels given by the write mask.

pub fn copy_from_array<U: TextureDataType>(
    &self,
    color_texture: Option<(&Texture2DArray<U>, u32)>,
    depth_texture: Option<(&DepthTargetTexture2DArray, u32)>,
    viewport: Viewport,
    write_mask: WriteMask
) -> ThreeDResult<()>

Copies the content of the given layers of the color and depth array textures to the specified viewport of this render target. Only copies the channels given by the write mask.

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

👎 Deprecated:

Use RenderTarget::copy_from or Screen::copy_from instead

Copies the content of the color and depth textures in this render target to the specified viewport of the specified destination. Only copies the channels given by the write mask.

Trait Implementations

impl<T: TextureDataType> Drop for RenderTarget<'_, '_, T>

fn drop(&mut self)

Executes the destructor for this type.