


XvGetPortAttribute(3X)			   XvGetPortAttribute(3X)


Name
       XvGetPortAttribute - return current port attribute value

Syntax
       #include <X11/extensions/Xvlib.h>

       XvGetPortAttribute(dpy, port, attribute, p_value)

       Display *dpy;
       XvPortID port;
       Atom attribute;
       int *p_value;


Arguments
       dpy     Specifies the display screen on which the X Server
	       is to accept requests from X clients.  If the dis
	       play  option  is not specified, X uses the display
	       screen specified by your DISPLAY environment vari
	       able.   The  display  option  has the format host
	       name:number.  Using two colons (::) instead of one
	       (:) indicates that DECnet is to be used for trans
	       port.

       port    Specifies the port, associated with the given dis
	       play,  for  which  the  attribute values are to be
	       returned.

       attribute
	       An  atom	 that  identifies  the	attribute  to  be
	       queried	 by  this  request.   Control  atoms  are
	       obtained using  the  XInternAtom	 request  with	a
	       string from the following table.

       p_value Pointer	to the location where the attribute value
	       is written on return.

Description
       XvGetPortAttribute(3X) returns the current  value  of  the
       requested  port	attribute  in  the  integer pointed to by
       p_value.	 The attribute is identified using an  Atom  that
       equates	to  the	 attribute name.  The XInternAtom request
       can be used with one of the  strings  below  to	return	a
       matching Atom.













XFree86			  Version 4.8.0				1





XvGetPortAttribute(3X)			   XvGetPortAttribute(3X)


       Attribute String	       Type		Default

       "XV_ENCODING"	       XvEncodingID	Server dependent
       "XV_HUE"		       [-1000...1000]	0
       "XV_SATURATION"	       [-1000...1000]	0
       "XV_BRIGHTNESS"	       [-1000...1000]	0
       "XV_CONTRAST"	       [-1000...1000]	0

Returned Values
       [Success]
	       Returned	 if XvGetPortAttribute(3X) completed suc
	       cessfully.

       [XvBadExtension]
	       Returned if the Xv extension is unavailable.

       [XvBadAlloc]
	       Returned if XvGetPortAttribute(3X) failed to allo
	       cate memory to process the request.

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

       [BadMatch]
	       Generated if the requested attribute atom does not
	       specify an attribute supported by the adaptor.

See Also
       XvSetPortAttribute(3X), XvPortNotify(3X)



























XFree86			  Version 4.8.0				2


