brlapi_constants.h(3)

📦
version 6.8 · 9 versions
, in fedora 43, fedora 44, opensuse-leap 16.0

💖 NAME 💖

okay so bestie, welcome to brlapi_constants.h(3) — yeah, that's the one, straight out of the Library Functions Manual, section 3, the whole header-file situation. 🎀

That's literally the whole NAME situation: brlapi_constants.h. Iconic, minimal, no notes. ✨

✨ SYNOPSIS ✨

🌸 Macros 🌸

this header is a Macros situation — that's the synopsis vibe, that's what you're walking into. 🦋

Macros

like, that's it, that's the synopsis. the whole thing is macros. we love a consistent queen. 💅

don't go anywhere though — this page is a long one and it's coming at you in three parts, so this is just the lil opening moment. more is on the way, i promise. 🫶

okay so THIS is the part where the header file goes absolutely feral 💀 it's the big, beautiful, unhinged list of every single BRLAPI_KEY_CMD_* command macro in brlapi_constants.h, and honestly? iconic. main character energy. no notes.

quick vibe check before we dive: almost all of them are built on the BRLAPI_KEY_CMD() macro as BRLAPI_KEY_CMD(0) + <number>, so you can literally read the number as that command's little ID badge 🎫 — and the + 0 streak runs all the way from 0 to 158 before it changes gears. we are SO back.

first batch, the movement-adjacent crew 🦋 — + 0 through + 12:

#define BRLAPI_KEY_CMD_NOOP   (BRLAPI_KEY_CMD(0) + 0)
#define BRLAPI_KEY_CMD_LNUP   (BRLAPI_KEY_CMD(0) + 1)
#define BRLAPI_KEY_CMD_LNDN   (BRLAPI_KEY_CMD(0) + 2)
#define BRLAPI_KEY_CMD_WINUP   (BRLAPI_KEY_CMD(0) + 3)
#define BRLAPI_KEY_CMD_WINDN   (BRLAPI_KEY_CMD(0) + 4)
#define BRLAPI_KEY_CMD_PRDIFLN   (BRLAPI_KEY_CMD(0) + 5)
#define BRLAPI_KEY_CMD_NXDIFLN   (BRLAPI_KEY_CMD(0) + 6)
#define BRLAPI_KEY_CMD_ATTRUP   (BRLAPI_KEY_CMD(0) + 7)
#define BRLAPI_KEY_CMD_ATTRDN   (BRLAPI_KEY_CMD(0) + 8)
#define BRLAPI_KEY_CMD_TOP   (BRLAPI_KEY_CMD(0) + 9)
#define BRLAPI_KEY_CMD_BOT   (BRLAPI_KEY_CMD(0) + 10)
#define BRLAPI_KEY_CMD_TOP_LEFT   (BRLAPI_KEY_CMD(0) + 11)
#define BRLAPI_KEY_CMD_BOT_LEFT   (BRLAPI_KEY_CMD(0) + 12)

NOOP getting the very first slot at + 0 is so on brand — the name says it all and it still showed up first 👑 also hard agree that TOP_LEFT and BOT_LEFT got their own entries while their right-side besties had to wait until + 19 and + 20. we'll get there.

next up, the paragraph / prompt / search girlies plus the horizontal-and-vertical scroll squad, + 13 to + 28:

#define BRLAPI_KEY_CMD_PRPGRPH   (BRLAPI_KEY_CMD(0) + 13)
#define BRLAPI_KEY_CMD_NXPGRPH   (BRLAPI_KEY_CMD(0) + 14)
#define BRLAPI_KEY_CMD_PRPROMPT   (BRLAPI_KEY_CMD(0) + 15)
#define BRLAPI_KEY_CMD_NXPROMPT   (BRLAPI_KEY_CMD(0) + 16)
#define BRLAPI_KEY_CMD_PRSEARCH   (BRLAPI_KEY_CMD(0) + 17)
#define BRLAPI_KEY_CMD_NXSEARCH   (BRLAPI_KEY_CMD(0) + 18)
#define BRLAPI_KEY_CMD_CHRLT   (BRLAPI_KEY_CMD(0) + 19)
#define BRLAPI_KEY_CMD_CHRRT   (BRLAPI_KEY_CMD(0) + 20)
#define BRLAPI_KEY_CMD_HWINLT   (BRLAPI_KEY_CMD(0) + 21)
#define BRLAPI_KEY_CMD_HWINRT   (BRLAPI_KEY_CMD(0) + 22)
#define BRLAPI_KEY_CMD_FWINLT   (BRLAPI_KEY_CMD(0) + 23)
#define BRLAPI_KEY_CMD_FWINRT   (BRLAPI_KEY_CMD(0) + 24)
#define BRLAPI_KEY_CMD_FWINLTSKIP   (BRLAPI_KEY_CMD(0) + 25)
#define BRLAPI_KEY_CMD_FWINRTSKIP   (BRLAPI_KEY_CMD(0) + 26)
#define BRLAPI_KEY_CMD_LNBEG   (BRLAPI_KEY_CMD(0) + 27)
#define BRLAPI_KEY_CMD_LNEND   (BRLAPI_KEY_CMD(0) + 28)

