XvSetPortAttribute(3xv) libXv Functions XvSetPortAttribute(3xv)NAMEXvSetPortAttribute - sets an attribute of a video port
SYNOPSIS
cc [ flag... ] file... -lXv [ library... ]
#include <X11/extensions/Xvlib.h>
int XvSetPortAttribute(Display *dpy, XvPortID port,
Atom attribute, int value);
ARGUMENTS
dpy Specifies the connection to the X server.
port Specifies the port for which the attribute is to be
used.
attribute Identifies the port attribute to be set by this request.
Can be one of the table entries under the column
"String," below.
value Identifies the value to which attribute is to be set.
Can be one of the table entries under the column "Type,"
below.
DESCRIPTIONXvSetPortAttribute(3xv)
permits a client to set the port attribute to specified values. This
request supports the following values:
─────────────────────────────────────────────────────
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
The supplied encoding must be one of the encodings listed for the adap‐
tor, otherwise an Encoding error results.
If the adaptor does not support the exact hue, saturation, brightness,
and contrast levels supplied, the closest levels supported are assumed.
Use XvGetPortAttribute(3xv) to query the resulting levels.
When an XvSetPortAttribute(3xv) request is processed, a XvPortNo‐
tify(3xv) event is generated for all clients that have requested noti‐
fication of port changes using XvSelectPortNotify(3xv).
RETURN VALUES
[Success]
Returned if XvSetPortAttribute(3xv) completed successfully.
[XvBadExtension]
Returned if the Xv extension is unavailable.
[XvBadAlloc]
Returned if XvSelectVideoNotify(3xv) failed to allocate memory
to process the request.
DIAGNOSTICS
[XvBadPort]
Generated if the requested port does not exist.
[XvBadEncoding]
Generated if an encoding is specified that does not exist.
[BadMatch]
Generated if the requested attribute atom does not specify an
attribute supported by the adaptor.
SEE ALSOXvGetPortAttribute(3xv), XvQueryPortAttributes(3xv), XvSelectPortNo‐
tify(3xv), XvPortNotify(3xv)ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │x11/library/libxv │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Volatile │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │See XInitThreads(3X11) │
└─────────────────────────────┴─────────────────────────────┘
X Version 11 libXv 1.0.5 XvSetPortAttribute(3xv)
