~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

TOMOYO Linux Cross Reference
Linux/Documentation/userspace-api/media/v4l/vidioc-g-dv-timings.rst

Version: ~ [ linux-6.12-rc7 ] ~ [ linux-6.11.7 ] ~ [ linux-6.10.14 ] ~ [ linux-6.9.12 ] ~ [ linux-6.8.12 ] ~ [ linux-6.7.12 ] ~ [ linux-6.6.60 ] ~ [ linux-6.5.13 ] ~ [ linux-6.4.16 ] ~ [ linux-6.3.13 ] ~ [ linux-6.2.16 ] ~ [ linux-6.1.116 ] ~ [ linux-6.0.19 ] ~ [ linux-5.19.17 ] ~ [ linux-5.18.19 ] ~ [ linux-5.17.15 ] ~ [ linux-5.16.20 ] ~ [ linux-5.15.171 ] ~ [ linux-5.14.21 ] ~ [ linux-5.13.19 ] ~ [ linux-5.12.19 ] ~ [ linux-5.11.22 ] ~ [ linux-5.10.229 ] ~ [ linux-5.9.16 ] ~ [ linux-5.8.18 ] ~ [ linux-5.7.19 ] ~ [ linux-5.6.19 ] ~ [ linux-5.5.19 ] ~ [ linux-5.4.285 ] ~ [ linux-5.3.18 ] ~ [ linux-5.2.21 ] ~ [ linux-5.1.21 ] ~ [ linux-5.0.21 ] ~ [ linux-4.20.17 ] ~ [ linux-4.19.323 ] ~ [ linux-4.18.20 ] ~ [ linux-4.17.19 ] ~ [ linux-4.16.18 ] ~ [ linux-4.15.18 ] ~ [ linux-4.14.336 ] ~ [ linux-4.13.16 ] ~ [ linux-4.12.14 ] ~ [ linux-4.11.12 ] ~ [ linux-4.10.17 ] ~ [ linux-4.9.337 ] ~ [ linux-4.4.302 ] ~ [ linux-3.10.108 ] ~ [ linux-2.6.32.71 ] ~ [ linux-2.6.0 ] ~ [ linux-2.4.37.11 ] ~ [ unix-v6-master ] ~ [ ccs-tools-1.8.12 ] ~ [ policy-sample ] ~
Architecture: ~ [ i386 ] ~ [ alpha ] ~ [ m68k ] ~ [ mips ] ~ [ ppc ] ~ [ sparc ] ~ [ sparc64 ] ~

Diff markup