okay the skip variants at + 25 and + 26 living right next to their non-skip versions? that's the sisters-with-different-personalities vibe and I'm obsessed 🫶

+ 29 to + 48 — this chunk is giving very much "settings menu that goes hard":

#define BRLAPI_KEY_CMD_HOME   (BRLAPI_KEY_CMD(0) + 29)
#define BRLAPI_KEY_CMD_BACK   (BRLAPI_KEY_CMD(0) + 30)
#define BRLAPI_KEY_CMD_RETURN   (BRLAPI_KEY_CMD(0) + 31)
#define BRLAPI_KEY_CMD_FREEZE   (BRLAPI_KEY_CMD(0) + 32)
#define BRLAPI_KEY_CMD_DISPMD   (BRLAPI_KEY_CMD(0) + 33)
#define BRLAPI_KEY_CMD_SIXDOTS   (BRLAPI_KEY_CMD(0) + 34)
#define BRLAPI_KEY_CMD_SLIDEWIN   (BRLAPI_KEY_CMD(0) + 35)
#define BRLAPI_KEY_CMD_SKPIDLNS   (BRLAPI_KEY_CMD(0) + 36)
#define BRLAPI_KEY_CMD_SKPBLNKWINS   (BRLAPI_KEY_CMD(0) + 37)
#define BRLAPI_KEY_CMD_CSRVIS   (BRLAPI_KEY_CMD(0) + 38)
#define BRLAPI_KEY_CMD_CSRHIDE   (BRLAPI_KEY_CMD(0) + 39)
#define BRLAPI_KEY_CMD_CSRTRK   (BRLAPI_KEY_CMD(0) + 40)
#define BRLAPI_KEY_CMD_CSRSIZE   (BRLAPI_KEY_CMD(0) + 41)
#define BRLAPI_KEY_CMD_CSRBLINK   (BRLAPI_KEY_CMD(0) + 42)
#define BRLAPI_KEY_CMD_ATTRVIS   (BRLAPI_KEY_CMD(0) + 43)
#define BRLAPI_KEY_CMD_ATTRBLINK   (BRLAPI_KEY_CMD(0) + 44)
#define BRLAPI_KEY_CMD_CAPBLINK   (BRLAPI_KEY_CMD(0) + 45)
#define BRLAPI_KEY_CMD_TUNES   (BRLAPI_KEY_CMD(0) + 46)
#define BRLAPI_KEY_CMD_AUTOREPEAT   (BRLAPI_KEY_CMD(0) + 47)
#define BRLAPI_KEY_CMD_AUTOSPEAK   (BRLAPI_KEY_CMD(0) + 48)

the VIS / HIDE / TRK / SIZE / BLINK run on the cursor stuff from + 38 to + 42 is genuinely so satisfying to look at, it's like a little gradient of features 🌈 and then ATTRVIS, ATTRBLINK, CAPBLINK continue the family business. TUNES at + 46 is just sitting there living its best life, love that for it 🎶

+ 49 to + 60 — menus, prefs, and the help desk ✨:

#define BRLAPI_KEY_CMD_HELP   (BRLAPI_KEY_CMD(0) + 49)
#define BRLAPI_KEY_CMD_INFO   (BRLAPI_KEY_CMD(0) + 50)
#define BRLAPI_KEY_CMD_LEARN   (BRLAPI_KEY_CMD(0) + 51)
#define BRLAPI_KEY_CMD_PREFMENU   (BRLAPI_KEY_CMD(0) + 52)
#define BRLAPI_KEY_CMD_PREFSAVE   (BRLAPI_KEY_CMD(0) + 53)
#define BRLAPI_KEY_CMD_PREFLOAD   (BRLAPI_KEY_CMD(0) + 54)
#define BRLAPI_KEY_CMD_MENU_FIRST_ITEM   (BRLAPI_KEY_CMD(0) + 55)
#define BRLAPI_KEY_CMD_MENU_LAST_ITEM   (BRLAPI_KEY_CMD(0) + 56)
#define BRLAPI_KEY_CMD_MENU_PREV_ITEM   (BRLAPI_KEY_CMD(0) + 57)
#define BRLAPI_KEY_CMD_MENU_NEXT_ITEM   (BRLAPI_KEY_CMD(0) + 58)
#define BRLAPI_KEY_CMD_MENU_PREV_SETTING   (BRLAPI_KEY_CMD(0) + 59)
#define BRLAPI_KEY_CMD_MENU_NEXT_SETTING   (BRLAPI_KEY_CMD(0) + 60)

