Struct re_renderer::resource_managers::image_data_to_texture::ImageDataDesc

pub struct ImageDataDesc<'a> {
    pub label: DebugLabel,
    pub data: Cow<'a, [u8]>,
    pub format: SourceImageDataFormat,
    pub width_height: [u32; 2],
}

Describes image data for the purpose of creating a 2D texture.

Arbitrary (potentially gpu based) conversions may be performed to upload the data to the GPU.

Fields

label: DebugLabel

If this desc is not used for a texture update, this label is used for the target texture. Otherwise, it may still used for any intermediate resources that may be required during the conversion process.

data: Cow<'a, [u8]>

Data for the highest mipmap level.

Data is expected to be tightly packed. I.e. it is not padded according to wgpu buffer->texture transfer rules, padding will happen on the fly if necessary. TODO(andreas): This should be a kind of factory function/builder instead which gets target memory passed in.

format: SourceImageDataFormat

width_height: [u32; 2]

The size of the resulting output texture / the semantic size of the image data.

The distinction is in particular important for planar formats. Which may be represented as a larger texture than the image they represent. With the output always being a (“mainstream” gpu readable) texture format, the output texture’s width/height is the semantic width/height of the image data!

Implementations

impl<'a> ImageDataDesc<'a>

fn validate( &self, limits: &Limits, target_texture_desc: &TextureDesc ) -> Result<(), ImageDataToTextureError>

pub fn target_texture_usage_requirements(&self) -> TextureUsages

The texture usages required in order to store this image data.

pub fn target_texture_format(&self) -> TextureFormat

The texture format required in order to store this image data.

pub fn create_target_texture( &self, ctx: &RenderContext, texture_usages: TextureUsages ) -> Arc<DynamicResource<GpuTextureHandle, TextureDesc, GpuTextureInternal>>

Creates a texture that can hold the image data.