.\" Automatically generated by Pandoc 3.1.3
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.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[R]
.fi
.SH DESCRIPTION
.PP
Sets a texture sampler uniform and texture unit of the current target
bitmap\[cq]s shader.
The given bitmap must be a video bitmap.
.PP
Different samplers should use different units.
The bitmap passed to Allegro\[cq]s drawing functions uses the 0th unit,
so if you\[cq]re planning on using the \f[V]al_tex\f[R] 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[V]NULL\f[R] 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[V]al_tex\f[R] (the \f[V]al_use_tex\f[R] variable will be set to
\f[V]false\f[R]).
.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)