not PREFMENU → PREFSAVE → PREFLOAD in a tidy + 52, + 53, + 54 row 😭 she said "open it, save it, load it" and the numbers agreed. periodt.

+ 61 to + 73 — the speech and paste zone, aka the loud chunk 🔊:

#define BRLAPI_KEY_CMD_MUTE   (BRLAPI_KEY_CMD(0) + 61)
#define BRLAPI_KEY_CMD_SPKHOME   (BRLAPI_KEY_CMD(0) + 62)
#define BRLAPI_KEY_CMD_SAY_LINE   (BRLAPI_KEY_CMD(0) + 63)
#define BRLAPI_KEY_CMD_SAY_ABOVE   (BRLAPI_KEY_CMD(0) + 64)
#define BRLAPI_KEY_CMD_SAY_BELOW   (BRLAPI_KEY_CMD(0) + 65)
#define BRLAPI_KEY_CMD_SAY_SLOWER   (BRLAPI_KEY_CMD(0) + 66)
#define BRLAPI_KEY_CMD_SAY_FASTER   (BRLAPI_KEY_CMD(0) + 67)
#define BRLAPI_KEY_CMD_SAY_SOFTER   (BRLAPI_KEY_CMD(0) + 68)
#define BRLAPI_KEY_CMD_SAY_LOUDER   (BRLAPI_KEY_CMD(0) + 69)
#define BRLAPI_KEY_CMD_SWITCHVT_PREV   (BRLAPI_KEY_CMD(0) + 70)
#define BRLAPI_KEY_CMD_SWITCHVT_NEXT   (BRLAPI_KEY_CMD(0) + 71)
#define BRLAPI_KEY_CMD_CSRJMP_VERT   (BRLAPI_KEY_CMD(0) + 72)
#define BRLAPI_KEY_CMD_PASTE   (BRLAPI_KEY_CMD(0) + 73)

the SAY_SLOWER / SAY_FASTER / SAY_SOFTER / SAY_LOUDER quartet at + 66 – + 69 is a whole mood board, it's literally SAY_ plus adjective four times in a row and I respect the commitment 💅

+ 74 to + 82 — restarts, offline mode, and the modifier keys get their moment 🧚:

#define BRLAPI_KEY_CMD_RESTARTBRL   (BRLAPI_KEY_CMD(0) + 74)
#define BRLAPI_KEY_CMD_RESTARTSPEECH   (BRLAPI_KEY_CMD(0) + 75)
#define BRLAPI_KEY_CMD_OFFLINE   (BRLAPI_KEY_CMD(0) + 76)
#define BRLAPI_KEY_CMD_SHIFT   (BRLAPI_KEY_CMD(0) + 77)
#define BRLAPI_KEY_CMD_UPPER   (BRLAPI_KEY_CMD(0) + 78)
#define BRLAPI_KEY_CMD_CONTROL   (BRLAPI_KEY_CMD(0) + 79)
#define BRLAPI_KEY_CMD_META   (BRLAPI_KEY_CMD(0) + 80)
#define BRLAPI_KEY_CMD_TIME   (BRLAPI_KEY_CMD(0) + 81)
#define BRLAPI_KEY_CMD_MENU_PREV_LEVEL   (BRLAPI_KEY_CMD(0) + 82)

SHIFT, UPPER, CONTROL, META lined up at + 77 – + 80? that's the keyboard-modifier friend group and they're all matching 👑 also TIME at + 81 right after META is such a random placement and honestly same, queen, keep everyone guessing.

+ 83 to + 88 — the ASPK block, short but mighty:

