XkbAllocGeomShapes(3)

💖 XkbAllocGeomShapes(3) 💖

okay so bestie, you're on the XkbAllocGeomShapes(3) page from the XKB FUNCTIONS section — yes, we're doing geometry shape allocation today, and it's lowkey iconic. 🎀

🌸 NAME 🌸

XkbAllocGeomShapes — allocate space for an arbitrary number of geometry shapes. ✨

✨ SYNOPSIS ✨

Status XkbAllocGeomShapes (XkbGeometryPtr geom, int num_needed);

🫶 ARGUMENTS 🫶

• geom — the geometry for which shapes should be allocated. 💅
• num_needed — the number of new shapes required. 🔢

💜 DESCRIPTION 💜

okay so Xkb literally provides a number of functions to allocate and free subcomponents of a keyboard geometry. Use these functions to create or modify keyboard geometries. ✨

Important vibe check: these functions merely allocate space for the new element(s), and it is up to you to fill in the values explicitly in your code. They are not going to do the fill-in for you, bestie. 😭

These allocation functions increase sz_* but never touch num_* — unless there is an allocation failure, in which case they reset both sz_* and num_* to zero. 💀

These functions return Success if they succeed, BadAlloc if they are not able to allocate space, or BadValue if a parameter is not as expected. 👑

XkbAllocGeomShapes allocates space for num_needed shapes in the specified geometry geom. The shapes are not initialized. 🦋

To free geometry shapes, use XkbFreeGeomShapes. 🧚

🔥 DIAGNOSTICS 🔥

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

🌈 SEE ALSO 🌈

• XkbFreeGeomShapes(3) — your bestie for freeing those geometry shapes. 💖

---

mwah 💋 that's the page! footer sign-off: X Version 11, libX11 1.8.14, and XkbAllocGeomShapes(3) — source, version, and page/date slot, periodt. 🫶 (no separate date line was printed in the original footer, bestie.)