Provided by: allegro5-doc_5.2.3.0-1_all bug

NAME

       al_set_shader_sampler - Allegro 5 API

SYNOPSIS

              #include <allegro5/allegro.h>

              bool al_set_shader_sampler(const char *name,
                 ALLEGRO_BITMAP *bitmap, int unit)

DESCRIPTION

       Sets  a  texture  sampler  uniform and texture unit of the current target bitmap's shader.
       The given bitmap must be a video bitmap.

       Different samplers should use different units.  The bitmap  passed  to  Allegro's  drawing
       functions  uses  the  0th unit, so if you're planning on using the al_tex variable in your
       pixel shader as well as another sampler, set the other sampler to  use  a  unit  different
       from 0.  With the primitives addon, it is possible to free up the 0th unit by passing NULL
       as the texture argument to the relevant drawing functions.  In this case, you  may  set  a
       sampler  to  use the 0th unit and thus not use al_tex (the al_use_tex variable will be set
       to false).

       Returns true on success.  Otherwise returns false, e.g.  if the uniform by that name  does
       not exist in the shader.

SINCE

       5.1.0

SEE ALSO

       al_use_shader(3alleg5)