XkbPtrActionX(3)

✨ XkbPtrActionX ✨

okay bestie, welcome to the XkbPtrActionX page from the XKB FUNCTIONS manual. this one is short and iconic: it grabs the X coordinate out of an XkbPtrAction and hands it back as a signed int. 🎀

🌸 NAME 🌸

XkbPtrActionX — returns the high_XXX and low_XXX fields of act converted to a signed int. that's literally the whole job. ✨

🦋 SYNOPSIS 🦋

int XkbPtrActionX (XkbPtrAction act);

💜 ARGUMENTS 💜

• act — the action from which to extract X. that's your pointer-action struct, and we're pulling the X bits out of it. 🫶

🔥 DESCRIPTION 🔥

so actions associated with the XkbPtrAction structure move the pointer when keys are pressed and released. main character pointer behavior, no cap.

if the MouseKeys control is not enabled, KeyPress and KeyRelease events are treated as though the action is XkbSA_NoAction. like, the server looks at it and goes "nope, not today." 💀

if the MouseKeys control is enabled, a server action of type XkbSA_MovePtr tells the server to generate core pointer MotionNotify events instead of the usual KeyPress event. and the corresponding KeyRelease event disables any mouse keys timers that were created as a result of handling the XkbSA_MovePtr action. timers? cancelled. periodt. ✨

the type field of the XkbPtrAction structure is always XkbSA_MovePtr. always. no edge cases, bestie.

the flags field is a bitwise inclusive OR of the masks shown in Table 1. yes, flags are doing bit math, slay. 💅

🎀 Table 1 Pointer Action Types 🎀

columns are Action Type and Meaning, btw.

• XkbSA_NoAcceleration — if not set, and the MouseKeysAccel control is enabled, the KeyPress initiates a mouse keys timer for this key; every time the timer expires, the cursor moves. ⏲️
• XkbSA_MoveAbsoluteX — if set, the X portion of the structure specifies the new pointer X coordinate. otherwise, the X portion is added to the current pointer X coordinate to determine the new pointer X coordinate. 📍
• XkbSA_MoveAbsoluteY — if set, the Y portion of the structure specifies the new pointer Y coordinate. otherwise, the Y portion is added to the current pointer Y coordinate to determine the new pointer Y coordinate. 📍

each of the X and Y coordinates of the XkbPtrAction structure is composed of two signed 16-bit values. that is, the X coordinate is composed of high_XXX and low_XXX, and similarly for the Y coordinate. Xkb provides the following macros, to convert between a signed integer and two signed 16-bit values in XkbPtrAction structures. cute conversion moment. 🧚

👑 STRUCTURES 👑

           typedef struct _XkbPtrAction {
               unsigned char    type;         /* XkbSA_MovePtr */
               unsigned char    flags;        /* determines type of pointer motion */
               unsigned char    high_XXX;     /* x coordinate, high bits*/
               unsigned char    low_XXX;      /* y coordinate, low bits */
               unsigned char    high_YYY;     /* x coordinate, high bits */
               unsigned char    low_YYY;      /* y coordinate, low bits */
           } XkbPtrAction;

and that's the whole vibe. shoutout to the footer: this page comes from X Version 11, libX11 1.8.14. mwah. 💖