al_use_transform(3)

🎀 NAME 🎀

al_use_transform(3) — straight from the Library Functions Manual, it’s the Allegro 5 API function that sets your drawing transformation, bestie. Periodt. 💅

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

void al_use_transform(const ALLEGRO_TRANSFORM *trans)

💖 DESCRIPTION 💖

Okay so al_use_transform sets the transformation to be used for the drawing operations on the target bitmap. Lowkey crucial: each bitmap maintains its own transformation. Every drawing operation after this call will be transformed using this transformation. Want the default behaviour back? Call this function with an identity transformation. Slay. 🦋

This function does nothing if there is no target bitmap. Like, nothing nothing. 💀

The parameter is passed by reference as an optimization to avoid the overhead of stack copying. The reference will not be stored in the Allegro library, so it is safe to pass references to local variables. No cap — local ALLEGRO_TRANSFORM is fine. ✨

void setup_my_transformation(void)
{
   ALLEGRO_TRANSFORM transform;
   al_translate_transform(&transform, 5, 10);
   al_use_transform(&transform);
}

💅 Parameters 💅

• trans — Transformation to use 🫶

🌈 SEE ALSO 🌈

• al_get_current_transform(3)
• al_transform_coordinates(3)

---

💖 cute sign-off: this page is from the Allegro reference manual, all about al_use_transform(3). The original footer didn’t give a date, so I’m not inventing one — byeeee 🎀🫶