XvGetPortAttribute(3)

💖 XvGetPortAttribute — bestie edition 💖

okay so real talk, this is a page from libXv (the X Video extension library), and it's literally the XvGetPortAttribute(3) function. she's giving "let me peek at your port settings" energy and honestly? iconic. ✨

---

🌸 NAME 🌸

XvGetPortAttribute — returns the current value of a port attribute, no cap 💅

---

🎀 SYNOPSIS 🎀

#include <X11/extensions/Xvlib.h>

int XvGetPortAttribute(Display *dpy, XvPortID port,
                       Atom attribute, int p_value);

---

🦋 ARGUMENTS 🦋

• dpy — your connection to the X server. the whole vibe link, the group chat you're in 🫶
• port — the port, tied to that given display, whose attribute values are getting returned. specify her, she's the main character.
• attribute — an Atom that identifies which attribute this request is querying. bestie, you get control atoms using the XInternAtom request with a string from the table down below 👇
• p_value — pointer to the spot where the attribute value gets written on return. like, on the way back. that's where it lands. 💖

---

✨ DESCRIPTION ✨

XvGetPortAttribute(3) returns the current value of the requested port attribute in the integer pointed to by p_value. the attribute is identified using an Atom that equates to the attribute name. you can use the XInternAtom request with one of the strings below to get a matching Atom. slay.

so here's the whole lineup of attribute strings, what type they are, and their defaults — every single one, we're not skipping a single girl here:

• "XV_ENCODING" — Type: XvEncodingID — Default: Server dependent
• "XV_HUE" — Type: [-1000...1000] — Default: 0
• "XV_SATURATION" — Type: [-1000...1000] — Default: 0
• "XV_BRIGHTNESS" — Type: [-1000...1000] — Default: 0
• "XV_CONTRAST" — Type: [-1000...1000] — Default: 0

---

🌈 RETURN VALUES 🌈

• [Success] — returned if XvGetPortAttribute(3) completed successfully. we ate and left no crumbs 👑
• [XvBadExtension] — returned if the Xv extension is unavailable. she's not here, she's not coming 😭
• [XvBadAlloc] — returned if XvGetPortAttribute(3) failed to allocate memory to process the request. the budget did NOT stretch, bestie 💀

---

💜 DIAGNOSTICS 💜

• [XvBadPort] — generated if the requested port does not exist. bestie that port is a ghost, she's not real 🙈
• [BadMatch] — generated if the requested attribute atom does not specify an attribute supported by the adaptor. the vibe check failed, that attribute does not belong here 💅

---

🍓 SEE ALSO 🍓

• XvSetPortAttribute(3) — the "okay now we change it" girl
• XvPortNotify(3) — the "hey something changed" girl

---

okay that's the whole page, you're welcome 💖 this was X Version 11, libXv 1.0.13, so go forth and query those port attributes, bestie — periodt. 🌟🦋🎀