1XvQueryBestSize(3)              libXv Functions             XvQueryBestSize(3)
2
3
4

NAME

6       XvQueryBestSize - determine the optimum drawable region size
7

SYNOPSIS

9       #include <X11/extensions/Xvlib.h>
10
11       int XvQueryBestSize(Display *dpy, XvPort port, Bool motion,
12                           unsigned int vw, unsigned int vh,
13                           unsigned int dw, unsigned int dh,
14                           unsigned int *p_dw, unsigned int *p_dh);
15

ARGUMENTS

17       dpy            Specifies the connection to the X server.
18
19       port           Defines the port associated with the display and adaptor
20                      for which the optimum size is to be calculated.
21
22       motion         Specifies True if the destination size needs to  support
23                      full motion, and False if the destination size need only
24                      support still images.
25
26       vw,vh          Specifies the size of the source video region desired.
27
28       dw,dh          Specifies the size of the  destination  drawable  region
29                      desired.
30
31       p_dw,p_dh      Pointers  to  where  the  closest destination sizes sup‐
32                      ported by the server are returned.
33

DESCRIPTION

35       Some  ports  may  be  able  to  scale  incoming  or   outgoing   video.
36       XvQueryBestSize(3)  returns  the size of the closest destination region
37       that is supported by the adaptor.  The returned size is  guaranteed  to
38       be smaller than the requested size if a smaller size is supported.
39

RETURN VALUES

41       [Success]
42               Returned if XvQueryBestSize(3) completed successfully.
43
44       [XvBadExtension]
45               Returned if the Xv extension is unavailable.
46
47       [XvBadAlloc]
48               Returned  if  XvQueryBestSize(3)  failed  to allocate memory to
49               process the request.
50

DIAGNOSTICS

52       [XvBadPort]
53               Generated if the requested port does not exist.
54
55
56
57X Version 11                     libXv 1.0.11               XvQueryBestSize(3)
Impressum