XvQueryBestSize(3X)XvQueryBestSize(3X)NameXvQueryBestSize - determine the optimum drawable region
size
Syntax
#include <X11/extensions/Xvlib.h>
XvQueryBestSize(dpy, port, motion, vw, vh, dw, dh, p_dw,
p_dh)
Display *dpy;
XvPortID port;
Bool motion;
unsigned int vw, vh;
unsigned int dw, dh;
unsigned int *p_dw, *p_dh;
Arguments
dpy Specifies the display screen on which the
Xv Server is to accept requests from Xv
clients. If the display option is not
specified, Xv uses the display screen spec-
ified by your DISPLAY environment variable.
The display option has the format host-
name:number. Using two colons (::) instead
of one (:) indicates that DECnet is to be
used for transport.
port Defines the port associated with the dis-
play and adaptor for which the optimum size
is to be calculated.
motion Specifies True if the destination size
needs to support full motion, and False if
the destination size need only support
still images.
vw,vh Specifies the size of the source video
region desired.
dw,dh Specifies the size of the destination draw-
able region desired.
p_dw,p_dh Pointers to where the closest destination
sizes supported by the server are returned.
Description
Some ports may be able to scale incoming or outgoing
video. XvQueryBestSize(3X) returns the size of the clos-
est destination region that is supported by the adaptor.
The returned size is guaranteed to be smaller than the
requested size if a smaller size is supported.
1
XvQueryBestSize(3X)XvQueryBestSize(3X)Returned Values
[Success]
Returned if XvQueryBestSize(3X) completed success-
fully.
[XvBadExtension]
Returned if the Xv extension is unavailable.
[XvBadAlloc]
Returned if XvQueryBestSize(3X) failed to allocate
memory to process the request.
Diagnostics
[XvBadPort]
Generated if the requested port does not exist.
2