blob: 34e55d00ecaa259a4abe76efd0d33889bb84e4df (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
|
.TH XvQueryEncodings __libmansuffix__ __vendorversion__ "libXv Functions"
.SH NAME
XvQueryEncodings \- return list of encodings for an adaptor
.\"
.SH SYNOPSIS
.B #include <X11/extensions/Xvlib.h>
.sp
.nf
.BI "int XvQueryEncodings(Display *" dpy ", XvPortID " port ","
.BI " unsigned int *" p_num_encodings ","
.BI " XvEncodingInfo **" pp_encoding_info ");"
.fi
.SH ARGUMENTS
.\"
.IP \fIdpy\fR 8
Specifies the connection to the X server.
.IP \fIXvPortID\fR 8
Specifies the port whose adaptor is to be queried for its
list of encodings.
.IP \fIp_num_encodings\fR 8
A pointer to where the number of encodings supported
by the adaptor is written.
.IP \fIpp_encoding_info\fR 8
A pointer to where the list of returned encoding information is returned.
XvEncodingInfo has the following structure:
.EX
typedef struct {
XvEncodingID encoding_id;
char *name;
unsigned long width;
unsigned long height;
XvRational rate;
unsigned long num_encodings;
} XvEncodingInfo;
.EE
.IP \fIencoding_id\fR 8
Specifies the encoding-id of the encoding. The encoding-id is used to
identify an encoding when a port's encoding attribute is changed.
.IP \fIname\fR 8
A pointer to a formatted string that identifies the encoding. The string
has the format "\fItiming\fR-\fIsignaltype\fR". For example "ntsc-composite".
.IP \fIwidth,height\fR 8
The width and height, in pixels, of the decoded video image.
.IP \fIrate\fR 8
The field rate of the decoded video.
.PP
The XvRational structure is used to specify a fractional number.
It has the following structure:
.EX
typedef struct {
int numerator;
int denominator;
} XvRational;
.EE
The \fInumerator\fP and \fIdenominator\fP fields specify the
appropriate parts of a fractional number.
.\"
.SH DESCRIPTION
.BR XvQueryEncodings (__libmansuffix__)
returns encoding information about an adaptor. Each
encoding is described by the XvEncodingInfo structure described above. The
encodings are identified by an encoding-id, which can be used to set or get
the encoding attribute of a port.
.SH RETURN VALUES
.IP [Success] 8
Returned if
.BR XvQueryEncodings (__libmansuffix__)
completed successfully.
.IP [XvBadExtension] 8
Returned if the Xv extension is unavailable.
.IP [XvBadAlloc] 8
Returned if
.BR XvQueryEncodings (__libmansuffix__)
failed to allocate memory to process the request.
.SH DIAGNOSTICS
.IP [XvBadPort] 8
Generated if the requested port does not exist.
.\"
.SH SEE ALSO
.\"
.BR XvFreeEncodingInfo (__libmansuffix__)
|
