pub struct SrgbTexture2dArray(/* private fields */);
Expand description
An array of two-dimensional textures containing sRGB floating-point data.
Implementations§
Source§impl SrgbTexture2dArray
impl SrgbTexture2dArray
Sourcepub fn sampled(&self) -> Sampler<'_, SrgbTexture2dArray>
pub fn sampled(&self) -> Sampler<'_, SrgbTexture2dArray>
Builds a Sampler
marker object that allows you to indicate
how the texture should be sampled from inside a shader.
§Example
let uniforms = uniform! {
color_texture: texture.sampled().magnify_filter(glium::uniforms::MagnifySamplerFilter::Nearest)
};
Source§impl SrgbTexture2dArray
impl SrgbTexture2dArray
Sourcepub fn get_internal_format(&self) -> Result<InternalFormat, GetFormatError>
pub fn get_internal_format(&self) -> Result<InternalFormat, GetFormatError>
Determines the internal format of this texture.
The backend may not support querying the actual format, in which case an error is returned.
Sourcepub fn new<'a, F, T>(
facade: &F,
data: Vec<T>,
) -> Result<SrgbTexture2dArray, TextureCreationError>
pub fn new<'a, F, T>( facade: &F, data: Vec<T>, ) -> Result<SrgbTexture2dArray, TextureCreationError>
Builds a new texture by uploading data.
This function will automatically generate all mipmaps of the texture.
Sourcepub fn with_mipmaps<'a, F, T>(
facade: &F,
data: Vec<T>,
mipmaps: MipmapsOption,
) -> Result<SrgbTexture2dArray, TextureCreationError>
pub fn with_mipmaps<'a, F, T>( facade: &F, data: Vec<T>, mipmaps: MipmapsOption, ) -> Result<SrgbTexture2dArray, TextureCreationError>
Builds a new texture by uploading data.
Sourcepub fn with_format<'a, F, T>(
facade: &F,
data: Vec<T>,
format: SrgbFormat,
mipmaps: MipmapsOption,
) -> Result<SrgbTexture2dArray, TextureCreationError>
pub fn with_format<'a, F, T>( facade: &F, data: Vec<T>, format: SrgbFormat, mipmaps: MipmapsOption, ) -> Result<SrgbTexture2dArray, TextureCreationError>
Builds a new texture with a specific format.
Sourcepub fn empty<F>(
facade: &F,
width: u32,
height: u32,
array_size: u32,
) -> Result<SrgbTexture2dArray, TextureCreationError>
pub fn empty<F>( facade: &F, width: u32, height: u32, array_size: u32, ) -> Result<SrgbTexture2dArray, TextureCreationError>
Creates an empty texture.
No mipmap level (except for the main level) will be allocated or generated.
The texture will contain undefined data.
Sourcepub fn empty_with_format<F>(
facade: &F,
format: SrgbFormat,
mipmaps: MipmapsOption,
width: u32,
height: u32,
array_size: u32,
) -> Result<SrgbTexture2dArray, TextureCreationError>
pub fn empty_with_format<F>( facade: &F, format: SrgbFormat, mipmaps: MipmapsOption, width: u32, height: u32, array_size: u32, ) -> Result<SrgbTexture2dArray, TextureCreationError>
Creates an empty texture with a specific format.
The texture (and its mipmaps) will contain undefined data.
Sourcepub fn empty_with_mipmaps<F>(
facade: &F,
mipmaps: MipmapsOption,
width: u32,
height: u32,
array_size: u32,
) -> Result<SrgbTexture2dArray, TextureCreationError>
pub fn empty_with_mipmaps<F>( facade: &F, mipmaps: MipmapsOption, width: u32, height: u32, array_size: u32, ) -> Result<SrgbTexture2dArray, TextureCreationError>
Creates an empty texture. Specifies whether is has mipmaps.
The texture (and its mipmaps) will contain undefined data.
Sourcepub unsafe fn from_id<F>(
facade: &F,
format: SrgbFormat,
id: u32,
owned: bool,
mipmap: MipmapsOption,
ty: Dimensions,
) -> SrgbTexture2dArray
pub unsafe fn from_id<F>( facade: &F, format: SrgbFormat, id: u32, owned: bool, mipmap: MipmapsOption, ty: Dimensions, ) -> SrgbTexture2dArray
Builds a new texture reference from an existing, externally created OpenGL texture.
If owned
is true, this reference will take ownership of the texture and be responsible
for cleaning it up. Otherwise, the texture must be cleaned up externally, but only
after this reference’s lifetime has ended.
Sourcepub fn array_size(&self) -> u32
pub fn array_size(&self) -> u32
Returns the number of array layers.
Sourcepub fn dimensions(&self) -> (u32, u32)
pub fn dimensions(&self) -> (u32, u32)
Returns the width and height of that image.
Sourcepub fn get_mipmap_levels(&self) -> u32
pub fn get_mipmap_levels(&self) -> u32
Returns the number of mipmap levels of the texture.
The minimum value is 1, since there is always a main texture.
Sourcepub fn resident(
self,
) -> Result<ResidentTexture, BindlessTexturesNotSupportedError>
pub fn resident( self, ) -> Result<ResidentTexture, BindlessTexturesNotSupportedError>
Turns the texture into a ResidentTexture
.
This allows you to use the texture in a much more efficient way by storing a “reference to it” in a buffer (actually not a reference but a raw pointer).
See the documentation of ResidentTexture
for more infos.
Sourcepub fn first_layer(&self) -> SrgbTexture2dArrayLayer<'_>
pub fn first_layer(&self) -> SrgbTexture2dArrayLayer<'_>
Access the first layer of this texture.
Sourcepub fn layer(&self, layer: u32) -> Option<SrgbTexture2dArrayLayer<'_>>
pub fn layer(&self, layer: u32) -> Option<SrgbTexture2dArrayLayer<'_>>
Access a single layer of this texture.
Sourcepub fn mipmap(&self, level: u32) -> Option<SrgbTexture2dArrayMipmap<'_>>
pub fn mipmap(&self, level: u32) -> Option<SrgbTexture2dArrayMipmap<'_>>
Access a single mipmap level of this texture.
Sourcepub fn main_level(&self) -> SrgbTexture2dArrayMipmap<'_>
pub fn main_level(&self) -> SrgbTexture2dArrayMipmap<'_>
Access the main mipmap level of this texture.
Methods from Deref<Target = TextureAny>§
Sourcepub fn get_height(&self) -> Option<u32>
pub fn get_height(&self) -> Option<u32>
Returns the height of the texture.
Sourcepub fn kind(&self) -> TextureKind
pub fn kind(&self) -> TextureKind
Returns the kind of texture.
Sourcepub fn dimensions(&self) -> Dimensions
pub fn dimensions(&self) -> Dimensions
Returns the dimensions of the texture.
Sourcepub fn get_array_size(&self) -> Option<u32>
pub fn get_array_size(&self) -> Option<u32>
Returns the array size of the texture.
Sourcepub fn get_samples(&self) -> Option<u32>
pub fn get_samples(&self) -> Option<u32>
Returns the number of samples of the texture if it is a multisampling texture.
Sourcepub fn first_layer(&self) -> TextureAnyLayer<'_>
pub fn first_layer(&self) -> TextureAnyLayer<'_>
Returns a structure that represents the first layer of the texture. All textures have a first layer.
Sourcepub fn layer(&self, layer: u32) -> Option<TextureAnyLayer<'_>>
pub fn layer(&self, layer: u32) -> Option<TextureAnyLayer<'_>>
Returns a structure that represents a specific layer of the texture.
Non-array textures have only one layer. The number of layers can be queried with
get_array_size
.
Returns None
if out of range.
Sourcepub fn get_texture_type(&self) -> Dimensions
pub fn get_texture_type(&self) -> Dimensions
Returns the type of the texture (1D, 2D, 3D, etc.).
Sourcepub fn get_internal_format(&self) -> Result<InternalFormat, GetFormatError>
pub fn get_internal_format(&self) -> Result<InternalFormat, GetFormatError>
Determines the internal format of this texture.
Sourcepub fn get_mipmap_levels(&self) -> u32
pub fn get_mipmap_levels(&self) -> u32
Returns the number of mipmap levels of the texture.
Sourcepub fn main_level(&self) -> TextureAnyMipmap<'_>
pub fn main_level(&self) -> TextureAnyMipmap<'_>
Returns a structure that represents the main mipmap level of the texture.
Sourcepub fn mipmap(&self, level: u32) -> Option<TextureAnyMipmap<'_>>
pub fn mipmap(&self, level: u32) -> Option<TextureAnyMipmap<'_>>
Returns a structure that represents a specific mipmap of the texture.
Returns None
if out of range.
Sourcepub unsafe fn generate_mipmaps(&self)
pub unsafe fn generate_mipmaps(&self)
Binds this texture and generates mipmaps.
Trait Implementations§
Source§impl<'a> AsUniformValue for &'a SrgbTexture2dArray
impl<'a> AsUniformValue for &'a SrgbTexture2dArray
Source§fn as_uniform_value(&self) -> UniformValue<'_>
fn as_uniform_value(&self) -> UniformValue<'_>
UniformValue
.Source§impl Debug for SrgbTexture2dArray
impl Debug for SrgbTexture2dArray
Source§impl Deref for SrgbTexture2dArray
impl Deref for SrgbTexture2dArray
Source§type Target = TextureAny
type Target = TextureAny
Source§fn deref<'a>(&'a self) -> &'a TextureAny
fn deref<'a>(&'a self) -> &'a TextureAny
Auto Trait Implementations§
impl !Freeze for SrgbTexture2dArray
impl !RefUnwindSafe for SrgbTexture2dArray
impl !Send for SrgbTexture2dArray
impl !Sync for SrgbTexture2dArray
impl Unpin for SrgbTexture2dArray
impl !UnwindSafe for SrgbTexture2dArray
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§impl<T> Pointable for T
impl<T> Pointable for T
Source§impl<T> SetParameter for T
impl<T> SetParameter for T
Source§impl<SS, SP> SupersetOf<SS> for SPwhere
SS: SubsetOf<SP>,
impl<SS, SP> SupersetOf<SS> for SPwhere
SS: SubsetOf<SP>,
Source§fn to_subset(&self) -> Option<SS>
fn to_subset(&self) -> Option<SS>
self
from the equivalent element of its
superset. Read moreSource§fn is_in_subset(&self) -> bool
fn is_in_subset(&self) -> bool
self
is actually part of its subset T
(and can be converted to it).Source§unsafe fn to_subset_unchecked(&self) -> SS
unsafe fn to_subset_unchecked(&self) -> SS
self.to_subset
but without any property checks. Always succeeds.Source§fn from_subset(element: &SS) -> SP
fn from_subset(element: &SS) -> SP
self
to the equivalent element of its superset.