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.
Depth testing and depth writes will have no effect unless the depth field is set to true in a table passed to love.graphics.setCanvas, or a custom Canvas with a depth PixelFormat is set in the depthstencil field in a table passed to setCanvas.
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
- love.graphics
- love.graphics.getDepthMode
- love.graphics.setCanvas
- love.graphics.clear
- PixelFormat
- Mesh
© 2006–2020 LÖVE Development Team
Licensed under the GNU Free Documentation License, Version 1.3.
https://love2d.org/wiki/love.graphics.setDepthMode