#define BRLAPI_KEY_CMD_ASPK_SEL_LINE   (BRLAPI_KEY_CMD(0) + 83)
#define BRLAPI_KEY_CMD_ASPK_SEL_CHAR   (BRLAPI_KEY_CMD(0) + 84)
#define BRLAPI_KEY_CMD_ASPK_INS_CHARS   (BRLAPI_KEY_CMD(0) + 85)
#define BRLAPI_KEY_CMD_ASPK_DEL_CHARS   (BRLAPI_KEY_CMD(0) + 86)
#define BRLAPI_KEY_CMD_ASPK_REP_CHARS   (BRLAPI_KEY_CMD(0) + 87)
#define BRLAPI_KEY_CMD_ASPK_CMP_WORDS   (BRLAPI_KEY_CMD(0) + 88)

six in a row, all ASPK_, all vibing in their own little six-slot lane at + 83 through + 88. consistency? she invented it 💖

+ 89 to + 101 — the SPEAK_ era begins, and it goes HARD:

#define BRLAPI_KEY_CMD_SPEAK_CURR_CHAR   (BRLAPI_KEY_CMD(0) + 89)
#define BRLAPI_KEY_CMD_SPEAK_PREV_CHAR   (BRLAPI_KEY_CMD(0) + 90)
#define BRLAPI_KEY_CMD_SPEAK_NEXT_CHAR   (BRLAPI_KEY_CMD(0) + 91)
#define BRLAPI_KEY_CMD_SPEAK_CURR_WORD   (BRLAPI_KEY_CMD(0) + 92)
#define BRLAPI_KEY_CMD_SPEAK_PREV_WORD   (BRLAPI_KEY_CMD(0) + 93)
#define BRLAPI_KEY_CMD_SPEAK_NEXT_WORD   (BRLAPI_KEY_CMD(0) + 94)
#define BRLAPI_KEY_CMD_SPEAK_CURR_LINE   (BRLAPI_KEY_CMD(0) + 95)
#define BRLAPI_KEY_CMD_SPEAK_PREV_LINE   (BRLAPI_KEY_CMD(0) + 96)
#define BRLAPI_KEY_CMD_SPEAK_NEXT_LINE   (BRLAPI_KEY_CMD(0) + 97)
#define BRLAPI_KEY_CMD_SPEAK_FRST_CHAR   (BRLAPI_KEY_CMD(0) + 98)
#define BRLAPI_KEY_CMD_SPEAK_LAST_CHAR   (BRLAPI_KEY_CMD(0) + 99)
#define BRLAPI_KEY_CMD_SPEAK_FRST_LINE   (BRLAPI_KEY_CMD(0) + 100)
#define BRLAPI_KEY_CMD_SPEAK_LAST_LINE   (BRLAPI_KEY_CMD(0) + 101)

THE PATTERN. CURR / PREV / NEXT three times over for char → word → line at + 89 through + 97, then the FRST / LAST bookends. it's a grid, bestie, someone sat down and DESIGNED this and I am unwell 😭 also we cracked triple digits at + 100, no cap, SPEAK_FRST_LINE at + 100 and SPEAK_LAST_LINE at + 101 is such a satisfying milestone moment 🎀

+ 102 to + 110 — descriptors, spelling, routing, locations, clipboard, and the braille toggles:

#define BRLAPI_KEY_CMD_DESC_CURR_CHAR   (BRLAPI_KEY_CMD(0) + 102)
#define BRLAPI_KEY_CMD_SPELL_CURR_WORD   (BRLAPI_KEY_CMD(0) + 103)
#define BRLAPI_KEY_CMD_ROUTE_CURR_LOCN   (BRLAPI_KEY_CMD(0) + 104)
#define BRLAPI_KEY_CMD_SPEAK_CURR_LOCN   (BRLAPI_KEY_CMD(0) + 105)
#define BRLAPI_KEY_CMD_SHOW_CURR_LOCN   (BRLAPI_KEY_CMD(0) + 106)
#define BRLAPI_KEY_CMD_CLIP_SAVE   (BRLAPI_KEY_CMD(0) + 107)
#define BRLAPI_KEY_CMD_CLIP_RESTORE   (BRLAPI_KEY_CMD(0) + 108)
#define BRLAPI_KEY_CMD_BRLUCDOTS   (BRLAPI_KEY_CMD(0) + 109)
#define BRLAPI_KEY_CMD_BRLKBD   (BRLAPI_KEY_CMD(0) + 110)

ROUTE_CURR_LOCN, SPEAK_CURR_LOCN, SHOW_CURR_LOCN back to back at + 104, + 105, + 106 — route it, say it, show it. the whole workflow in three consecutive numbers and honestly? that's the kind of coherence I need in my life 🦋

+ 111 to + 119 — the stop/start control panel:

