.\" Automatically generated by Pandoc 2.2.1
.\"
.TH "al_set_shader_sampler" "3alleg5" "" "Allegro reference manual" ""
.hy
.SH NAME
.PP
al_set_shader_sampler \- Allegro 5 API
.SH SYNOPSIS
.IP
.nf
\f[C]
#include\ <allegro5/allegro.h>

bool\ al_set_shader_sampler(const\ char\ *name,
\ \ \ ALLEGRO_BITMAP\ *bitmap,\ int\ unit)
\f[]
.fi
.SH DESCRIPTION
.PP
Sets a texture sampler uniform and texture unit of the current target
bitmap's shader.
The given bitmap must be a video bitmap.
.PP
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 \f[C]al_tex\f[] 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 \f[C]NULL\f[] 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
\f[C]al_tex\f[] (the \f[C]al_use_tex\f[] variable will be set to
\f[C]false\f[]).
.PP
Returns true on success.
Otherwise returns false, e.g.\ if the uniform by that name does not
exist in the shader.
.SH SINCE
.PP
5.1.0
.SH SEE ALSO
.PP
al_use_shader(3alleg5)