XvPortNotify(3)

📦
version 1.0.13 · 3 versions
, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, fedora 43, fedora 44, ubuntu resolute, ubuntu stonking

💖 XvPortNotify(3) 💖

okay bestie, welcome to XvPortNotify — one of the libXv Functions, and today's topic is the lil glow-up notification your X server sends when a port attribute changes. it's giving "your fave posted, go look" energy. 🦋

🌸 NAME 🌸

XvPortNotify — the event that gets generated when port attributes change. yes literally that's the whole vibe. ✨

✨ SYNOPSIS ✨

first, the include, because we always start with the include:

#include <X11/extensions/Xvlib.h>

then, the union that holds all the Xv events together (it's a friend group, they all live in one union):

     typedef union {
       int type;
       XvVideoNotifyEvent xvvideo;
       XvPortNotifyEvent xvport;
       long pad[24];
     } XvEvent;

and here's the actual star of the show, the struct, in all its glory:

     typedef struct {
       int type;
       unsigned long serial;
       Bool send_event;
       Display *display;
       XvPortID port_id;
       Time time;
       Atom attribute;
       long value;
     } XvPortNotifyEvent;

okay now let's do a field-by-field vibe check, because every single one matters 👑

  • type — tells you what kind of event this is: XvPortNotify. that's the ID, that's the name tag. 🎀
  • serial — the number of the last request the server processed. it's like the receipt number bestie, lowkey useful.
  • send_event — True if this event was generated by a SendEvent request. so, was it organic or was it sent? 🙈
  • display — a pointer to the display this event was read from. yes, the whole display, a pointer to it. 💅
  • port_id — the port whose attribute has changed. the main character of this whole situation. 👑
  • attribute — an atom specifying which attribute changed. like, which thing got tweaked. 🔥
  • value — the new value of that attribute. the after pic. ✨

🌈 DESCRIPTION 🌈

so here's the tea 🍓 — XvPortNotify events get generated when a port attribute is set using the XvSetPortAttribute(3) function.

that's it. that's the whole mechanism. someone sets an attribute with XvSetPortAttribute(3), and boom 💥, a XvPortNotify event shows up to tell you about it. no cap.

🫶 SEE ALSO 🫶

go read these next, they're the besties of this page:

and that's the whole page bestie, you ate it 💅✨ mwah 🎀

this lil number comes to you from X Version 11, specifically libXv 1.0.13 — stay hydrated, read your man pages, and i'll see you in the next one 🦋💖

📦 where this page comes from