#define BRLAPI_KEY_CMD_UNSTICK   (BRLAPI_KEY_CMD(0) + 111)
#define BRLAPI_KEY_CMD_ALTGR   (BRLAPI_KEY_CMD(0) + 112)
#define BRLAPI_KEY_CMD_GUI   (BRLAPI_KEY_CMD(0) + 113)
#define BRLAPI_KEY_CMD_BRL_STOP   (BRLAPI_KEY_CMD(0) + 114)
#define BRLAPI_KEY_CMD_BRL_START   (BRLAPI_KEY_CMD(0) + 115)
#define BRLAPI_KEY_CMD_SPK_STOP   (BRLAPI_KEY_CMD(0) + 116)
#define BRLAPI_KEY_CMD_SPK_START   (BRLAPI_KEY_CMD(0) + 117)
#define BRLAPI_KEY_CMD_SCR_STOP   (BRLAPI_KEY_CMD(0) + 118)
#define BRLAPI_KEY_CMD_SCR_START   (BRLAPI_KEY_CMD(0) + 119)

BRL / SPK / SCR × STOP / START — six entries in a perfect stop-then-start sandwich, + 114 to + 119. chef's kiss, no crumbs 🍓

and then the finale of the BRLAPI_KEY_CMD(0) saga — + 120 all the way to + 158, aka the GUI era:

#define BRLAPI_KEY_CMD_SELECTVT_PREV   (BRLAPI_KEY_CMD(0) + 120)
#define BRLAPI_KEY_CMD_SELECTVT_NEXT   (BRLAPI_KEY_CMD(0) + 121)
#define BRLAPI_KEY_CMD_PRNBWIN   (BRLAPI_KEY_CMD(0) + 122)
#define BRLAPI_KEY_CMD_NXNBWIN   (BRLAPI_KEY_CMD(0) + 123)
#define BRLAPI_KEY_CMD_TOUCH_NAV   (BRLAPI_KEY_CMD(0) + 124)
#define BRLAPI_KEY_CMD_SPEAK_INDENT   (BRLAPI_KEY_CMD(0) + 125)
#define BRLAPI_KEY_CMD_ASPK_INDENT   (BRLAPI_KEY_CMD(0) + 126)
#define BRLAPI_KEY_CMD_REFRESH   (BRLAPI_KEY_CMD(0) + 127)
#define BRLAPI_KEY_CMD_INDICATORS   (BRLAPI_KEY_CMD(0) + 128)
#define BRLAPI_KEY_CMD_TXTSEL_CLEAR   (BRLAPI_KEY_CMD(0) + 129)
#define BRLAPI_KEY_CMD_TXTSEL_ALL   (BRLAPI_KEY_CMD(0) + 130)
#define BRLAPI_KEY_CMD_HOST_COPY   (BRLAPI_KEY_CMD(0) + 131)
#define BRLAPI_KEY_CMD_HOST_CUT   (BRLAPI_KEY_CMD(0) + 132)
#define BRLAPI_KEY_CMD_HOST_PASTE   (BRLAPI_KEY_CMD(0) + 133)
#define BRLAPI_KEY_CMD_GUI_TITLE   (BRLAPI_KEY_CMD(0) + 134)
#define BRLAPI_KEY_CMD_GUI_BRL_ACTIONS   (BRLAPI_KEY_CMD(0) + 135)
#define BRLAPI_KEY_CMD_GUI_HOME   (BRLAPI_KEY_CMD(0) + 136)
#define BRLAPI_KEY_CMD_GUI_BACK   (BRLAPI_KEY_CMD(0) + 137)
#define BRLAPI_KEY_CMD_GUI_DEV_SETTINGS   (BRLAPI_KEY_CMD(0) + 138)
#define BRLAPI_KEY_CMD_GUI_DEV_OPTIONS   (BRLAPI_KEY_CMD(0) + 139)
#define BRLAPI_KEY_CMD_GUI_APP_LIST   (BRLAPI_KEY_CMD(0) + 140)
#define BRLAPI_KEY_CMD_GUI_APP_MENU   (BRLAPI_KEY_CMD(0) + 141)
#define BRLAPI_KEY_CMD_GUI_APP_ALERTS   (BRLAPI_KEY_CMD(0) + 142)
#define BRLAPI_KEY_CMD_GUI_AREA_ACTV   (BRLAPI_KEY_CMD(0) + 143)
#define BRLAPI_KEY_CMD_GUI_AREA_PREV   (BRLAPI_KEY_CMD(0) + 144)
#define BRLAPI_KEY_CMD_GUI_AREA_NEXT   (BRLAPI_KEY_CMD(0) + 145)
#define BRLAPI_KEY_CMD_GUI_ITEM_FRST   (BRLAPI_KEY_CMD(0) + 146)
#define BRLAPI_KEY_CMD_GUI_ITEM_PREV   (BRLAPI_KEY_CMD(0) + 147)
#define BRLAPI_KEY_CMD_GUI_ITEM_NEXT   (BRLAPI_KEY_CMD(0) + 148)
#define BRLAPI_KEY_CMD_GUI_ITEM_LAST   (BRLAPI_KEY_CMD(0) + 149)
#define BRLAPI_KEY_CMD_SAY_LOWER   (BRLAPI_KEY_CMD(0) + 150)
#define BRLAPI_KEY_CMD_SAY_HIGHER   (BRLAPI_KEY_CMD(0) + 151)
#define BRLAPI_KEY_CMD_SAY_ALL   (BRLAPI_KEY_CMD(0) + 152)
#define BRLAPI_KEY_CMD_CONTRACTED   (BRLAPI_KEY_CMD(0) + 153)
#define BRLAPI_KEY_CMD_COMPBRL6   (BRLAPI_KEY_CMD(0) + 154)
#define BRLAPI_KEY_CMD_PREFRESET   (BRLAPI_KEY_CMD(0) + 155)
#define BRLAPI_KEY_CMD_ASPK_EMP_LINE   (BRLAPI_KEY_CMD(0) + 156)
#define BRLAPI_KEY_CMD_SPK_PUNCT_LEVEL   (BRLAPI_KEY_CMD(0) + 157)
#define BRLAPI_KEY_CMD_PASTE_ALTMODE   (BRLAPI_KEY_CMD(0) + 158)

