MAN page from PCLinuxOS libxv1-devel-1.0.1-3.pclo2005.mde.i586.rpm

XvQueryBestSize

Section: Misc. Reference Manual Pages (3x)
Updated: libXv 1.0.1
Index

Name

XvQueryBestSize - 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 theXv Server is to accept requests from Xv clients. If thedisplay option is not specified, Xv uses the display screenspecified by your DISPLAY environment variable. The displayoption has the format hostname:number. Using two colons(::) instead of one (:) indicates that DECnet is to be usedfor transport.
port: Defines the port associated with the display and adaptor for which the optimum size is to be calculated.
motion: Specifies True if the destination size needs to supportfull motion, and False if the destination size need onlysupport still images.
vw,vh: Specifies the size of the source video region desired.
dw,dh: Specifies the size of the destination drawable region desired.
p_dw,p_dh: Pointers to where the closest destination sizes supported by the server arereturned.

Description

Some ports may be able to scale incoming or outgoing video. XvQueryBestSize(3x) returns the size of the closest destinationregion that is supported by the adaptor. The returned size isguaranteed to be smaller than the requested size if a smaller size is supported.

Returned Values

[Success]: Returned if XvQueryBestSize(3x) completed successfully.
[XvBadExtension]: Returned if the Xv extension is unavailable.
[XvBadAlloc]: Returned if XvQueryBestSize(3x) failed to allocate memory to processthe request.

Diagnostics

[XvBadPort]: Generated if the requested port does not exist.

This document was created byman2html,using the manual pages.