XkbAllocGeomOutlines(3)

📦
version 1.8.14 · 8 versions
, in alpine 3.24, arch rolling, nixos 26.05, nixpkgs unstable

🎀 NAME 🎀

XkbAllocGeomOutlines(3) from XKB FUNCTIONS is here to allocate space for an arbitrary number of outlines to a shape. Okay bestie, this is the geometry-allocation corner of libX11, and it’s lowkey iconic. 💅

✨ SYNOPSIS ✨

Status XkbAllocGeomOutlines (XkbShapePtr shape, int num_needed);

💖 ARGUMENTS 💖

  • shape — the shape for which outlines should be allocated.
  • num_needed — the number of new outlines required. Yes, exactly that many. 🔥

🌸 DESCRIPTION 🌸

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

Real talk: 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. 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. Periodt. 💀

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.

XkbAllocGeomOutlines allocates space for num_needed outlines in the specified shape. The outlines are not initialized.

⚠️ Not initialized means not initialized, bestie — you gotta fill in the values explicitly in your code. No cap.

To free geometry outlines, use XkbFreeGeomOutlines.

🔥 DIAGNOSTICS 🔥

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

🫶 SEE ALSO 🫶

k bye bestie 💜 — sign-off brought to you by X Version 11, libX11 1.8.14, and the footer tag XkbAllocGeomOutlines(3). That’s the whole page, and it ate. ✨🌸

📦 where this page comes from