object_message(3alleg4)

💖 NAME 💖

object_message — sends a message to an object and returns the answer. It's part of the Allegro game programming library, bestie. 🎀

✨ SYNOPSIS ✨

#include <allegro.h>

int object_message(DIALOG *dialog, int msg, int c);

🦋 DESCRIPTION 🦋

Okay so picture this: you've got an object, and you wanna slide into its DMs. That's literally what this does — it sends a message to an object and hands you back the answer that object generated. No cap. 💅

Big important reminder though: the first parameter is the dialog object itself, not a whole array of them. Just the one. The singular. The main character. 👑

So like, say you want the second object in a dialog to draw itself — you'd write this:

object_message(&dialog[1], MSG_DRAW, 0);

And here's the cute lil bonus feature: if the message you're sending is MSG_DRAW, the function will take care of scaring and unscaring the mouse for you. It handles the whole mouse-vanishing act so you don't have to. Iconic behaviour, honestly. 🐭✨

🌈 SEE ALSO 🌈

• dialog_message(3alleg4)
• scare_mouse(3alleg4)
• scare_mouse_area(3alleg4)
• unscare_mouse(3alleg4)
• excustom(3alleg4)
• exrgbhsv(3alleg4)

k bye bestie, go send some messages 💜 this was Allegro version 4.4.3, and yeah the page is dated like that — it's the object_message(3alleg4) era, we stan a legacy queen 👑