XPRESENT(3)

📦
version 1.0.2 · 2 versions
, in alpine 3.24, arch rolling, nixos 26.05, nixpkgs unstable

okay so bestie, this is XPRESENT(3) from X Version 11 — the X Present Extension manual page, and I’m gonna walk you through it like we’re in the group chat. 🫶✨

NAME 🌸

Xpresent — X Present Extension, periodt. 💅

SYNTAX 🦋

okay so here’s the include and the whole function lineup, exactly as written:

#include <X11/extensions/Xpresent.h>

Bool XPresentQueryExtension (Display *dpy, int *major_opcode_return,
     int *event_base_return, int *error_base_return);

Status XPresentQueryVersion (Display *dpy,
     int *major_version_return,
     int *minor_version_return);

int XPresentVersion (void);

ARGUMENTS 🎀

  • dpy — specifies the connection to the X server. That’s the whole argument list, bestie, no cap. 💜

DESCRIPTION ✨

Xpresent is a library designed to interface the X Present Extension. The Present extension gives applications a way to update their window contents from a pixmap in a well defined fashion — synchronizing with the display refresh and potentially using a more efficient mechanism than copying the contents of the source pixmap. It’s giving efficient. 🔥

XPresentQueryExtension is the vibe check: it checks if the X server specified by dpy supports the X Present extension. If the server does not support the extension, it returns False. If the server does support it, it returns True, and sets the values of major_opcode_return, event_base_return, and error_base_return if the pointers are not NULL. Slay. ✅

🚨 Important bestie rule: clients must call XPresentQueryExtension to verify the server supports the extension before calling any other function for this extension. No skipping the vibe check, okay? 😭

XPresentQueryVersion sets the values pointed to by major_version_return and minor_version_return to the version of the extension supported by the X server specified by dpy. Also, XPresentQueryVersion returns the version of the libXpresent library in use, as defined by the PRESENT_VERSION macro in <X11/extensions/Xpresent.h>. iykyk. 🧚

SEE ALSO 👀

the whole friend group:

RESTRICTIONS 🚧

compatibility tea: Xpresent will remain upward compatible after the 1.0 release. That’s the promise, bestie. ☕💫

AUTHORS 👑

  • Keith Packard, Intel

okay bye bestie — this iconic page is from libXpresent 1.0.2, dated 2022-08-27, manual XPRESENT(3). mwah 💋🎀

📦 where this page comes from