media/v4l/vidioc-enumstd.rst

1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
10 Name  chapter
13 VIDIOC_ENUMSTD - VIDIOC_SUBDEV_ENUMSTD - Enumerate supported video standards
50 .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.5cm}|
52 .. flat-table:: struct v4l2_standard
53     :header-rows:  0
54     :stub-columns: 0
57     * - __u32
58       - ``index``
59       - Number of the video standard, set by the application.
60     * - :ref:`v4l2_std_id <v4l2-std-id>`
61       - ``id``
62       - The bits in this field identify the standard as one of the common
63 	standards listed in :ref:`v4l2-std-id`, or if bits 32 to 63 are
69     * - __u8
70       - ``name``\ [24]
71       - Name of the standard, a NUL-terminated ASCII string, for example:
72 	"PAL-B/G", "NTSC Japan". This information is intended for the
74     * - struct :c:type:`v4l2_fract`
75       - ``frameperiod``
76       - The frame period (not field period) is numerator / denominator.
78     * - __u32
79       - ``framelines``
80       - Total lines per frame including blanking, e. g. 625 for B/PAL.
81     * - __u32
82       - ``reserved``\ [4]
83       - Reserved for future extensions. Drivers must set the array to
89 .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.5cm}|
91 .. flat-table:: struct v4l2_fract
92     :header-rows:  0
93     :stub-columns: 0
96     * - __u32
97       - ``numerator``
98       -
99     * - __u32
100       - ``denominator``
101       -
103 .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.5cm}|
105 .. _v4l2-std-id:
107 .. flat-table:: typedef v4l2_std_id
108     :header-rows:  0
109     :stub-columns: 0
112     * - __u64
113       - ``v4l2_std_id``
114       - This type is a set, each bit representing another video standard
115 	as listed below and in :ref:`video-standards`. The 32 most
120 .. code-block:: c
141 .. code-block:: c
150 .. code-block:: c
172 .. code-block:: c
231 …bularcolumns:: |p{1.43cm}|p{1.38cm}|p{1.59cm}|p{1.7cm}|p{1.7cm}|p{1.17cm}|p{0.64cm}|p{1.71cm}|p{1.…
233 .. _video-standards:
235 .. flat-table:: Video Standards (based on :ref:`itu470`)
236     :header-rows:  1
237     :stub-columns: 0
239     * - Characteristics
240       - M/NTSC [#f2]_
241       - M/PAL
242       - N/PAL [#f3]_
243       - B, B1, G/PAL
244       - D, D1, K/PAL
245       - H/PAL
246       - I/PAL
247       - B, G/SECAM
248       - D, K/SECAM
249       - K1/SECAM
250       - L/SECAM
251     * - Frame lines
252       - :cspan:`1` 525
253       - :cspan:`8` 625
254     * - Frame period (s)
255       - :cspan:`1` 1001/30000
256       - :cspan:`8` 1/25
257     * - Chrominance sub-carrier frequency (Hz)
258       - 3579545 ± 10
259       - 3579611.49 ± 10
260       - 4433618.75 ± 5
263       - :cspan:`3` 4433618.75 ± 5
264       - 4433618.75 ± 1
265       - :cspan:`2` f\ :sub:`OR` = 4406250 ± 2000,
268     * - Nominal radio-frequency channel bandwidth (MHz)
269       - 6
270       - 6
271       - 6
272       - B: 7; B1, G: 8
273       - 8
274       - 8
275       - 8
276       - 8
277       - 8
278       - 8
279       - 8
280     * - Sound carrier relative to vision carrier (MHz)
281       - 4.5
282       - 4.5
283       - 4.5
284       - 5.5 ± 0.001  [#f4]_  [#f5]_  [#f6]_  [#f7]_
285       - 6.5 ± 0.001
286       - 5.5
287       - 5.9996 ± 0.0005
288       - 5.5 ± 0.001
289       - 6.5 ± 0.001
290       - 6.5
291       - 6.5 [#f8]_
301 On success 0 is returned, on error -1 and the ``errno`` variable is set
303 :ref:`Generic Error Codes <gen-errors>` chapter.