GUI_ this and GUI_ that from + 134 to + 149 — sixteen whole slots, she really said "the GUI gets a wing" 🏛️ and the AREA_ACTV / AREA_PREV / AREA_NEXT then ITEM_FRST / ITEM_PREV / ITEM_NEXT / ITEM_LAST run is so orderly it healed something in me. also ASPK_EMP_LINE at + 156 and SPK_PUNCT_LEVEL at + 157 right before the very last one? little epilogue energy. 💜

okay so after + 158, the numbering scheme straight up switches lanes and we get macros that call BRLAPI_KEY_CMD() with an actual argument instead of 0 — and some of them are straight-up aliases of each other (same value, two names, we love a double). watch:

#define BRLAPI_KEY_CMD_ROUTE   BRLAPI_KEY_CMD(1)
#define BRLAPI_KEY_CMD_CLIP_NEW   BRLAPI_KEY_CMD(2)
#define BRLAPI_KEY_CMD_CUTBEGIN   BRLAPI_KEY_CMD(2)
#define BRLAPI_KEY_CMD_CLIP_ADD   BRLAPI_KEY_CMD(3)
#define BRLAPI_KEY_CMD_CUTAPPEND   BRLAPI_KEY_CMD(3)
#define BRLAPI_KEY_CMD_COPY_RECT   BRLAPI_KEY_CMD(4)
#define BRLAPI_KEY_CMD_CUTRECT   BRLAPI_KEY_CMD(4)
#define BRLAPI_KEY_CMD_COPY_LINE   BRLAPI_KEY_CMD(5)
#define BRLAPI_KEY_CMD_CUTLINE   BRLAPI_KEY_CMD(5)

do you see it 👀 CLIP_NEW and CUTBEGIN both live at BRLAPI_KEY_CMD(2). CLIP_ADD and CUTAPPEND are both BRLAPI_KEY_CMD(3). COPY_RECT / CUTRECT share BRLAPI_KEY_CMD(4), and COPY_LINE / CUTLINE share BRLAPI_KEY_CMD(5). they're the same value wearing two different outfits and honestly that's the most relatable thing in this entire header — one function, two names, depending on what mood you're in 💅✨

and BRLAPI_KEY_CMD_ROUTE sitting all alone at BRLAPI_KEY_CMD(1), first of the new regime, no alias buddy, just vibing. we respect the independence 🫶

...and there's more coming, so don't go anywhere 😭🔥

Like, buckle up bestie, because this is the part where the #defines just keep coming and honestly? They ate. 💅 Everything below is verbatim, so if you're copy-pasting, copy-paste it exactly, okay? No "fixing" the hex, no lowercase-ing the X. 🫶

💫 the key command macros (the sequel)

