AL_SET_SHADER_INT_VECTOR(3)

💖 al_set_shader_int_vector(3) 💖

okay bestie, this page comes from the Library Functions Manual, and it’s all about al_set_shader_int_vector from the Allegro 5 API. pull up a chair, we’re doing shader uniforms today 💅✨

🌸 NAME 🌸

al_set_shader_int_vector — Allegro 5 API. literally the function for setting an integer vector array uniform, no cap 🫶

✨ SYNOPSIS ✨

              #include <allegro5/allegro.h>

              bool al_set_shader_int_vector(const char *name,
                 int num_components, const int *i, int num_elems)

💅 DESCRIPTION 💅

okay so this function sets an integer vector array uniform of the current target bitmap’s shader. The num_components parameter can take one of the values 1, 2, 3 or 4. If it is 1 then an array of num_elems integer elements is added. Otherwise each added array element is assumed to be a vector with 2, 3 or 4 components in it. slay 💖

for example, if you have a GLSL uniform declared as uniform ivec3 flowers[4] or an HLSL uniform declared as uniform int3 flowers[4], then you’d use this function from your code like so:

              int flowers[4][3] =
              {
                 {1, 2, 3},
                 {4, 5, 6},
                 {7, 8, 9},
                 {2, 5, 7}
              };

              al_set_shader_int_vector("flowers", 3, (int*)flowers, 4);

returns true on success. Otherwise returns false, e.g. if the uniform by that name does not exist in the shader. not me checking the return value every single time 🙈✨

🎀 SINCE 🎀

5.1.0 — she’s been here, okay? iconic behavior 👑

🦋 SEE ALSO 🦋

• al_set_shader_float_vector(3)
• al_use_shader(3)

---

cute little sign-off: from the Allegro reference manual, page al_set_shader_int_vector(3) — source is the Allegro reference manual, page is al_set_shader_int_vector(3), and the footer did not give me a date, so no invented date bestie, just vibes and a little kiss 💖🎀