XkbAllocGeomProps(3)

💅 XkbAllocGeomProps(3) — the XKB FUNCTIONS corner of the universe ✨

okay bestie, buckle up 🎀 this one lives in XKB FUNCTIONS and it's literally called XkbAllocGeomProps — yes it's a mouthful, yes it slays, no we're not renaming it 💖

---

🌸 NAME 🌸

XkbAllocGeomProps — allocate geometry properties 🫶

---

✨ SYNOPSIS ✨

Status XkbAllocGeomProps (XkbGeometryPtr geom, int num_needed);

that's the whole vibe check right there 👑

---

🦋 ARGUMENTS 🦋

• geom — the geometry that the properties should get allocated for, iykyk 🌈
• num_needed — how many new properties you're asking for, aka the count of fresh properties required 🍓

---

💜 DESCRIPTION 💜

so. Xkb hands you a whole lil collection of functions for allocating and freeing subcomponents of a keyboard geometry — think of it as the group chat of geometry-building tools 🧚 and you use these functions to create or modify keyboard geometries. periodt.

⚠️ important caveat, bestie, do NOT skip this: these functions merely allocate space for the new element(s). Actually filling in the values? That's on you, explicitly, in your own code. no cap. the allocator does not do it for you 😭

here's the sz_*/num_* lore, and it's giving main character energy:

• these allocation functions increase sz_* but never touch num_*
• unless there's an allocation failure — in which case they reset both sz_* and num_* to zero 💀
• they return Success if they succeed 🔥
• they return BadAlloc if they can't allocate space 🙈
• they return BadValue if a parameter isn't as expected ⭐

now for the star of the show: XkbAllocGeomProps allocates space for num_needed properties and adds them to the specified geometry geom 🎀 and ngl, no initialization of the properties is done — zero, none, nada.

so what even is a geometry property? a geometry property associates an arbitrary string with an equally arbitrary name 💅 highkey iconic. geometry properties can be used to provide hints to programs that display images of keyboards 👑 but plot twist: they are not interpreted by Xkb. and no other geometry structures refer to geometry properties. it's giving independent queen energy, fr fr 🌸

---

🔥 DIAGNOSTICS 🔥

• BadAlloc — unable to allocate storage 😭
• BadValue — an argument is out of range 💀

---

and that's the whole page, bestie 🫶 mwah 💖

made with love from X Version 11, libX11 1.8.14 ✨ bye slay 🌈