XvQueryBestSize(3)

💖 XvQueryBestSize(3) 💖

okay bestie, welcome to XvQueryBestSize(3), a little gem from the libXv Functions lineup ✨ she's here to figure out the optimum drawable region size for you, and honestly? she ate.

---

🎀 NAME 🎀

XvQueryBestSize — determine the optimum drawable region size 👑

---

✨ SYNOPSIS ✨

#include <X11/extensions/Xvlib.h>

int XvQueryBestSize(Display *dpy, XvPort port, Bool motion,
                    unsigned int vw, unsigned int vh,
                    unsigned int dw, unsigned int dh,
                    unsigned int *p_dw, unsigned int *p_dh);

---

🌸 ARGUMENTS 🌸

• dpy — the connection to the X server. that's your link to the whole vibe, no cap.
• port — the port that's associated with the display and adaptor you want the optimum size calculated for 🫶
• motion — put True here if your destination size needs to support full motion, or False if it only needs to support still images. yes, it's giving "do I need to move or can I just pose" 💅
• vw,vh — the size of the source video region you want. literally the w and h of the source, bestie.
• dw,dh — the size of the destination drawable region you want. note: what you want and what you get are two different girls.
• p_dw,p_dh — pointers where the closest destination sizes supported by the server get returned. this is where the server writes back to you 🎀

---

🦋 DESCRIPTION 🦋

so here's the tea: some ports are able to scale incoming or outgoing video 🌈 not all of them, but some. iconic of them honestly.

XvQueryBestSize(3) returns the size of the closest destination region that is supported by the adaptor. and here's the important part, don't miss it — the returned size is guaranteed to be smaller than the requested size if a smaller size is supported. so if you asked for something too big, she'll hand you the closest smaller one that actually works. she's honest like that. no catfishing ✨

---

💜 RETURN VALUES 💜

• [Success] — returned if XvQueryBestSize(3) completed successfully. slay, we love a happy ending 🎉
• [XvBadExtension] — returned if the Xv extension is unavailable. sad. the extension ghosted you 😭
• [XvBadAlloc] — returned if XvQueryBestSize(3) failed to allocate memory to process the request. she tried, but the memory said no 💀

---

🍓 DIAGNOSTICS 🍓

• [XvBadPort] — generated if the requested port does not exist. like, who is she? we don't know her 🙈

ngl if you're seeing XvBadPort, double check that port, bestie. she's not in the building.

---

X Version 11 · libXv 1.0.13 · XvQueryBestSize(3)

and that's the whole page, fr fr 💖 go query your best size, queen — mwah 🎀✨🦋