Lines Matching +full:field +full:- +full:even +full:- +full:active
1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
13 VIDIOC_G_DV_TIMINGS - VIDIOC_S_DV_TIMINGS - VIDIOC_SUBDEV_G_DV_TIMINGS - VIDIOC_SUBDEV_S_DV_TIMINGS…
56 registered in read-only mode is not allowed. An error is returned and the errno
57 variable is set to ``-EPERM``.
59 The ``linux/v4l2-dv-timings.h`` header can be used to get the timings of
68 On success 0 is returned, on error -1 and the ``errno`` variable is set
70 :ref:`Generic Error Codes <gen-errors>` chapter.
83 ``VIDIOC_SUBDEV_S_DV_TIMINGS`` has been called on a read-only subdevice.
89 .. flat-table:: struct v4l2_bt_timings
90 :header-rows: 0
91 :stub-columns: 0
94 * - __u32
95 - ``width``
96 - Width of the active video in pixels.
97 * - __u32
98 - ``height``
99 - Height of the active video frame in lines. So for interlaced
100 formats the height of the active video in each field is
102 * - __u32
103 - ``interlaced``
104 - Progressive (``V4L2_DV_PROGRESSIVE``) or interlaced (``V4L2_DV_INTERLACED``).
105 * - __u32
106 - ``polarities``
107 - This is a bit mask that defines polarities of sync signals. bit 0
112 * - __u64
113 - ``pixelclock``
114 - Pixel clock in Hz. Ex. 74.25MHz->74250000
115 * - __u32
116 - ``hfrontporch``
117 - Horizontal front porch in pixels
118 * - __u32
119 - ``hsync``
120 - Horizontal sync length in pixels
121 * - __u32
122 - ``hbackporch``
123 - Horizontal back porch in pixels
124 * - __u32
125 - ``vfrontporch``
126 - Vertical front porch in lines. For interlaced formats this refers
127 to the odd field (aka field 1).
128 * - __u32
129 - ``vsync``
130 - Vertical sync length in lines. For interlaced formats this refers
131 to the odd field (aka field 1).
132 * - __u32
133 - ``vbackporch``
134 - Vertical back porch in lines. For interlaced formats this refers
135 to the odd field (aka field 1).
136 * - __u32
137 - ``il_vfrontporch``
138 - Vertical front porch in lines for the even field (aka field 2) of
139 interlaced field formats. Must be 0 for progressive formats.
140 * - __u32
141 - ``il_vsync``
142 - Vertical sync length in lines for the even field (aka field 2) of
143 interlaced field formats. Must be 0 for progressive formats.
144 * - __u32
145 - ``il_vbackporch``
146 - Vertical back porch in lines for the even field (aka field 2) of
147 interlaced field formats. Must be 0 for progressive formats.
148 * - __u32
149 - ``standards``
150 - The video standard(s) this format belongs to. This will be filled
152 :ref:`dv-bt-standards` for a list of standards.
153 * - __u32
154 - ``flags``
155 - Several flags giving more information about the format. See
156 :ref:`dv-bt-flags` for a description of the flags.
157 * - struct :c:type:`v4l2_fract`
158 - ``picture_aspect``
159 - The picture aspect if the pixels are not square. Only valid if the
161 * - __u8
162 - ``cea861_vic``
163 - The Video Identification Code according to the CEA-861 standard.
165 * - __u8
166 - ``hdmi_vic``
167 - The Video Identification Code according to the HDMI standard.
169 * - __u8
170 - ``reserved[46]``
171 - Reserved for future extensions. Drivers and applications must set
178 .. flat-table:: struct v4l2_dv_timings
179 :header-rows: 0
180 :stub-columns: 0
183 * - __u32
184 - ``type``
185 - Type of DV timings as listed in :ref:`dv-timing-types`.
186 * - union {
187 - (anonymous)
188 * - struct :c:type:`v4l2_bt_timings`
189 - ``bt``
190 - Timings defined by BT.656/1120 specifications
191 * - __u32
192 - ``reserved``\ [32]
193 -
194 * - }
195 -
199 .. _dv-timing-types:
201 .. flat-table:: DV Timing types
202 :header-rows: 0
203 :stub-columns: 0
206 * - Timing type
207 - value
208 - Description
209 * -
210 -
211 -
212 * - ``V4L2_DV_BT_656_1120``
213 - 0
214 - BT.656/1120 timings
218 .. _dv-bt-standards:
220 .. flat-table:: DV BT Timing standards
221 :header-rows: 0
222 :stub-columns: 0
224 * - Timing standard
225 - Description
226 * - ``V4L2_DV_BT_STD_CEA861``
227 - The timings follow the CEA-861 Digital TV Profile standard
228 * - ``V4L2_DV_BT_STD_DMT``
229 - The timings follow the VESA Discrete Monitor Timings standard
230 * - ``V4L2_DV_BT_STD_CVT``
231 - The timings follow the VESA Coordinated Video Timings standard
232 * - ``V4L2_DV_BT_STD_GTF``
233 - The timings follow the VESA Generalized Timings Formula standard
234 * - ``V4L2_DV_BT_STD_SDI``
235 - The timings follow the SDI Timings standard.
241 .. _dv-bt-flags:
243 .. flat-table:: DV BT Timing flags
244 :header-rows: 0
245 :stub-columns: 0
247 * - Flag
248 - Description
249 * - ``V4L2_DV_FL_REDUCED_BLANKING``
250 - CVT/GTF specific: the timings use reduced blanking (CVT) or the
253 resolution over the same bandwidth. This is a read-only flag,
255 * - ``V4L2_DV_FL_CAN_REDUCE_FPS``
256 - CEA-861 specific: set for CEA-861 formats with a framerate that is
259 NTSC and PAL-M that use a framerate of 29.97 frames per second. If
261 will also be cleared. This is a read-only flag, applications must
263 * - ``V4L2_DV_FL_REDUCED_FPS``
264 - CEA-861 specific: only valid for video transmitters or video
277 * - ``V4L2_DV_FL_HALF_LINE``
278 - Specific to interlaced formats: if set, then the vertical
279 frontporch of field 1 (aka the odd field) is really one half-line
280 longer and the vertical backporch of field 2 (aka the even field)
281 is really one half-line shorter, so each field has exactly the
282 same number of half-lines. Whether half-lines can be detected or
284 * - ``V4L2_DV_FL_IS_CE_VIDEO``
285 - If set, then this is a Consumer Electronics (CE) video format.
288 R'G'B' values use limited range (i.e. 16-235) as opposed to full
289 range (i.e. 0-255). All formats defined in CEA-861 except for the
291 * - ``V4L2_DV_FL_FIRST_FIELD_EXTRA_LINE``
292 - Some formats like SMPTE-125M have an interlaced signal with a odd
294 field has the extra line. Else, it is the second field.
295 * - ``V4L2_DV_FL_HAS_PICTURE_ASPECT``
296 - If set, then the picture_aspect field is valid. Otherwise assume that
299 * - ``V4L2_DV_FL_HAS_CEA861_VIC``
300 - If set, then the cea861_vic field is valid and contains the Video
301 Identification Code as per the CEA-861 standard.
302 * - ``V4L2_DV_FL_HAS_HDMI_VIC``
303 - If set, then the hdmi_vic field is valid and contains the Video
306 * - ``V4L2_DV_FL_CAN_DETECT_REDUCED_FPS``
307 - CEA-861 specific: only valid for video receivers, the flag is