Struct glium::texture::texture2d_multisample::Texture2dMultisample

pub struct Texture2dMultisample(_);

A two-dimensional texture containing floating-point data.

Methods

impl Texture2dMultisample

fn sampled(&self) -> Sampler<Texture2dMultisample>

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 Texture2dMultisample

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.

fn empty<F>(facade: &F, width: u32, height: u32, samples: u32) -> Result<Texture2dMultisample, TextureCreationError> where F: Facade

Creates an empty texture.

No mipmap level (except for the main level) will be allocated or generated.

The texture will contain undefined data.

fn empty_with_format<F>(facade: &F, format: UncompressedFloatFormat, mipmaps: MipmapsOption, width: u32, height: u32, samples: u32) -> Result<Texture2dMultisample, TextureCreationError> where F: Facade

Creates an empty texture with a specific format.

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

fn empty_with_mipmaps<F>(facade: &F, mipmaps: MipmapsOption, width: u32, height: u32, samples: u32) -> Result<Texture2dMultisample, TextureCreationError> where F: Facade

Creates an empty texture. Specifies whether is has mipmaps.

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

unsafe fn from_id<F: Facade>(facade: &F, format: UncompressedFloatFormat, id: GLuint, owned: bool, mipmap: MipmapsOption, ty: Dimensions) -> Texture2dMultisample

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.

fn width(&self) -> u32

Returns the width of that image.

fn height(&self) -> u32

Returns the height of that image.

fn samples(&self) -> u32

Returns the number of samples of that image.

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

Returns the width and height of that image.

fn as_surface<'a>(&'a self) -> SimpleFrameBuffer<'a>

Starts drawing on the texture.

All the function calls to the framebuffer will draw on the texture instead of the screen.

Low-level information

The first time that this function is called, a FrameBuffer Object will be created and cached. The following calls to as_surface will load the existing FBO and re-use it. When the texture is destroyed, the FBO is destroyed too.

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.

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.

fn mipmap(&self, level: u32) -> Option<Texture2dMultisampleMipmap>

Access a single mipmap level of this texture.

fn main_level(&self) -> Texture2dMultisampleMipmap

Access the main mipmap level of this texture.

Methods from Deref<Target=TextureAny>

fn get_width(&self) -> u32

Returns the width of the texture.

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

Returns the height of the texture.

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

Returns the depth of the texture.

fn kind(&self) -> TextureKind

Returns the kind of texture.

fn dimensions(&self) -> Dimensions

Returns the dimensions of the texture.

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

Returns the array size of the texture.

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

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

fn first_layer(&self) -> TextureAnyLayer

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

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.

fn get_texture_type(&self) -> Dimensions

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

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

Determines the internal format of this texture.

fn get_mipmap_levels(&self) -> u32

Returns the number of mipmap levels of the texture.

fn main_level(&self) -> TextureAnyMipmap

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

fn mipmap(&self, level: u32) -> Option<TextureAnyMipmap>

Returns a structure that represents a specific mipmap of the texture.

Returns None if out of range.

unsafe fn generate_mipmaps(&self)

Binds this texture and generates mipmaps.

Trait Implementations

impl GlObject for Texture2dMultisample

type Id = GLuint

The type of identifier for this object.

fn get_id(&self) -> GLuint

Returns the id of the object.

impl Debug for Texture2dMultisample

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

Formats the value using the given formatter.

impl Deref for Texture2dMultisample

type Target = TextureAny

The resulting type after dereferencing

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

The method called to dereference a value

impl<'a> AsUniformValue for &'a Texture2dMultisample

fn as_uniform_value(&self) -> UniformValue

Builds a UniformValue.

impl<'t> ToColorAttachment<'t> for &'t Texture2dMultisample

fn to_color_attachment(self) -> ColorAttachment<'t>

Builds the ColorAttachment.