Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

xvquerybestsize(3x) [redhat man page]

XvQueryBestSize(3X)													       XvQueryBestSize(3X)

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 the Xv Server is to accept requests from Xv clients.  If the display option is not
		      specified, Xv uses the display screen specified by your DISPLAY environment variable.  The display  option  has  the  format
		      hostname:number.	Using two colons (::) instead of one (:) indicates that DECnet is to be used for 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 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 drawable 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 closest 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.

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 process the request.

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

XFree86 						       Version Version 4.3.0					       XvQueryBestSize(3X)

Check Out this Related Man Page

XvQueryBestSize(3)                                                libXv Functions                                               XvQueryBestSize(3)

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            Specifies the connection to the X server.

       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 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 drawable 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(3) returns the size of the closest 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.

RETURN VALUES

       [Success]
               Returned if XvQueryBestSize(3) completed successfully.

       [XvBadExtension]
               Returned if the Xv extension is unavailable.

       [XvBadAlloc]
               Returned if XvQueryBestSize(3) failed to allocate memory to process the request.

DIAGNOSTICS

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

X Version 11                                                        libXv 1.0.7                                                 XvQueryBestSize(3)
Man Page