#define BRLAPI_KEY_CMD_SWITCHVT   BRLAPI_KEY_CMD(6)
#define BRLAPI_KEY_CMD_PRINDENT   BRLAPI_KEY_CMD(7)
#define BRLAPI_KEY_CMD_NXINDENT   BRLAPI_KEY_CMD(8)
#define BRLAPI_KEY_CMD_DESCCHAR   BRLAPI_KEY_CMD(9)
#define BRLAPI_KEY_CMD_SETLEFT   BRLAPI_KEY_CMD(10)
#define BRLAPI_KEY_CMD_SETMARK   BRLAPI_KEY_CMD(11)
#define BRLAPI_KEY_CMD_GOTOMARK   BRLAPI_KEY_CMD(12)
#define BRLAPI_KEY_CMD_GOTOLINE   BRLAPI_KEY_CMD(13)
#define BRLAPI_KEY_CMD_PRDIFCHAR   BRLAPI_KEY_CMD(14)
#define BRLAPI_KEY_CMD_NXDIFCHAR   BRLAPI_KEY_CMD(15)
#define BRLAPI_KEY_CMD_CLIP_COPY   BRLAPI_KEY_CMD(16)
#define BRLAPI_KEY_CMD_COPYCHARS   BRLAPI_KEY_CMD(16)
#define BRLAPI_KEY_CMD_CLIP_APPEND   BRLAPI_KEY_CMD(17)
#define BRLAPI_KEY_CMD_APNDCHARS   BRLAPI_KEY_CMD(17)
#define BRLAPI_KEY_CMD_PASTE_HISTORY   BRLAPI_KEY_CMD(18)
#define BRLAPI_KEY_CMD_SET_TEXT_TABLE   BRLAPI_KEY_CMD(19)
#define BRLAPI_KEY_CMD_SET_ATTRIBUTES_TABLE   BRLAPI_KEY_CMD(20)
#define BRLAPI_KEY_CMD_SET_CONTRACTION_TABLE   BRLAPI_KEY_CMD(21)
#define BRLAPI_KEY_CMD_SET_KEYBOARD_TABLE   BRLAPI_KEY_CMD(22)
#define BRLAPI_KEY_CMD_SET_LANGUAGE_PROFILE   BRLAPI_KEY_CMD(23)
#define BRLAPI_KEY_CMD_ROUTE_LINE   BRLAPI_KEY_CMD(24)
#define BRLAPI_KEY_CMD_REFRESH_LINE   BRLAPI_KEY_CMD(25)
#define BRLAPI_KEY_CMD_TXTSEL_START   BRLAPI_KEY_CMD(26)
#define BRLAPI_KEY_CMD_TXTSEL_SET   BRLAPI_KEY_CMD(27)
#define BRLAPI_KEY_CMD_ROUTE_SPEECH   BRLAPI_KEY_CMD(28)
#define BRLAPI_KEY_CMD_PASTE_HISTORY_ALTMODE   BRLAPI_KEY_CMD(29)
#define BRLAPI_KEY_CMD_SELECTVT   BRLAPI_KEY_CMD(30)
#define BRLAPI_KEY_CMD_ALERT   BRLAPI_KEY_CMD(31)
#define BRLAPI_KEY_CMD_PASSDOTS   BRLAPI_KEY_CMD(34)
#define BRLAPI_KEY_CMD_PASSAT   BRLAPI_KEY_CMD(35)
#define BRLAPI_KEY_CMD_PASSXT   BRLAPI_KEY_CMD(36)
#define BRLAPI_KEY_CMD_PASSPS2   BRLAPI_KEY_CMD(37)
#define BRLAPI_KEY_CMD_CONTEXT   BRLAPI_KEY_CMD(38)
#define BRLAPI_KEY_CMD_TOUCH_AT   BRLAPI_KEY_CMD(39)
#define BRLAPI_KEY_CMD_MACRO   BRLAPI_KEY_CMD(40)
#define BRLAPI_KEY_CMD_HOSTCMD   BRLAPI_KEY_CMD(41)

okay bestie, real talk: notice how BRLAPI_KEY_CMD_CLIP_COPY and BRLAPI_KEY_CMD_COPYCHARS are both BRLAPI_KEY_CMD(16)? Same energy as CLIP_APPEND and APNDCHARS both sitting at 17 — they're twins, two names, one number, no drama. 👯‍♀️ And yes, we jump from 31 straight to 34. Where are 32 and 33? Not here. Not our problem. Moving on. 💀

🔥 toggle + motion flags

