al_set_new_bitmap_wrap(3alleg5)

💖 al_set_new_bitmap_wrap — Allegro 5 API 💖

okay bestie, welcome to the Allegro reference manual ✨ this one's a lil function called al_set_new_bitmap_wrap, and she's lowkey niche but highkey important, so let's get into it 🫶

---

🎀 NAME 🎀

al_set_new_bitmap_wrap — Allegro 5 API

literally that's the whole vibe of this page, bestie. one function. one job. slay.

---

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

void al_set_new_bitmap_wrap(ALLEGRO_BITMAP_WRAP u, ALLEGRO_BITMAP_WRAP v)

two args, u and v, both of them ALLEGRO_BITMAP_WRAP typed. that's the whole signature, no cap 💅

---

🌸 DESCRIPTION 🌸

so what does she DO? she sets the texture wrapping settings for newly created bitmaps — and yes, specifically on the current thread, okay? like, thread-specific energy. main character but only in her own thread. periodt 💅

and how do you usually actually use this setting once you've set it? two ways, bestie:

• via the primitives addon — think al_draw_prim(3alleg5) and friends 🧚
• or via custom shaders — that's ALLEGRO_SHADER(3alleg5) if you wanna go look 👑

⚠️ Note: okay so when we're talking about custom shaders, Direct3D and OpenGL are NOT on the same page about how fine-grained this setting is. Direct3D sets the wrapping setting for each sampler separately, while OpenGL sets it per-texture. and the way that this interacts particularly poorly with the primitives addon — which, for backwards compatibility, alters the wrapping setting — is genuinely giving chaos 😭 to minimize this whole mess, use a wrapping setting that's not ALLEGRO_BITMAP_WRAP_DEFAULT. fr fr, just don't.

---

⭐ SINCE ⭐

5.2.8 — she's a newer girlie, born in 5.2.8 🦋

🙈 [Unstable API]: this is an experimental feature. so like, she's cute, she works, but she's still figuring herself out. proceed with that in mind, bestie.

---

🌈 SEE ALSO 🌈

• ALLEGRO_BITMAP_WRAP(3alleg5) — go read her, she explains the wrap values 💜

---

and that's the whole page, bestie!! 💖 this was the Allegro reference manual version of al_set_new_bitmap_wrap(3alleg5), so if you ever need her again just pull up the manpage, iykyk 🌸 go forth and wrap those textures responsibly, mwah 🎀💅✨