NAME

       ALLEGRO_RENDER_STATE - Allegro 5 API

SYNOPSIS

              #include <allegro5/allegro.h>

              typedef enum ALLEGRO_RENDER_STATE {

DESCRIPTION

       Possible render states which can be set with al_set_render_state(3alleg5):

       ALLEGRO_ALPHA_TEST
              If    this    is   set   to   1,   the   values   of   ALLEGRO_ALPHA_FUNCTION   and
              ALLEGRO_ALPHA_TEST_VALUE define a comparison function which is performed  for  each
              pixel.  Only if it evaluates to true the pixel is written.  Otherwise no subsequent
              processing (like depth test or blending) is performed.

       ALLEGRO_ALPHA_FUNCTION
              One of ALLEGRO_RENDER_FUNCTION(3alleg5), only used when ALLEGRO_ALPHA_TEST is 1.

       ALLEGRO_ALPHA_TEST_VALUE
              Only used when ALLEGRO_ALPHA_TEST is 1.

       ALLEGRO_WRITE_MASK
              This determines how the framebuffer and depthbuffer are updated whenever a pixel is
              written  (in  case  alpha  and/or  depth testing is enabled: after all such enabled
              tests succeed).  Depth values are only  written  if  ALLEGRO_DEPTH_TEST  is  1,  in
              addition to the write mask flag being set.

       ALLEGRO_DEPTH_TEST
              If  this  is set to 1, compare the depth value of any newly written pixels with the
              depth value already in the buffer, according  to  ALLEGRO_DEPTH_FUNCTION.   Allegro
              primitives  with  no  explicit  z coordinate will write a value of 0 into the depth
              buffer.

       ALLEGRO_DEPTH_FUNCTION
              One of ALLEGRO_RENDER_FUNCTION(3alleg5), only used when ALLEGRO_DEPTH_TEST is 1.

SINCE

       5.1.2

SEE ALSO

       al_set_render_state(3alleg5),                            ALLEGRO_RENDER_FUNCTION(3alleg5),
       ALLEGRO_WRITE_MASK_FLAGS(3alleg5)