Enum DepthTest

pub enum DepthTest {
    Ignore,
    Overwrite,
    IfEqual,
    IfNotEqual,
    IfMore,
    IfMoreOrEqual,
    IfLess,
    IfLessOrEqual,
}

The function that the GPU will use to determine whether to write over an existing pixel on the target.

Depth buffers

After the fragment shader has been run, the GPU maps the output Z coordinates to the depth range (which you can specify in the draw parameters) in order to obtain the depth value in in window coordinates. This depth value is always between 0.0 and 1.0.

In addition to the buffer where pixel colors are stored, you can also have a buffer which contains the depth value of each pixel. Whenever the GPU tries to write a pixel, it will first compare the depth value of the pixel to be written with the depth value that is stored at this location. If depth_write is set to true in the draw parameters, it will then write the depth value in the buffer.

The most common value for depth testing is to set depth_test to IfLess, and depth_write to true.

If you don’t have a depth buffer available, you can only pass Overwrite. Glium detects if you pass any other value and reports an error.

Variants

Ignore

Never replace the target pixel.

This option doesn’t really make sense, but is here for completeness.

Overwrite

Always replace the target pixel.

This is the default mode.

IfEqual

Replace if the z-value of the source is equal to the destination.

IfNotEqual

Replace if the z-value of the source is different than the destination.

IfMore

Replace if the z-value of the source is more than the destination.

IfMoreOrEqual

Replace if the z-value of the source is more than, or equal to the destination.

IfLess

Replace if the z-value of the source is less than the destination.

IfLessOrEqual

Replace if the z-value of the source is less than, or equal to the destination.

Implementations

impl DepthTest

pub fn requires_depth_buffer(&self) -> bool

Returns true if the function requires a depth buffer to be used.

Trait Implementations

impl Clone for DepthTest

fn clone(&self) -> DepthTest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DepthTest

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

Formats the value using the given formatter.

impl PartialEq for DepthTest

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for DepthTest

impl Eq for DepthTest

impl StructuralPartialEq for DepthTest