Struct aflak_imgui_glium_renderer::Texture

pub struct Texture(_);

Handle to a glium texture

Implements [Deref] to get direct access to the underlying Texture2d object.

Methods

impl Texture

pub fn from_texture_2d(texture: Texture2d) -> Self

pub fn from_data<'a, F, T>(     facade: &F,     data: T ) -> Result<Self, TextureCreationError> where     T: Texture2dDataSource<'a>,     F: Facade,

pub fn from_raw<F, P>(     facade: &F,     width: u32,     height: u32,     data: &[P] ) -> Result<Self, TextureCreationError> where     F: Facade,     P: PixelValue,

Methods from Deref<Target = Texture2d>

pub fn sampled(&self) -> Sampler<Texture2d>

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

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 width(&self) -> u32

Returns the width of that image.

pub fn height(&self) -> u32

Returns the height of that image.

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

Returns the width and height of that image.

pub fn as_surface(&'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.

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<T>(&self) -> T where     T: Texture2dDataSink<(u8, u8, u8, u8)>,

Reads the content of the texture to RAM. This method may only read U8U8U8U8 data, as it is the only format guaranteed to be supported across all OpenGL versions.

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

pub fn read_to_pixel_buffer(&self) -> PixelBuffer<(u8, u8, u8, u8)>

Reads the content of the texture into a buffer in video memory. This method may only read U8U8U8U8 data, as it is the only format guaranteed to be supported across all OpenGL versions.

This operation copies the texture's data into a buffer in video memory (a pixel buffer). Contrary to the read function, this operation is done asynchronously and doesn't need a synchronization.

pub unsafe fn unchecked_read<T, P>(&self) -> T where     P: PixelValue,     T: Texture2dDataSink<P>,

Unsafely reads the content of the texture to RAM in the specified pixel format. It is possible that the current OpenGL context does not support the given format, in which case the returned data will be invalid.

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

pub unsafe fn unchecked_read_to_pixel_buffer<P>(&self) -> PixelBuffer<P> where     P: PixelValue,

Unsafely reads the content of the texture into a buffer in video memory. It is possible that the current OpenGL context does not support the given format, in which case the returned data will be invalid.

This operation copies the texture's data into a buffer in video memory (a pixel buffer). Contrary to the read function, this operation is done asynchronously and doesn't need a synchronization.

pub fn write<'a, T>(&self, rect: Rect, data: T) where     T: Texture2dDataSource<'a>,

Uploads some data in the texture.

Note that this may cause a synchronization if you use the texture right before or right after this call. Prefer creating a whole new texture if you change a huge part of it.

Panic

Panics if the the dimensions of data don't match the Rect.

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

Access a single mipmap level of this texture.

pub fn main_level(&self) -> Texture2dMipmap

Access the main mipmap level of this texture.

Trait Implementations

impl ImTexture for Texture

fn get_id(&self) -> ImTextureID

Get ImTextureID

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

Query texture size, in pixels (for convenience)

impl Deref for Texture

type Target = Texture2d

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl FromImTexture for Texture

Important traits for &'a mut R

impl<'a, R> Read for &'a mut R where
    R: Read + ?Sized, impl<'a, W> Write for &'a mut W where
    W: Write + ?Sized, impl<'a, I> Iterator for &'a mut I where
    I: Iterator + ?Sized,  type Item = <I as Iterator>::Item;

fn from_id<'a>(texture_id: ImTextureID) -> &'a Self

Important traits for &'a mut R

impl<'a, R> Read for &'a mut R where
    R: Read + ?Sized, impl<'a, W> Write for &'a mut W where
    W: Write + ?Sized, impl<'a, I> Iterator for &'a mut I where
    I: Iterator + ?Sized,  type Item = <I as Iterator>::Item;

fn from_im_texture<T>(texture: &T) -> &Self where     T: ImTexture,