adime_d_edit_proc(3)

✨ adime_d_edit_proc ✨

okay bestie, welcome to the Adime API Reference 💖 this one is adime_d_edit_proc, living in section 3 of the manual, and it's literally the glow-up edition of an Allegro classic. let's get into it 🫶

🌸 SYNOPSIS 🌸

#include <adime.h>

int adime_d_edit_proc(int msg, DIALOG *d, int c)

💅 DESCRIPTION 💅

so adime_d_edit_proc() is exactly like Allegro's d_edit_proc(), bestie — same energy, same job — except it comes with that 3d-ish style. it's giving depth. it's giving dimension. ✨

⚠️ real talk though: that 3d border is three pixels wide, so you have to add those pixels to the size of the edit box. do not forget. i'm serious. your box will be cramped and sad and you will be sad too. 😭

and then there's the extra feature, which is the part where it gets iconic 👑

• the d->d1 field, if positive, is the maximal number of characters — just like with d_edit_proc(). same as always, no notes. 🎀
• but you may also set it to be negative 😳 and in that case, once you remove the sign, it means the maximal number of bytes occupied by the string, including the trailing zero.

and yes, that byte count may be different from the number of characters when you use Unicode — so keep that in mind, iykyk 🌈

🦋 tl;dr: 3d border, plus three pixels of width, plus a signed d->d1 that flips between counting characters and counting bytes. she contains multitudes.

that's the whole page, bestie — no cap, no filler, every single flag and field accounted for 💜

written for Adime, version 2.2.1 🌟 and filed away under adime_d_edit_proc(3) — slay, mwah, periodt 💅🎀