al_init_user_event_source(3alleg5)

💖 al_init_user_event_source — Allegro 5 API 💖

okay bestie, welcome to the Allegro 5 API page for al_init_user_event_source, and yes we're doing this together, grab a snack 🍓

---

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

void al_init_user_event_source(ALLEGRO_EVENT_SOURCE *src)

---

🌸 DESCRIPTION 🌸

So like, this function initialises an event source for emitting user events. That's the whole job. The way it works is: the space for the event source has to already be allocated — like, you gotta have that memory ready before you call this, she does not do it for you, no cap. 🙈

One possible way of creating custom event sources is to derive other structures with ALLEGRO_EVENT_SOURCE at the head, like:

typedef struct THING THING;

struct THING {
    ALLEGRO_EVENT_SOURCE event_source;
    int field1;
    int field2;
    /* etc. */
};

THING *create_thing(void)
{
    THING *thing = malloc(sizeof(THING));

    if (thing) {
        al_init_user_event_source(&thing->event_source);
        thing->field1 = 0;
        thing->field2 = 0;
    }

    return thing;
}

And the advantage here, the little slay of it all, is that the THING pointer will be the same as the ALLEGRO_EVENT_SOURCE pointer 👑. Like they're the same address, they're matching, it's giving destiny fr fr. So events emitted by the event source will have the event source pointer as the source field, and from that you can get a pointer to a THING by a simple cast — after making sure you checked the event is of the correct type first, obviously, do not skip that step babe 💅.

However — and this is important — it is only one technique, and you are not obliged to use it. It's an option, not a rule. Live your truth. 🦋

Also, big heads up: the user event source will never be destroyed automatically. Never ever. Not on its own, not when you look away, not ever. You must destroy it manually with al_destroy_user_event_source(3alleg5). Don't leave her hanging, that's so not main character energy 😭

---

🌈 SEE ALSO 🌈

• ALLEGRO_EVENT_SOURCE(3alleg5)
• al_destroy_user_event_source(3alleg5)
• al_emit_user_event(3alleg5)
• ALLEGRO_USER_EVENT(3alleg5)

---

Allegro reference manual ✨ that's the vibe, that's the source, that's the al_init_user_event_source(3alleg5) footer energy — this page came straight out of the Allegro reference manual and it's dated like the iconic classic it is. mwah, go init your event sources bestie 💖🎀🧚