al_put_pixel(3)

✨ al_put_pixel(3) — the Allegro 5 pixel-dropping icon ✨

okay so bestie, we're in the Allegro 5 API section of the Library Functions Manual, and today's main character is al_put_pixel — the tiny function that puts exactly one (1) pixel on your bitmap. one pixel. that's the whole job. she's not doing more than that and honestly? respect. 💅

---

🌸 SYNOPSIS 🌸

#include <allegro5/allegro.h>

void al_put_pixel(int x, int y, ALLEGRO_COLOR color)

like, that's it. three params, no drama, no return value. she does her thing and leaves. 🫶

---

💖 DESCRIPTION 💖

Draw a single pixel on the target bitmap — one pixel, at x, y, in whatever ALLEGRO_COLOR you hand her. simple, iconic, no notes. ✨

now for the real talk, because bestie you need to hear this one: this operation is slow on non-memory bitmaps. like, slow slow. 😭 if you're gonna call this function multiple times on the same bitmap, please consider locking the bitmap — that's the move, that's the whole vibe check, use the lock. 🔒

and lowkey the most important detail: this function is not affected by the transformations or the color blenders. no cap, she ignores all of that. transformations? doesn't care. blenders? not today. she just puts the pixel, exactly as told. 💀

---

🌈 SEE ALSO 🌈

• ALLEGRO_COLOR(3)
• al_get_pixel(3)
• al_put_blended_pixel(3)
• al_lock_bitmap(3)

---

⭐ friendly reminder bestie: al_lock_bitmap(3) is right there in the SEE ALSO for a reason — if you're going pixel-by-pixel in a loop on a non-memory bitmap, lock it first or your frame time is gonna be giving 🐢 energy.

---

that's the whole page, bestie — go forth and place that single pixel with confidence. 💜

this has been the Allegro reference manual, al_put_pixel(3) entry, byeeee 🎀🦋