S3D_SET_CALLBACK(3)

💖 S3D_SET_CALLBACK 💖

okay bestie, gather round, we're doing the s3d manual today (yes, the whole manual name, it's giving ✨official✨) and this one is genuinely one of my faves because it's all about callbacks 🎀

🌸 NAME 🌸

s3d_set_callback — sets a callback 🫶

like. that's the whole job. it sets a callback. iconic behaviour honestly.

✨ SYNOPSIS ✨

#include <s3d.h>

void s3d_set_callback(uint8_t event, s3d_cb func);

🦋 DESCRIPTION 🦋

So what this does is it sets a callback for a certain event. and like… that's so useful if you're building an event-oriented application, fr fr. you just go "hey s3d, when this happens, run this function for me" and it does. no cap.

One thing you gotta know though: event callbacks will not interrupt each other, and they will not interrupt the mainloop. so no chaos, no stepping on each other's toes, everyone waits their turn like civilized little functions 💅

⚠️ Warning ⚠️ Defining callbacks will only work after calling s3d_init(). do not skip that step, i am begging you. no s3d_init(), no callbacks. periodt.

and here's the lil example they gave us, keep it, love it, it's literally the blueprint:

#include <inttypes.h>

void obj_click(struct s3d_evt event)
{
        printf("object id %"PRIu32" got clicked", *((uint32_t *)event->buf));
}
...
s3d_set_callback(S3D_EVENT_NEW_OBJECT, obj_click);
// this will tell you when a object got clicked

see that? S3D_EVENT_NEW_OBJECT + your function = it will tell you when a object got clicked. that's it. that's the vibe check and it passed 🔥

👑 AUTHOR 👑

Simon Wunderlich Author of s3d 🌈

like, the actual author. the main character. we stan. 🫶

and that's a wrap on this one!! the s3d manual, page S3D_SET_CALLBACK(3) — catch you in the next one bestie 💜✨🌸