sync code with last improvements from OpenBSD

lib/libXv/man/XvSetPortAttribute.man

@@ -0,0 +1,90 @@
+'\" t
+.TH XvSetPortAttribute __libmansuffix__  __vendorversion__ "libXv Functions"
+.SH NAME
+XvSetPortAttribute \- sets an attribute of a video port
+.\"
+.SH SYNOPSIS
+.B #include <X11/extensions/Xvlib.h>
+.sp
+.nf
+.BI "int XvSetPortAttribute(Display *" dpy ", XvPortID " port ","
+.BI "                       Atom " attribute ", int " value ");"
+.fi
+.SH ARGUMENTS
+.\"
+.IP \fIdpy\fR 15
+Specifies the connection to the X server.
+.IP \fIport\fR 15
+Specifies the port for which the attribute is to be used.
+.IP \fIattribute\fR 15
+Identifies the port attribute to be set by this request.
+Can be one of the table entries under the column "String," below.
+.IP \fIvalue\fR 15
+Identifies the value to which \fIattribute\fP is to be set.
+Can be one of the table entries under the column "Type," below.
+.\"
+.SH DESCRIPTION
+.BR XvSetPortAttribute (__libmansuffix__)
+ permits a client to set the port attribute
+to specified values.  This request supports the following values:
+.PP
+.TS
+tab(@);
+lfHB lfHB lfHB
+lfR  lfR  lfR .
+_
+.PP
+.sp 4p
+Attribute String@Type@Default
+.sp 6p
+_
+.sp 6p
+"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
+.sp 6p
+.TE
+.PP
+The supplied encoding must be one of the encodings listed for the
+adaptor, otherwise an Encoding error results.
+.PP
+If the adaptor does not support the exact hue, saturation,
+brightness, and contrast levels supplied, the closest levels
+supported are assumed.  Use
+.BR XvGetPortAttribute (__libmansuffix__)
+to query the resulting levels.
+.PP
+When an
+.BR XvSetPortAttribute (__libmansuffix__)
+request is processed, a
+.BR XvPortNotify (__libmansuffix__)
+event is generated for all clients that have requested notification of
+port changes using
+.BR XvSelectPortNotify (__libmansuffix__).
+.SH RETURN VALUES
+.IP [Success] 8
+Returned if
+.BR XvSetPortAttribute (__libmansuffix__)
+completed successfully.
+.IP [XvBadExtension] 8
+Returned if the Xv extension is unavailable.
+.IP [XvBadAlloc] 8
+Returned if
+.BR XvSelectVideoNotify (__libmansuffix__)
+failed to allocate memory to process the request.
+.SH DIAGNOSTICS
+.IP [XvBadPort] 8
+Generated if the requested port does not exist.
+.IP [XvBadEncoding] 8
+Generated if an encoding is specified that does not exist.
+.IP [BadMatch] 8
+Generated if the requested attribute atom does not specify an attribute
+supported by the adaptor.
+.SH SEE ALSO
+.\"
+.BR XvGetPortAttribute (__libmansuffix__),
+.BR XvQueryPortAttributes (__libmansuffix__),
+.BR XvSelectPortNotify (__libmansuffix__),
+.BR XvPortNotify (__libmansuffix__)