Struct GlTexture

pub struct GlTexture { /* private fields */ }

Implementations

impl GlTexture

pub fn new( server: &GlGraphicsServer, desc: GpuTextureDescriptor<'_>, ) -> Result<GlTexture, FrameworkError>

Creates new GPU texture of specified kind. Mip count must be at least 1, it means that there is only main level of detail.

Data layout

In case of Cube texture, bytes should contain all 6 cube faces ordered like so, +X, -X, +Y, -Y, +Z, -Z. Cube mips must follow one after another.

Produced texture can be used as render target for framebuffer, in this case data parameter can be None.

Compressed textures

For compressed textures data must contain all mips, where each mip must be 2 times smaller than previous.

pub fn bind(&self, server: &GlGraphicsServer, sampler_index: u32)

pub fn id(&self) -> <Context as HasContext>::Texture

Trait Implementations

impl Drop for GlTexture

fn drop(&mut self)

Executes the destructor for this type.

impl GpuTexture for GlTexture

fn set_anisotropy(&mut self, anisotropy: f32)

Max samples for anisotropic filtering. Default value is 16.0 (max). However, real value passed to GPU will be clamped to maximum supported by current GPU. To disable anisotropic filtering set this to 1.0. Typical values are 2.0, 4.0, 8.0, 16.0.

fn anisotropy(&self) -> f32

Returns current anisotropy level.

fn set_minification_filter(&mut self, filter: MinificationFilter)

Sets new minification filter. It is used when texture becomes smaller. See MinificationFilter docs for more info.

fn minification_filter(&self) -> MinificationFilter

Returns current minification filter.

fn set_magnification_filter(&mut self, filter: MagnificationFilter)

Sets new magnification filter. It is used when texture is “stretching”. See MagnificationFilter docs for more info.

fn magnification_filter(&self) -> MagnificationFilter

Returns current magnification filter.

fn set_wrap(&mut self, coordinate: Coordinate, wrap: WrapMode)

Sets new wrap mode for the given coordinate. See WrapMode for more info.

fn wrap_mode(&self, coordinate: Coordinate) -> WrapMode

Returns current wrap mode for the given coordinate.

fn set_border_color(&mut self, color: Color)

Sets border color of the texture. Works together with WrapMode::ClampToBorder and essentially forces the GPU to use the given color when it tries to read outside the texture bounds.

fn set_data( &mut self, kind: GpuTextureKind, pixel_kind: PixelKind, mip_count: usize, data: Option<&[u8]>, ) -> Result<(), FrameworkError>

Sets the new data of the texture. This method is also able to change the kind of the texture and its pixel kind.

fn get_image(&self, level: usize) -> Vec<u8>

Reads the texture data at the given mip level. This method could block current thread until the data comes from GPU to CPU side.

fn read_pixels(&self) -> Vec<u8>

Reads texture pixels.

fn kind(&self) -> GpuTextureKind

Returns kind of the texture.

fn pixel_kind(&self) -> PixelKind

Returns pixel kind of the texture.

fn set_base_level(&mut self, level: usize)

Specifies the index of the lowest defined mipmap level. Keep in mind, that the texture data should provide the actual mip map level defined by the provided value, otherwise the rendering will be incorrect (probably just black on majority of implementations) and glitchy.

fn base_level(&self) -> usize

Returns the index of the lowest defined mipmap level.

fn set_max_level(&mut self, level: usize)

Sets the index of the highest defined mipmap level. Keep in mind, that the texture data should provide the actual mip map level defined by the provided value, otherwise the rendering will be incorrect (probably just black on majority of implementations) and glitchy.

fn max_level(&self) -> usize

Returns the index of the highest defined mipmap level.

fn set_min_lod(&mut self, min_lod: f32)

Sets the minimum level-of-detail parameter. This floating-point value limits the selection of highest resolution mipmap (lowest mipmap level). The initial value is -1000.0.

fn min_lod(&self) -> f32

Returns the minimum level-of-detail parameter. See Self::set_min_lod for more info.

fn set_max_lod(&mut self, max_lod: f32)

Sets the maximum level-of-detail parameter. This floating-point value limits the selection of the lowest resolution mipmap (highest mipmap level). The initial value is 1000.

fn max_lod(&self) -> f32

Returns the maximum level-of-detail parameter. See Self::set_max_lod for more info.

fn set_lod_bias(&mut self, bias: f32)

Specifies a fixed bias value that is to be added to the level-of-detail parameter for the texture before texture sampling. The specified value is added to the shader-supplied bias value (if any) and subsequently clamped into the implementation-defined range −bias_max..bias_max, where bias_max is the value that can be fetched from the current graphics server. The initial value is 0.0.

fn lod_bias(&self) -> f32

Returns a fixed bias value that is to be added to the level-of-detail parameter for the texture before texture sampling. See Self::set_lod_bias for more info.