Struct GlRenderState 

pub struct GlRenderState { /* private fields */ }

The whole fixed-function state of one draw, as a single Copy value.

The point of bundling these six fields into one struct is that it can be diffed field by field against the state currently bound, so WebGl2Backend::apply_state issues a GL call only for what actually changed. A renderer that calls enable, depthFunc, depthMask, blendFunc, blendEquation, cullFace, frontFace, colorMask, scissor, and viewport unconditionally pays for a dozen redundant calls per draw, each one a validation check inside the driver.

Implementations

impl GlRenderState

Implements default construction for the fixed-function state shadow.

pub fn context_defaults(width: i32, height: i32) -> GlRenderState

Builds the state a freshly created WebGL 2 context is actually in.

Every value here is one the driver has already set up, not a zero placeholder, and that is the point: seeding the diffing shadow with the real defaults means the first WebGl2Backend::apply_state emits only the calls that genuinely differ from what the driver already did, rather than a dozen redundant re-assertions. Getting a single default wrong would instead leave one field permanently un-applied, because the diff would consider it unchanged forever.

Depth test off, depth write on, LEQUAL once enabled; blending off; culling off with counter-clockwise front faces; all four color channels writable; scissor off; viewport covering the given size.

Arguments

• i32 - The viewport width in pixels.
• i32 - The viewport height in pixels.

Returns

• GlRenderState - The state a new context starts in.

impl GlRenderState

pub fn get_depth(&self) -> &GlDepthState

pub fn get_mut_depth(&mut self) -> &mut GlDepthState

pub fn set_depth(&mut self, val: GlDepthState) -> &mut Self

pub fn get_blend(&self) -> &GlBlendState

pub fn get_mut_blend(&mut self) -> &mut GlBlendState

pub fn set_blend(&mut self, val: GlBlendState) -> &mut Self

pub fn get_cull(&self) -> &GlCullState

pub fn get_mut_cull(&mut self) -> &mut GlCullState

pub fn set_cull(&mut self, val: GlCullState) -> &mut Self

pub fn get_color_mask(&self) -> &GlColorMask

pub fn get_mut_color_mask(&mut self) -> &mut GlColorMask

pub fn set_color_mask(&mut self, val: GlColorMask) -> &mut Self

pub fn get_scissor(&self) -> GlScissor

pub fn try_get_scissor(&self) -> &Option<GlScissor>

pub fn get_mut_scissor(&mut self) -> &mut Option<GlScissor>

pub fn set_scissor(&mut self, val: Option<GlScissor>) -> &mut Self

pub fn get_viewport(&self) -> &GlViewport

pub fn get_mut_viewport(&mut self) -> &mut GlViewport

pub fn set_viewport(&mut self, val: GlViewport) -> &mut Self

Trait Implementations

impl Clone for GlRenderState

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for GlRenderState

impl Debug for GlRenderState

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

Formats the value using the given formatter.

impl PartialEq for GlRenderState

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for GlRenderState