Struct three_d::core::texture::Texture2DArray
source · pub struct Texture2DArray { /* private fields */ }
Expand description
A array of 2D color textures that can be rendered into.
Note: DepthTest is disabled if not also writing to a DepthTarget. Use a RenderTarget to write to both color and depth.
Implementations§
source§impl Texture2DArray
impl Texture2DArray
sourcepub fn new(context: &Context, cpu_textures: &[&CpuTexture]) -> Self
pub fn new(context: &Context, cpu_textures: &[&CpuTexture]) -> Self
Creates a new texture array from the given CpuTextures. All of the cpu textures must contain data with the same TextureDataType and the same width and height.
Note: Mip maps will not be generated for RGB16F and RGB32F format, even if mip_map_filter
is specified.
sourcepub fn new_empty<T: TextureDataType>(
context: &Context,
width: u32,
height: u32,
depth: u32,
min_filter: Interpolation,
mag_filter: Interpolation,
mip_map_filter: Option<Interpolation>,
wrap_s: Wrapping,
wrap_t: Wrapping
) -> Self
pub fn new_empty<T: TextureDataType>( context: &Context, width: u32, height: u32, depth: u32, min_filter: Interpolation, mag_filter: Interpolation, mip_map_filter: Option<Interpolation>, wrap_s: Wrapping, wrap_t: Wrapping ) -> Self
Creates a new array of 2D textures.
Note: Mip maps will not be generated for RGB16F and RGB32F format, even if mip_map_filter
is specified.
sourcepub fn fill<T: TextureDataType>(&mut self, data: &[&[T]])
pub fn fill<T: TextureDataType>(&mut self, data: &[&[T]])
Fills the texture array with the given pixel data.
§Panic
Will panic if the data does not correspond to the width, height, depth and format specified at construction. It is therefore necessary to create a new texture if the texture size or format has changed.
sourcepub fn fill_layer<T: TextureDataType>(&mut self, layer: u32, data: &[T])
pub fn fill_layer<T: TextureDataType>(&mut self, layer: u32, data: &[T])
Fills the given layer in the texture array with the given pixel data.
§Panic
Will panic if the layer number is bigger than the number of layers or if the data does not correspond to the width, height and format specified at construction. It is therefore necessary to create a new texture if the texture size or format has changed.
sourcepub fn as_color_target<'a>(
&'a mut self,
layers: &'a [u32],
mip_level: Option<u32>
) -> ColorTarget<'a>
pub fn as_color_target<'a>( &'a mut self, layers: &'a [u32], mip_level: Option<u32> ) -> ColorTarget<'a>
Returns a ColorTarget which can be used to clear, write to and read from the given layers and mip level of this texture.
Combine this together with a DepthTarget with RenderTarget::new to be able to write to both a depth and color target at the same time.
If None
is specified as the mip level, the 0 level mip level is used and mip maps are generated after a write operation if a mip map filter is specified.
Otherwise, the given mip level is used and no mip maps are generated.
Note: DepthTest is disabled if not also writing to a depth texture.