.\" Automatically generated by Pandoc 3.6.1
.\"
.TH "al_clear_depth_buffer" "3" "" "Allegro reference manual"
.SH NAME
al_clear_depth_buffer \- Allegro 5 API
.SH SYNOPSIS
.IP
.EX
#include \f[B]<allegro5/allegro.h>\f[R]

void al_clear_depth_buffer(float z)
.EE
.SH DESCRIPTION
Clear the depth buffer (confined by the clipping rectangle) to the given
value.
A depth buffer is only available if it was requested with
al_set_new_display_option(3) and the requirement could be met by the
al_create_display(3) call creating the current display.
Operations involving the depth buffer are also affected by
al_set_render_state(3).
.PP
For example, if \f[CR]ALLEGRO_DEPTH_FUNCTION\f[R] is set to
\f[CR]ALLEGRO_RENDER_LESS\f[R] then depth buffer value of 1 represents
infinite distance, and thus is a good value to use when clearing the
depth buffer.
.SH SINCE
5.1.2
.SH SEE ALSO
al_clear_to_color(3), al_set_clipping_rectangle(3),
al_set_render_state(3), al_set_new_display_option(3)