Struct RenderTexture 

pub struct RenderTexture {
    inner: Arc<RenderTextureInner>,
}

GPU texture configured for rendering into and reading back.

Usage flags: RENDER_ATTACHMENT | COPY_SRC | TEXTURE_BINDING.

Fields

inner: Arc<RenderTextureInner>

Implementations

impl RenderTexture

pub fn new(app: &Application, width: u32, height: u32) -> Self

Allocate a new RenderTexture of the given dimensions in Rgba8UnormSrgb.

Use RenderTexture::with_format for other formats.

pub fn with_format( app: &Application, width: u32, height: u32, format: TextureFormat, ) -> Self

Allocate with an explicit color format.

pub fn view(&self) -> &TextureView

wgpu::TextureView suitable for use as a render-pass color attachment.

pub fn sampler(&self) -> &Sampler

Sampler for downstream passes that read from this render target.

pub fn format(&self) -> TextureFormat

Color format.

pub fn width(&self) -> u32

Width in pixels.

pub fn height(&self) -> u32

Height in pixels.

pub fn as_texture(&self) -> Texture

Wrap this render target as a sampled Texture for use in the sprite pipeline.

Shares the underlying wgpu resources — no GPU copy. The render texture’s TEXTURE_BINDING usage flag is already set, so sampling is well-defined.

Useful for compositing text/mask/filter outputs into a scene: render into a RenderTexture, then as_texture() + attach to a crate::scene::Sprite.

pub fn read_pixels(&self, app: &Application) -> Vec<u8>

Read back the rendered pixels as a tightly-packed RGBA8 buffer.

For Rgba8UnormSrgb / Bgra8UnormSrgb formats the returned buffer is width * height * 4 bytes; row-padding from COPY_BYTES_PER_ROW_ALIGNMENT is stripped before return.

Blocks the current thread on device.poll(Maintain::Wait).

Trait Implementations

impl Clone for RenderTexture

fn clone(&self) -> RenderTexture

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RenderTexture

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.