Struct re_renderer::resource_managers::TextureManager2D

pub struct TextureManager2D {
    white_texture_unorm: GpuTexture2D,
    zeroed_texture_float: GpuTexture2D,
    zeroed_texture_sint: GpuTexture2D,
    zeroed_texture_uint: GpuTexture2D,
    inner: Mutex<Inner>,
}

Texture manager for 2D textures.

The scope is intentionally limited to particular kinds of textures that currently require this kind of handle abstraction/management. More complex textures types are typically handled within renderer which utilize the texture pool directly. This manager in contrast, deals with user provided texture data! We might revisit this later and make this texture manager more general purpose.

Has intertior mutability.

Fields

white_texture_unorm: GpuTexture2D

zeroed_texture_float: GpuTexture2D

zeroed_texture_sint: GpuTexture2D

zeroed_texture_uint: GpuTexture2D

inner: Mutex<Inner>

The mutable part of the manager.

Implementations

impl TextureManager2D

pub(crate) fn new( device: &Device, queue: &Queue, texture_pool: &GpuTexturePool ) -> Self

pub fn create( &self, render_ctx: &RenderContext, creation_desc: ImageDataDesc<'_> ) -> Result<GpuTexture2D, ImageDataToTextureError>

Creates a new 2D texture resource and schedules data upload to the GPU. TODO(jleibs): All usages of this should be replaced with get_or_create, which is strictly preferable

pub fn get_or_create( &self, key: u64, render_ctx: &RenderContext, texture_desc: ImageDataDesc<'_> ) -> Result<GpuTexture2D, ImageDataToTextureError>

Creates a new 2D texture resource and schedules data upload to the GPU if a texture wasn’t already created using the same key.

pub fn get_or_create_with<'a>( &self, key: u64, render_ctx: &RenderContext, create_texture_desc: impl FnOnce() -> ImageDataDesc<'a> ) -> Result<GpuTexture2D, ImageDataToTextureError>

Creates a new 2D texture resource and schedules data upload to the GPU if a texture wasn’t already created using the same key.

pub fn get_or_try_create_with<'a, Err: Display>( &self, key: u64, render_ctx: &RenderContext, try_create_texture_desc: impl FnOnce() -> Result<ImageDataDesc<'a>, Err> ) -> Result<GpuTexture2D, TextureManager2DError<Err>>

Creates a new 2D texture resource and schedules data upload to the GPU if a texture wasn’t already created using the same key.

pub fn white_texture_unorm_handle(&self) -> &GpuTexture2D

Returns a single pixel white pixel with an rgba8unorm format.

pub fn white_texture_unorm( &self ) -> &Arc<DynamicResource<GpuTextureHandle, TextureDesc, GpuTextureInternal>>

Returns a single pixel white pixel with an rgba8unorm format.

pub fn zeroed_texture_float( &self ) -> &Arc<DynamicResource<GpuTextureHandle, TextureDesc, GpuTextureInternal>>

Returns a single zero pixel with format [wgpu::TextureFormat::Rgba8Unorm].

pub fn zeroed_texture_sint( &self ) -> &Arc<DynamicResource<GpuTextureHandle, TextureDesc, GpuTextureInternal>>

Returns a single zero pixel with format [wgpu::TextureFormat::Rgba8Sint].

pub fn zeroed_texture_uint( &self ) -> &Arc<DynamicResource<GpuTextureHandle, TextureDesc, GpuTextureInternal>>

Returns a single zero pixel with format [wgpu::TextureFormat::Rgba8Uint].

pub(crate) fn begin_frame(&self, _frame_index: u64)