love.graphics.setDepthMode

Available since LÖVE 11.0
This function is not supported in earlier versions.

Configures depth testing and writing to the depth buffer.

This is low-level functionality designed for use with custom vertex shaders and Meshes with custom vertex attributes. No higher level APIs are provided to set the depth of 2D graphics such as shapes, lines, and Images.


O.png Depth writes will not work without an active depth buffer.  


O.png Writing to the depth buffer is generally incompatible with rendering alpha-blended sprites / images. By default depth is determined by geometry (vertices) instead of texture alpha values, the depth buffer only stores a single depth value per pixel, and alpha blending requires back-to-front rendering for blending to be correct.  


Function

Synopsis

love.graphics.setDepthMode( comparemode, write  )

Arguments

CompareMode comparemode
Depth comparison mode used for depth testing.
boolean write
Whether to write update / write values to the depth buffer when rendering.

Returns

Nothing.

Function

Disables depth testing and depth writes.

Synopsis

love.graphics.setDepthMode( )

Arguments

None.

Returns

Nothing.

See Also


Other Languages