#define BRLAPI_KEY_FLG_TOGGLE_ON   BRLAPI_KEY_FLG(0X0100)
#define BRLAPI_KEY_FLG_TOGGLE_OFF   BRLAPI_KEY_FLG(0X0200)
#define BRLAPI_KEY_FLG_TOGGLE_MASK   (BRLAPI_KEY_FLG_TOGGLE_ON |
    BRLAPI_KEY_FLG_TOGGLE_OFF)
#define BRLAPI_KEY_FLG_MOTION_ROUTE   BRLAPI_KEY_FLG(0X0400)
#define BRLAPI_KEY_FLG_MOTION_SCALED   BRLAPI_KEY_FLG(0X0800)
#define BRLAPI_KEY_FLG_MOTION_TOLEFT   BRLAPI_KEY_FLG(0X1000)

That BRLAPI_KEY_FLG_TOGGLE_MASK is literally just the on and the off OR'd together, and it's giving bundled. Note the 0X is a capital X and I'm not apologising for it. ✨

🎀 modifier + keyboard flags

#define BRLAPI_KEY_FLG_SHIFT   BRLAPI_KEY_FLG(0X01)
#define BRLAPI_KEY_FLG_UPPER   BRLAPI_KEY_FLG(0X02)
#define BRLAPI_KEY_FLG_CONTROL   BRLAPI_KEY_FLG(0X04)
#define BRLAPI_KEY_FLG_META   BRLAPI_KEY_FLG(0X08)
#define BRLAPI_KEY_FLG_ALTGR   BRLAPI_KEY_FLG(0X10)
#define BRLAPI_KEY_FLG_GUI   BRLAPI_KEY_FLG(0X20)
#define BRLAPI_KEY_FLG_ESCAPED   BRLAPI_KEY_FLG(0X40)
#define BRLAPI_KEY_FLG_CAPSLOCK   BRLAPI_KEY_FLG(0X80)
#define BRLAPI_KEY_FLG_KBD_RELEASE   BRLAPI_KEY_FLG(0X0100)
#define BRLAPI_KEY_FLG_KBD_EMUL0   BRLAPI_KEY_FLG(0X0200)
#define BRLAPI_KEY_FLG_KBD_EMUL1   BRLAPI_KEY_FLG(0X0400)

ngl these are the little bit-flags that make the whole thing go brrr — SHIFT, UPPER, CONTROL, META, ALTGR, GUI, ESCAPED, CAPSLOCK, KBD_RELEASE, KBD_EMUL0, KBD_EMUL1. And yeah 🫶, 0X0100, 0X0200 and 0X0400 show up again here — same values as over in the toggle/motion group, because that's just how the bit budget shook out. Don't @ me, it's literally what the file says.

🦋 the braille dot bits (the main character section)

#define BRLAPI_DOT1   1
#define BRLAPI_DOT2   2
#define BRLAPI_DOT3   4
#define BRLAPI_DOT4   8
#define BRLAPI_DOT5   16
#define BRLAPI_DOT6   32
#define BRLAPI_DOT7   64
#define BRLAPI_DOT8   128
#define BRLAPI_DOTC   256
#define BRLAPI_DOTS(dot1,  dot2,  dot3,  dot4,  dot5,  dot6,  dot7,
    dot8)
#define BRLAPI_DOT_CHORD   256

BRLAPI_DOT1 through BRLAPI_DOT8 are 1, 2, 4, 8, 16, 32, 64, 128 — one bit per dot, each one doubling, which is honestly so satisfying to look at. 🎀 Then BRLAPI_DOTC is 256, and hey, so is BRLAPI_DOT_CHORD. Same value, two names, iconic behaviour. 💖

And BRLAPI_DOTS(dot1, dot2, dot3, dot4, dot5, dot6, dot7, dot8) — eight params, comma-separated, wrapped onto a second line after dot7,. Keep the spacing exactly as it is if you're typing it out by hand: dot1, dot2, dot3, dot4, dot5, dot6, dot7, has those double spaces and yes, they're part of the vibe. 🙈

✨ Author ✨

Generated automatically by Doxygen for BrlAPI from the source code.

No cap, nobody sat down and hand-wrote this — Doxygen just did its thing and we respect the hustle. 👑

💜 Friendly reminder bestie: these are #defines, so they're literal. Don't renumber them, don't lowercase the 0X, don't "clean up" the line breaks. Copy-paste is your bestie here. fr fr.

🌸 ok that's the whole page, we made it, everybody clap 🌸 — this adorable chaos came straight from BrlAPI, Version 0.8, on the page literally named brlapi_constants.h(3). Now go define some constants, you absolute icon. 💅🎀🦋⭐

📦 where this page comes from