Differences between /Documentation/userspace-api/media/v4l/vidioc-g-dv-timings.rst (Version linux-6.12-rc7) and /Documentation/userspace-api/media/v4l/vidioc-g-dv-timings.rst (Version linux-5.8.18)


  1 .. SPDX-License-Identifier: GFDL-1.1-no-invari !!   1 .. Permission is granted to copy, distribute and/or modify this
  2 .. c:namespace:: V4L                           !!   2 .. document under the terms of the GNU Free Documentation License,
                                                   >>   3 .. Version 1.1 or any later version published by the Free Software
                                                   >>   4 .. Foundation, with no Invariant Sections, no Front-Cover Texts
                                                   >>   5 .. and no Back-Cover Texts. A copy of the license is included at
                                                   >>   6 .. Documentation/userspace-api/media/fdl-appendix.rst.
                                                   >>   7 ..
                                                   >>   8 .. TODO: replace it to GFDL-1.1-or-later WITH no-invariant-sections
  3                                                     9 
  4 .. _VIDIOC_G_DV_TIMINGS:                           10 .. _VIDIOC_G_DV_TIMINGS:
  5                                                    11 
  6 **********************************************     12 **********************************************
  7 ioctl VIDIOC_G_DV_TIMINGS, VIDIOC_S_DV_TIMINGS     13 ioctl VIDIOC_G_DV_TIMINGS, VIDIOC_S_DV_TIMINGS
  8 **********************************************     14 **********************************************
  9                                                    15 
 10 Name                                               16 Name
 11 ====                                               17 ====
 12                                                    18 
 13 VIDIOC_G_DV_TIMINGS - VIDIOC_S_DV_TIMINGS - VI     19 VIDIOC_G_DV_TIMINGS - VIDIOC_S_DV_TIMINGS - VIDIOC_SUBDEV_G_DV_TIMINGS - VIDIOC_SUBDEV_S_DV_TIMINGS - Get or set DV timings for input or output
 14                                                    20 
                                                   >>  21 
 15 Synopsis                                           22 Synopsis
 16 ========                                           23 ========
 17                                                    24 
 18 .. c:macro:: VIDIOC_G_DV_TIMINGS               !!  25 .. c:function:: int ioctl( int fd, VIDIOC_G_DV_TIMINGS, struct v4l2_dv_timings *argp )
 19                                                !!  26     :name: VIDIOC_G_DV_TIMINGS
 20 ``int ioctl(int fd, VIDIOC_G_DV_TIMINGS, struc << 
 21                                                << 
 22 .. c:macro:: VIDIOC_S_DV_TIMINGS               << 
 23                                                    27 
 24 ``int ioctl(int fd, VIDIOC_S_DV_TIMINGS, struc !!  28 .. c:function:: int ioctl( int fd, VIDIOC_S_DV_TIMINGS, struct v4l2_dv_timings *argp )
                                                   >>  29     :name: VIDIOC_S_DV_TIMINGS
 25                                                    30 
 26 .. c:macro:: VIDIOC_SUBDEV_G_DV_TIMINGS        !!  31 .. c:function:: int ioctl( int fd, VIDIOC_SUBDEV_G_DV_TIMINGS, struct v4l2_dv_timings *argp )
                                                   >>  32     :name: VIDIOC_SUBDEV_G_DV_TIMINGS
 27                                                    33 
 28 ``int ioctl(int fd, VIDIOC_SUBDEV_G_DV_TIMINGS !!  34 .. c:function:: int ioctl( int fd, VIDIOC_SUBDEV_S_DV_TIMINGS, struct v4l2_dv_timings *argp )
                                                   >>  35     :name: VIDIOC_SUBDEV_S_DV_TIMINGS
 29                                                    36 
 30 .. c:macro:: VIDIOC_SUBDEV_S_DV_TIMINGS        << 
 31                                                << 
 32 ``int ioctl(int fd, VIDIOC_SUBDEV_S_DV_TIMINGS << 
 33                                                    37 
 34 Arguments                                          38 Arguments
 35 =========                                          39 =========
 36                                                    40 
 37 ``fd``                                             41 ``fd``
 38     File descriptor returned by :c:func:`open( !!  42     File descriptor returned by :ref:`open() <func-open>`.
 39                                                    43 
 40 ``argp``                                           44 ``argp``
 41     Pointer to struct :c:type:`v4l2_dv_timings     45     Pointer to struct :c:type:`v4l2_dv_timings`.
 42                                                    46 
                                                   >>  47 
 43 Description                                        48 Description
 44 ===========                                        49 ===========
 45                                                    50 
 46 To set DV timings for the input or output, app     51 To set DV timings for the input or output, applications use the
 47 :ref:`VIDIOC_S_DV_TIMINGS <VIDIOC_G_DV_TIMINGS     52 :ref:`VIDIOC_S_DV_TIMINGS <VIDIOC_G_DV_TIMINGS>` ioctl and to get the current timings,
 48 applications use the :ref:`VIDIOC_G_DV_TIMINGS     53 applications use the :ref:`VIDIOC_G_DV_TIMINGS <VIDIOC_G_DV_TIMINGS>` ioctl. The detailed timing
 49 information is filled in using the structure s     54 information is filled in using the structure struct
 50 :c:type:`v4l2_dv_timings`. These ioctls take a     55 :c:type:`v4l2_dv_timings`. These ioctls take a
 51 pointer to the struct :c:type:`v4l2_dv_timings     56 pointer to the struct :c:type:`v4l2_dv_timings`
 52 structure as argument. If the ioctl is not sup     57 structure as argument. If the ioctl is not supported or the timing
 53 values are not correct, the driver returns ``E     58 values are not correct, the driver returns ``EINVAL`` error code.
 54                                                    59 
 55 Calling ``VIDIOC_SUBDEV_S_DV_TIMINGS`` on a su     60 Calling ``VIDIOC_SUBDEV_S_DV_TIMINGS`` on a subdev device node that has been
 56 registered in read-only mode is not allowed. A     61 registered in read-only mode is not allowed. An error is returned and the errno
 57 variable is set to ``-EPERM``.                     62 variable is set to ``-EPERM``.
 58                                                    63 
 59 The ``linux/v4l2-dv-timings.h`` header can be      64 The ``linux/v4l2-dv-timings.h`` header can be used to get the timings of
 60 the formats in the :ref:`cea861` and :ref:`ves     65 the formats in the :ref:`cea861` and :ref:`vesadmt` standards. If
 61 the current input or output does not support D     66 the current input or output does not support DV timings (e.g. if
 62 :ref:`VIDIOC_ENUMINPUT` does not set the           67 :ref:`VIDIOC_ENUMINPUT` does not set the
 63 ``V4L2_IN_CAP_DV_TIMINGS`` flag), then ``ENODA     68 ``V4L2_IN_CAP_DV_TIMINGS`` flag), then ``ENODATA`` error code is returned.
 64                                                    69 
                                                   >>  70 
 65 Return Value                                       71 Return Value
 66 ============                                       72 ============
 67                                                    73 
 68 On success 0 is returned, on error -1 and the      74 On success 0 is returned, on error -1 and the ``errno`` variable is set
 69 appropriately. The generic error codes are des     75 appropriately. The generic error codes are described at the
 70 :ref:`Generic Error Codes <gen-errors>` chapte     76 :ref:`Generic Error Codes <gen-errors>` chapter.
 71                                                    77 
 72 EINVAL                                             78 EINVAL
 73     This ioctl is not supported, or the :ref:`     79     This ioctl is not supported, or the :ref:`VIDIOC_S_DV_TIMINGS <VIDIOC_G_DV_TIMINGS>`
 74     parameter was unsuitable.                      80     parameter was unsuitable.
 75                                                    81 
 76 ENODATA                                            82 ENODATA
 77     Digital video timings are not supported fo     83     Digital video timings are not supported for this input or output.
 78                                                    84 
 79 EBUSY                                              85 EBUSY
 80     The device is busy and therefore can not c     86     The device is busy and therefore can not change the timings.
 81                                                    87 
 82 EPERM                                              88 EPERM
 83     ``VIDIOC_SUBDEV_S_DV_TIMINGS`` has been ca     89     ``VIDIOC_SUBDEV_S_DV_TIMINGS`` has been called on a read-only subdevice.
 84                                                    90 
 85 .. c:type:: v4l2_bt_timings                    !!  91 .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}|
 86                                                << 
 87 .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.5cm << 
 88                                                    92 
 89 .. cssclass:: longtable                        !!  93 .. c:type:: v4l2_bt_timings
 90                                                    94 
 91 .. flat-table:: struct v4l2_bt_timings             95 .. flat-table:: struct v4l2_bt_timings
 92     :header-rows:  0                               96     :header-rows:  0
 93     :stub-columns: 0                               97     :stub-columns: 0
 94     :widths:       1 1 2                           98     :widths:       1 1 2
 95                                                    99 
 96     * - __u32                                     100     * - __u32
 97       - ``width``                                 101       - ``width``
 98       - Width of the active video in pixels.      102       - Width of the active video in pixels.
 99     * - __u32                                     103     * - __u32
100       - ``height``                                104       - ``height``
101       - Height of the active video frame in li    105       - Height of the active video frame in lines. So for interlaced
102         formats the height of the active video    106         formats the height of the active video in each field is
103         ``height``/2.                             107         ``height``/2.
104     * - __u32                                     108     * - __u32
105       - ``interlaced``                            109       - ``interlaced``
106       - Progressive (``V4L2_DV_PROGRESSIVE``)     110       - Progressive (``V4L2_DV_PROGRESSIVE``) or interlaced (``V4L2_DV_INTERLACED``).
107     * - __u32                                     111     * - __u32
108       - ``polarities``                            112       - ``polarities``
109       - This is a bit mask that defines polari    113       - This is a bit mask that defines polarities of sync signals. bit 0
110         (``V4L2_DV_VSYNC_POS_POL``) is for ver    114         (``V4L2_DV_VSYNC_POS_POL``) is for vertical sync polarity and bit
111         1 (``V4L2_DV_HSYNC_POS_POL``) is for h    115         1 (``V4L2_DV_HSYNC_POS_POL``) is for horizontal sync polarity. If
112         the bit is set (1) it is positive pola    116         the bit is set (1) it is positive polarity and if is cleared (0),
113         it is negative polarity.                  117         it is negative polarity.
114     * - __u64                                     118     * - __u64
115       - ``pixelclock``                            119       - ``pixelclock``
116       - Pixel clock in Hz. Ex. 74.25MHz->74250    120       - Pixel clock in Hz. Ex. 74.25MHz->74250000
117     * - __u32                                     121     * - __u32
118       - ``hfrontporch``                           122       - ``hfrontporch``
119       - Horizontal front porch in pixels          123       - Horizontal front porch in pixels
120     * - __u32                                     124     * - __u32
121       - ``hsync``                                 125       - ``hsync``
122       - Horizontal sync length in pixels          126       - Horizontal sync length in pixels
123     * - __u32                                     127     * - __u32
124       - ``hbackporch``                            128       - ``hbackporch``
125       - Horizontal back porch in pixels           129       - Horizontal back porch in pixels
126     * - __u32                                     130     * - __u32
127       - ``vfrontporch``                           131       - ``vfrontporch``
128       - Vertical front porch in lines. For int    132       - Vertical front porch in lines. For interlaced formats this refers
129         to the odd field (aka field 1).           133         to the odd field (aka field 1).
130     * - __u32                                     134     * - __u32
131       - ``vsync``                                 135       - ``vsync``
132       - Vertical sync length in lines. For int    136       - Vertical sync length in lines. For interlaced formats this refers
133         to the odd field (aka field 1).           137         to the odd field (aka field 1).
134     * - __u32                                     138     * - __u32
135       - ``vbackporch``                            139       - ``vbackporch``
136       - Vertical back porch in lines. For inte    140       - Vertical back porch in lines. For interlaced formats this refers
137         to the odd field (aka field 1).           141         to the odd field (aka field 1).
138     * - __u32                                     142     * - __u32
139       - ``il_vfrontporch``                        143       - ``il_vfrontporch``
140       - Vertical front porch in lines for the     144       - Vertical front porch in lines for the even field (aka field 2) of
141         interlaced field formats. Must be 0 fo    145         interlaced field formats. Must be 0 for progressive formats.
142     * - __u32                                     146     * - __u32
143       - ``il_vsync``                              147       - ``il_vsync``
144       - Vertical sync length in lines for the     148       - Vertical sync length in lines for the even field (aka field 2) of
145         interlaced field formats. Must be 0 fo    149         interlaced field formats. Must be 0 for progressive formats.
146     * - __u32                                     150     * - __u32
147       - ``il_vbackporch``                         151       - ``il_vbackporch``
148       - Vertical back porch in lines for the e    152       - Vertical back porch in lines for the even field (aka field 2) of
149         interlaced field formats. Must be 0 fo    153         interlaced field formats. Must be 0 for progressive formats.
150     * - __u32                                     154     * - __u32
151       - ``standards``                             155       - ``standards``
152       - The video standard(s) this format belo    156       - The video standard(s) this format belongs to. This will be filled
153         in by the driver. Applications must se    157         in by the driver. Applications must set this to 0. See
154         :ref:`dv-bt-standards` for a list of s    158         :ref:`dv-bt-standards` for a list of standards.
155     * - __u32                                     159     * - __u32
156       - ``flags``                                 160       - ``flags``
157       - Several flags giving more information     161       - Several flags giving more information about the format. See
158         :ref:`dv-bt-flags` for a description o    162         :ref:`dv-bt-flags` for a description of the flags.
159     * - struct :c:type:`v4l2_fract`               163     * - struct :c:type:`v4l2_fract`
160       - ``picture_aspect``                        164       - ``picture_aspect``
161       - The picture aspect if the pixels are n    165       - The picture aspect if the pixels are not square. Only valid if the
162         ``V4L2_DV_FL_HAS_PICTURE_ASPECT`` flag    166         ``V4L2_DV_FL_HAS_PICTURE_ASPECT`` flag is set.
163     * - __u8                                      167     * - __u8
164       - ``cea861_vic``                            168       - ``cea861_vic``
165       - The Video Identification Code accordin    169       - The Video Identification Code according to the CEA-861 standard.
166         Only valid if the ``V4L2_DV_FL_HAS_CEA    170         Only valid if the ``V4L2_DV_FL_HAS_CEA861_VIC`` flag is set.
167     * - __u8                                      171     * - __u8
168       - ``hdmi_vic``                              172       - ``hdmi_vic``
169       - The Video Identification Code accordin    173       - The Video Identification Code according to the HDMI standard.
170         Only valid if the ``V4L2_DV_FL_HAS_HDM    174         Only valid if the ``V4L2_DV_FL_HAS_HDMI_VIC`` flag is set.
171     * - __u8                                      175     * - __u8
172       - ``reserved[46]``                          176       - ``reserved[46]``
173       - Reserved for future extensions. Driver    177       - Reserved for future extensions. Drivers and applications must set
174         the array to zero.                        178         the array to zero.
175                                                   179 
176 .. tabularcolumns:: |p{3.5cm}|p{3.5cm}|p{7.0cm !! 180 
                                                   >> 181 .. tabularcolumns:: |p{3.5cm}|p{3.5cm}|p{7.0cm}|p{3.5cm}|
177                                                   182 
178 .. c:type:: v4l2_dv_timings                       183 .. c:type:: v4l2_dv_timings
179                                                   184 
180 .. flat-table:: struct v4l2_dv_timings            185 .. flat-table:: struct v4l2_dv_timings
181     :header-rows:  0                              186     :header-rows:  0
182     :stub-columns: 0                              187     :stub-columns: 0
183     :widths:       1 1 2                          188     :widths:       1 1 2
184                                                   189 
185     * - __u32                                     190     * - __u32
186       - ``type``                                  191       - ``type``
187       - Type of DV timings as listed in :ref:`    192       - Type of DV timings as listed in :ref:`dv-timing-types`.
188     * - union {                                   193     * - union {
189       - (anonymous)                               194       - (anonymous)
190     * - struct :c:type:`v4l2_bt_timings`          195     * - struct :c:type:`v4l2_bt_timings`
191       - ``bt``                                    196       - ``bt``
192       - Timings defined by BT.656/1120 specifi    197       - Timings defined by BT.656/1120 specifications
193     * - __u32                                     198     * - __u32
194       - ``reserved``\ [32]                        199       - ``reserved``\ [32]
195       -                                           200       -
196     * - }                                         201     * - }
197       -                                           202       -
198                                                   203 
199 .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.5cm !! 204 .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}|
200                                                   205 
201 .. _dv-timing-types:                              206 .. _dv-timing-types:
202                                                   207 
203 .. flat-table:: DV Timing types                   208 .. flat-table:: DV Timing types
204     :header-rows:  0                              209     :header-rows:  0
205     :stub-columns: 0                              210     :stub-columns: 0
206     :widths:       1 1 2                          211     :widths:       1 1 2
207                                                   212 
208     * - Timing type                               213     * - Timing type
209       - value                                     214       - value
210       - Description                               215       - Description
211     * -                                           216     * -
212       -                                           217       -
213       -                                           218       -
214     * - ``V4L2_DV_BT_656_1120``                   219     * - ``V4L2_DV_BT_656_1120``
215       - 0                                         220       - 0
216       - BT.656/1120 timings                       221       - BT.656/1120 timings
217                                                   222 
218 .. tabularcolumns:: |p{6.5cm}|p{11.0cm}|       !! 223 .. tabularcolumns:: |p{4.5cm}|p{12.8cm}|
219                                                << 
220 .. cssclass:: longtable                        << 
221                                                   224 
222 .. _dv-bt-standards:                              225 .. _dv-bt-standards:
223                                                   226 
224 .. flat-table:: DV BT Timing standards            227 .. flat-table:: DV BT Timing standards
225     :header-rows:  0                              228     :header-rows:  0
226     :stub-columns: 0                              229     :stub-columns: 0
227                                                   230 
228     * - Timing standard                           231     * - Timing standard
229       - Description                               232       - Description
230     * - ``V4L2_DV_BT_STD_CEA861``                 233     * - ``V4L2_DV_BT_STD_CEA861``
231       - The timings follow the CEA-861 Digital    234       - The timings follow the CEA-861 Digital TV Profile standard
232     * - ``V4L2_DV_BT_STD_DMT``                    235     * - ``V4L2_DV_BT_STD_DMT``
233       - The timings follow the VESA Discrete M    236       - The timings follow the VESA Discrete Monitor Timings standard
234     * - ``V4L2_DV_BT_STD_CVT``                    237     * - ``V4L2_DV_BT_STD_CVT``
235       - The timings follow the VESA Coordinate    238       - The timings follow the VESA Coordinated Video Timings standard
236     * - ``V4L2_DV_BT_STD_GTF``                    239     * - ``V4L2_DV_BT_STD_GTF``
237       - The timings follow the VESA Generalize    240       - The timings follow the VESA Generalized Timings Formula standard
238     * - ``V4L2_DV_BT_STD_SDI``                    241     * - ``V4L2_DV_BT_STD_SDI``
239       - The timings follow the SDI Timings sta    242       - The timings follow the SDI Timings standard.
240         There are no horizontal syncs/porches     243         There are no horizontal syncs/porches at all in this format.
241         Total blanking timings must be set in     244         Total blanking timings must be set in hsync or vsync fields only.
242                                                   245 
243 .. tabularcolumns:: |p{7.7cm}|p{9.8cm}|        !! 246 .. tabularcolumns:: |p{7.0cm}|p{10.5cm}|
244                                                << 
245 .. cssclass:: longtable                        << 
246                                                   247 
247 .. _dv-bt-flags:                                  248 .. _dv-bt-flags:
248                                                   249 
249 .. flat-table:: DV BT Timing flags                250 .. flat-table:: DV BT Timing flags
250     :header-rows:  0                              251     :header-rows:  0
251     :stub-columns: 0                              252     :stub-columns: 0
252                                                   253 
253     * - Flag                                      254     * - Flag
254       - Description                               255       - Description
255     * - ``V4L2_DV_FL_REDUCED_BLANKING``           256     * - ``V4L2_DV_FL_REDUCED_BLANKING``
256       - CVT/GTF specific: the timings use redu    257       - CVT/GTF specific: the timings use reduced blanking (CVT) or the
257         'Secondary GTF' curve (GTF). In both c    258         'Secondary GTF' curve (GTF). In both cases the horizontal and/or
258         vertical blanking intervals are reduce    259         vertical blanking intervals are reduced, allowing a higher
259         resolution over the same bandwidth. Th    260         resolution over the same bandwidth. This is a read-only flag,
260         applications must not set this.           261         applications must not set this.
261     * - ``V4L2_DV_FL_CAN_REDUCE_FPS``             262     * - ``V4L2_DV_FL_CAN_REDUCE_FPS``
262       - CEA-861 specific: set for CEA-861 form    263       - CEA-861 specific: set for CEA-861 formats with a framerate that is
263         a multiple of six. These formats can b    264         a multiple of six. These formats can be optionally played at 1 /
264         1.001 speed to be compatible with 60 H    265         1.001 speed to be compatible with 60 Hz based standards such as
265         NTSC and PAL-M that use a framerate of    266         NTSC and PAL-M that use a framerate of 29.97 frames per second. If
266         the transmitter can't generate such fr    267         the transmitter can't generate such frequencies, then the flag
267         will also be cleared. This is a read-o    268         will also be cleared. This is a read-only flag, applications must
268         not set this.                             269         not set this.
269     * - ``V4L2_DV_FL_REDUCED_FPS``                270     * - ``V4L2_DV_FL_REDUCED_FPS``
270       - CEA-861 specific: only valid for video    271       - CEA-861 specific: only valid for video transmitters or video
271         receivers that have the ``V4L2_DV_FL_C    272         receivers that have the ``V4L2_DV_FL_CAN_DETECT_REDUCED_FPS``
272         set. This flag is cleared otherwise. I    273         set. This flag is cleared otherwise. It is also only valid for
273         formats with the ``V4L2_DV_FL_CAN_REDU    274         formats with the ``V4L2_DV_FL_CAN_REDUCE_FPS`` flag set, for other
274         formats the flag will be cleared by th    275         formats the flag will be cleared by the driver.
275                                                   276 
276         If the application sets this flag for     277         If the application sets this flag for a transmitter, then the
277         pixelclock used to set up the transmit    278         pixelclock used to set up the transmitter is divided by 1.001 to
278         make it compatible with NTSC framerate    279         make it compatible with NTSC framerates. If the transmitter can't
279         generate such frequencies, then the fl    280         generate such frequencies, then the flag will be cleared.
280                                                   281 
281         If a video receiver detects that the f    282         If a video receiver detects that the format uses a reduced framerate,
282         then it will set this flag to signal t    283         then it will set this flag to signal this to the application.
283     * - ``V4L2_DV_FL_HALF_LINE``                  284     * - ``V4L2_DV_FL_HALF_LINE``
284       - Specific to interlaced formats: if set    285       - Specific to interlaced formats: if set, then the vertical
285         frontporch of field 1 (aka the odd fie    286         frontporch of field 1 (aka the odd field) is really one half-line
286         longer and the vertical backporch of f    287         longer and the vertical backporch of field 2 (aka the even field)
287         is really one half-line shorter, so ea    288         is really one half-line shorter, so each field has exactly the
288         same number of half-lines. Whether hal    289         same number of half-lines. Whether half-lines can be detected or
289         used depends on the hardware.             290         used depends on the hardware.
290     * - ``V4L2_DV_FL_IS_CE_VIDEO``                291     * - ``V4L2_DV_FL_IS_CE_VIDEO``
291       - If set, then this is a Consumer Electr    292       - If set, then this is a Consumer Electronics (CE) video format.
292         Such formats differ from other formats    293         Such formats differ from other formats (commonly called IT
293         formats) in that if R'G'B' encoding is    294         formats) in that if R'G'B' encoding is used then by default the
294         R'G'B' values use limited range (i.e.     295         R'G'B' values use limited range (i.e. 16-235) as opposed to full
295         range (i.e. 0-255). All formats define    296         range (i.e. 0-255). All formats defined in CEA-861 except for the
296         640x480p59.94 format are CE formats.      297         640x480p59.94 format are CE formats.
297     * - ``V4L2_DV_FL_FIRST_FIELD_EXTRA_LINE``     298     * - ``V4L2_DV_FL_FIRST_FIELD_EXTRA_LINE``
298       - Some formats like SMPTE-125M have an i    299       - Some formats like SMPTE-125M have an interlaced signal with a odd
299         total height. For these formats, if th    300         total height. For these formats, if this flag is set, the first
300         field has the extra line. Else, it is     301         field has the extra line. Else, it is the second field.
301     * - ``V4L2_DV_FL_HAS_PICTURE_ASPECT``         302     * - ``V4L2_DV_FL_HAS_PICTURE_ASPECT``
302       - If set, then the picture_aspect field     303       - If set, then the picture_aspect field is valid. Otherwise assume that
303         the pixels are square, so the picture     304         the pixels are square, so the picture aspect ratio is the same as the
304         width to height ratio.                    305         width to height ratio.
305     * - ``V4L2_DV_FL_HAS_CEA861_VIC``             306     * - ``V4L2_DV_FL_HAS_CEA861_VIC``
306       - If set, then the cea861_vic field is v    307       - If set, then the cea861_vic field is valid and contains the Video
307         Identification Code as per the CEA-861    308         Identification Code as per the CEA-861 standard.
308     * - ``V4L2_DV_FL_HAS_HDMI_VIC``               309     * - ``V4L2_DV_FL_HAS_HDMI_VIC``
309       - If set, then the hdmi_vic field is val    310       - If set, then the hdmi_vic field is valid and contains the Video
310         Identification Code as per the HDMI st    311         Identification Code as per the HDMI standard (HDMI Vendor Specific
311         InfoFrame).                               312         InfoFrame).
312     * - ``V4L2_DV_FL_CAN_DETECT_REDUCED_FPS``     313     * - ``V4L2_DV_FL_CAN_DETECT_REDUCED_FPS``
313       - CEA-861 specific: only valid for video    314       - CEA-861 specific: only valid for video receivers, the flag is
314         cleared by transmitters.                  315         cleared by transmitters.
315         If set, then the hardware can detect t    316         If set, then the hardware can detect the difference between
316         regular framerates and framerates redu    317         regular framerates and framerates reduced by 1000/1001. E.g.:
317         60 vs 59.94 Hz, 30 vs 29.97 Hz or 24 v    318         60 vs 59.94 Hz, 30 vs 29.97 Hz or 24 vs 23.976 Hz.
                                                      

~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

kernel.org | git.kernel.org | LWN.net | Project Home | SVN repository | Mail admin

Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.

sflogo.php