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

NAME

6       XvSetPortAttribute - sets an attribute of a video port
7

SYNOPSIS

9       #include <X11/extensions/Xvlib.h>
10
11       int XvSetPortAttribute(Display *dpy, XvPortID port,
12                              Atom attribute, int value);
13

ARGUMENTS

15       dpy            Specifies the connection to the X server.
16
17       port           Specifies  the  port  for  which  the attribute is to be
18                      used.
19
20       attribute      Identifies the port attribute to be set by this request.
21                      Can  be  one  of  the  table  entries  under  the column
22                      "String," below.
23
24       value          Identifies the value to which attribute is  to  be  set.
25                      Can be one of the table entries under the column "Type,"
26                      below.
27

DESCRIPTION

29       XvSetPortAttribute(3)
30        permits a client to set the port attribute to specified values.   This
31       request supports the following values:
32
33       ─────────────────────────────────────────────────────
34
35              Attribute String   Type             Default
36       ─────────────────────────────────────────────────────
37       "XV_ENCODING"      XvEncodingID     Server dependent
38       "XV_HUE"           [-1000...1000]   0
39       "XV_SATURATION"    [-1000...1000]   0
40       "XV_BRIGHTNESS"    [-1000...1000]   0
41       "XV_CONTRAST"      [-1000...1000]   0
42
43       The supplied encoding must be one of the encodings listed for the adap‐
44       tor, otherwise an Encoding error results.
45
46       If the adaptor does not support the exact hue, saturation,  brightness,
47       and contrast levels supplied, the closest levels supported are assumed.
48       Use XvGetPortAttribute(3) to query the resulting levels.
49
50       When an XvSetPortAttribute(3) request is processed,  a  XvPortNotify(3)
51       event  is generated for all clients that have requested notification of
52       port changes using XvSelectPortNotify(3).
53

RETURN VALUES

55       [Success]
56               Returned if XvSetPortAttribute(3) completed successfully.
57
58       [XvBadExtension]
59               Returned if the Xv extension is unavailable.
60
61       [XvBadAlloc]
62               Returned if XvSelectVideoNotify(3) failed to allocate memory to
63               process the request.
64

DIAGNOSTICS

66       [XvBadPort]
67               Generated if the requested port does not exist.
68
69       [XvBadEncoding]
70               Generated if an encoding is specified that does not exist.
71
72       [BadMatch]
73               Generated  if  the requested attribute atom does not specify an
74               attribute supported by the adaptor.
75

SEE ALSO

77       XvGetPortAttribute(3), XvQueryPortAttributes(3), XvSelectPortNotify(3),
78       XvPortNotify(3)
79
80
81
82X Version 11                     libXv 1.0.11            XvSetPortAttribute(3)
Impressum