Struct glium::texture::compressed_texture3d::CompressedTexture3d

pub struct CompressedTexture3d(_);

A compressed three-dimensional texture containing floating-point data.

Implementations

impl CompressedTexture3d

pub fn sampled(&self) -> Sampler<'_, CompressedTexture3d>

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)
};

impl CompressedTexture3d

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.

pub fn new<'a, F: ?Sized, T>(
    facade: &F,
    data: T
) -> Result<CompressedTexture3d, TextureCreationError> where
    T: Texture3dDataSource<'a>,
    F: Facade, 

Builds a new texture by uploading data.

No mipmap level (except for the main level) will be allocator nor generated.

pub fn with_mipmaps<'a, F: ?Sized, T>(
    facade: &F,
    data: T,
    mipmaps: CompressedMipmapsOption
) -> Result<CompressedTexture3d, TextureCreationError> where
    T: Texture3dDataSource<'a>,
    F: Facade, 

Builds a new texture by uploading data.

pub fn with_compressed_data<F: ?Sized>(
    facade: &F,
    data: &[u8],
    width: u32,
    height: u32,
    depth: u32,
    format: CompressedFormat,
    mipmaps: CompressedMipmapsOption
) -> Result<CompressedTexture3d, TextureCreationError> where
    F: Facade, 

Builds a new texture with a specific format. The input data must also be of the specified compressed format.

pub fn with_format<'a, F: ?Sized, T>(
    facade: &F,
    data: T,
    format: CompressedFormat,
    mipmaps: CompressedMipmapsOption
) -> Result<CompressedTexture3d, TextureCreationError> where
    T: Texture3dDataSource<'a>,
    F: Facade, 

Builds a new texture with a specific format.

pub fn empty_with_format<F: ?Sized>(
    facade: &F,
    format: CompressedFormat,
    mipmaps: CompressedMipmapsOption,
    width: u32,
    height: u32,
    depth: u32
) -> Result<CompressedTexture3d, TextureCreationError> where
    F: Facade, 

Creates an empty texture with a specific format.

The texture (and its mipmaps) will contain undefined data.

pub unsafe fn from_id<F: Facade + ?Sized>(
    facade: &F,
    format: CompressedFormat,
    id: c_uint,
    owned: bool,
    mipmap: MipmapsOption,
    ty: Dimensions
) -> CompressedTexture3d

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.

pub fn width(&self) -> u32

Returns the width of that image.

pub fn height(&self) -> u32

Returns the height of that image.

pub fn depth(&self) -> u32

Returns the depth of that image.

pub fn dimensions(&self) -> (u32, u32, u32)

Returns the width, height and depth of that image.

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.

pub fn read_compressed_data(&self) -> Option<(CompressedFormat, Vec<u8>)>

Reads the content of the texture to RAM without decompressing it before.

You should avoid doing this at all cost during performance-critical operations (for example, while you're drawing).

Returns the compressed format of the texture and the compressed data, gives None when the internal compression format is generic or unknown.

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.

pub fn mipmap(&self, level: u32) -> Option<CompressedTexture3dMipmap<'_>>

Access a single mipmap level of this texture.

pub fn main_level(&self) -> CompressedTexture3dMipmap<'_>

Access the main mipmap level of this texture.

Methods from Deref<Target = TextureAny>

pub fn get_width(&self) -> u32

Returns the width of the texture.

pub fn get_height(&self) -> Option<u32>

Returns the height of the texture.

pub fn get_depth(&self) -> Option<u32>

Returns the depth of the texture.

pub fn kind(&self) -> TextureKind

Returns the kind of texture.

pub fn dimensions(&self) -> Dimensions

Returns the dimensions of the texture.

pub fn get_array_size(&self) -> Option<u32>

Returns the array size of the texture.

pub fn get_samples(&self) -> Option<u32>

Returns the number of samples of the texture if it is a multisampling texture.

pub fn first_layer(&self) -> TextureAnyLayer<'_>

Returns a structure that represents the first layer of the texture. All textures have a first layer.

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.

pub fn get_texture_type(&self) -> Dimensions

Returns the type of the texture (1D, 2D, 3D, etc.).

pub fn get_internal_format(&self) -> Result<InternalFormat, GetFormatError>

Determines the internal format of this texture.

pub fn get_depth_stencil_bits(&self) -> (u16, u16)

Determines the number of depth and stencil bits in the format of this texture.

pub fn get_mipmap_levels(&self) -> u32

Returns the number of mipmap levels of the texture.

pub fn main_level(&self) -> TextureAnyMipmap<'_>

Returns a structure that represents the main mipmap level of the texture.

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.

pub unsafe fn generate_mipmaps(&self)

Binds this texture and generates mipmaps.

Trait Implementations

impl<'a> AsUniformValue for &'a CompressedTexture3d

fn as_uniform_value(&self) -> UniformValue<'_>

Builds a UniformValue.

impl Debug for CompressedTexture3d

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

Formats the value using the given formatter.

impl Deref for CompressedTexture3d

type Target = TextureAny

The resulting type after dereferencing.

fn deref<'a>(&'a self) -> &'a TextureAny

Dereferences the value.

impl GlObject for CompressedTexture3d

type Id = c_uint

The type of identifier for this object.

fn get_id(&self) -> c_uint

Returns the id of the object.