[][src]Enum azul_glium::draw_parameters::BackfaceCullingMode

pub enum BackfaceCullingMode {
    CullingDisabled,
    CullCounterClockwise,
    CullClockwise,
}

Describes how triangles should be filtered before the fragment processing. Backface culling is purely an optimization. If you don't know what this does, just use CullingDisabled.

Backface culling

After the vertex shader stage, the GPU knows the 2D coordinates of each vertex of each triangle.

For a given triangle, there are only two situations:

  • The vertices are arranged in a clockwise direction on the screen.
  • The vertices are arranged in a counterclockwise direction on the screen.

If you wish so, you can ask the GPU to discard all the primitives that belong to one of these two categories.

Example

The vertices of this triangle are counter-clock-wise.

1 2 3

Usage

The trick is that if you make a 180° rotation of a shape, all triangles that were clockwise become counterclockwise and vice versa.

Therefore you can arrange your model so that the triangles that are facing the screen are all either clockwise or counterclockwise, and all the triangle are not facing the screen are the other one.

By doing so you can use backface culling to discard all the triangles that are not facing the screen, and increase your framerate.

Variants

All triangles are always drawn.

Triangles whose vertices are counterclockwise won't be drawn.

Triangles whose vertices are clockwise won't be drawn.

Trait Implementations

impl Clone for BackfaceCullingMode
[src]

Performs copy-assignment from source. Read more

impl Copy for BackfaceCullingMode
[src]

impl Eq for BackfaceCullingMode
[src]

impl PartialEq<BackfaceCullingMode> for BackfaceCullingMode
[src]

This method tests for !=.

impl Debug for BackfaceCullingMode
[src]

Auto Trait Implementations

Blanket Implementations

impl<T> Content for T where
    T: Copy
[src]

A type that holds a sized version of the content.

impl<T> From for T
[src]

impl<T, U> Into for T where
    U: From<T>, 
[src]

impl<T> ToOwned for T where
    T: Clone
[src]

impl<T, U> TryFrom for T where
    T: From<U>, 
[src]

🔬 This is a nightly-only experimental API. (try_from)

The type returned in the event of a conversion error.

impl<T> Borrow for T where
    T: ?Sized
[src]

impl<T, U> TryInto for T where
    U: TryFrom<T>, 
[src]

🔬 This is a nightly-only experimental API. (try_from)

The type returned in the event of a conversion error.

impl<T> BorrowMut for T where
    T: ?Sized
[src]

impl<T> Any for T where
    T: 'static + ?Sized
[src]

impl<T> Erased for T