putpixel(3alleg4)

✨ putpixel — writes a pixel into a bitmap ✨

okay bestie, so this is the Allegro game programming library manual, and today we're talking about putpixel(3alleg4) 💅 the little function that literally puts one single pixel on your screen and honestly? iconic. every gorgeous sprite you've ever seen started as somebody putting down pixels one at a time. no cap. 🎀

💖 NAME 💖

putpixel — writes a pixel into a bitmap. part of the Allegro game programming library. that's the whole vibe. 🦋

🌸 SYNOPSIS 🌸

#include <allegro.h>

void putpixel(BITMAP *bmp, int x, int y, int color);

look at her. four arguments. no drama. she ate and left zero crumbs. ✨

🫶 DESCRIPTION 🫶

okay so here's the tea 🍓 — putpixel writes a pixel to the specified position in the bitmap, and the way it does that is by using the current drawing mode and the bitmap's clipping rectangle. so like, it's not just blindly slapping a color down wherever, bestie, it's respecting the drawing mode you've set and it's staying inside the clip rect. main character behaviour honestly. 👑

here's a little example so you can see her in action:

putpixel(screen, 10, 30, some_color);

that's it. that's the whole flex. one pixel, one position, one color, and suddenly you're a graphics programmer. 😭🔥

ngl, if you're looping this over a whole image you're gonna want to peek at the SEE ALSO section below, because there are other pixel-poking friends in this library and they all have their own energy. 💜

🌈 SEE ALSO 🌈

the whole squad, fr fr — go check them out:

• getpixel(3alleg4) — the read to this write, they're a matched set 💞
• _putpixel(3alleg4) — the underscore version, iykyk
• drawing_mode(3alleg4) — sets the vibe that putpixel respects
• makecol(3alleg4) — how you get a color value in the first place
• ex12bit(3alleg4)
• exalpha(3alleg4)
• exflame(3alleg4)
• exjoy(3alleg4)
• exstars(3alleg4)
• exswitch(3alleg4)

and that's the page, bestie!! this was Allegro, version 4.4.3, and the date on this whole thing is putpixel(3alleg4) era — yeah the footer just says the manual name and version and that's so real of it. go put some pixels down, you're doing amazing. mwah. 💖✨🎀🦋🌸💅🫶