table of contents
ALLEGRO_RENDER_STATE(3alleg5) Allegro reference manual() | ALLEGRO_RENDER_STATE(3alleg5) Allegro reference manual() |
NAME¶
ALLEGRO_RENDER_STATE - Allegro 5 APISYNOPSIS¶
-
#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.