Lines Matching +full:in +full:- +full:line
1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
10 VBI stands for Vertical Blanking Interval, a gap in the sequence of
15 Sliced VBI devices use hardware to demodulate data transmitted in the
17 :ref:`raw VBI interface <raw-vbi>`. The data is passed as short
18 packets of fixed size, covering one scan line each. The number of
36 respectively, in the ``capabilities`` field of struct
51 .. _sliced-vbi-format-negotitation:
63 services it can identify on a given line are limited. For example on PAL
64 line 16 the hardware may be able to look for a VPS or Teletext signal,
81 hardware must be told which VBI service to expect on each scan line. Not
84 other services can only be inserted in one specific line). In many
103 -----------------------------
115 .. flat-table::
116 :header-rows: 0
117 :stub-columns: 0
120 * - __u16
121 - ``service_set``
122 - :cspan:`2`
124 If ``service_set`` is non-zero when passed with
128 specified in this field. For example, if ``service_set`` is
130 a driver for the cx25840 video decoder sets lines 7-22 of both
131 fields [#f1]_ to ``V4L2_SLICED_TELETEXT_B`` and line 23 of the first
140 * - __u16
141 - ``service_lines``\ [2][24]
142 - :cspan:`2`
145 driver shall look for or insert on the respective scan line.
148 When the hardware cannot handle multiple services on the same line
152 Data services are defined in :ref:`vbi-services2`. Array indices
153 map to ITU-R line numbers\ [#f2]_ as follows:
154 * -
155 -
156 - Element
157 - 525 line systems
158 - 625 line systems
159 * -
160 -
161 - ``service_lines``\ [0][1]
162 - 1
163 - 1
164 * -
165 -
166 - ``service_lines``\ [0][23]
167 - 23
168 - 23
169 * -
170 -
171 - ``service_lines``\ [1][1]
172 - 264
173 - 314
174 * -
175 -
176 - ``service_lines``\ [1][23]
177 - 286
178 - 336
179 * -
180 -
181 - :cspan:`2` Drivers must set ``service_lines`` [0][0] and
185 defines give the start line numbers for each field for each 525 or
186 625 line format as a convenience. Don't forget that ITU line
188 * - __u32
189 - ``io_size``
190 - :cspan:`2` Maximum number of bytes passed by one
192 and the buffer size in bytes for the
197 number of non-zero elements in the returned ``service_lines``
199 * - __u32
200 - ``reserved``\ [2]
201 - :cspan:`2` This array is reserved for future extensions.
209 .. _vbi-services2:
212 -------------------
220 .. flat-table::
221 :header-rows: 1
222 :stub-columns: 0
225 * - Symbol
226 - Value
227 - Reference
228 - Lines, usually
229 - Payload
230 * - ``V4L2_SLICED_TELETEXT_B`` (Teletext System B)
231 - 0x0001
232 - :ref:`ets300706`,
235 - PAL/SECAM line 7-22, 320-335 (second field 7-22)
236 - Last 42 of the 45 byte Teletext packet, that is without clock
237 run-in and framing code, lsb first transmitted.
238 * - ``V4L2_SLICED_VPS``
239 - 0x0400
240 - :ref:`ets300231`
241 - PAL line 16
242 - Byte number 3 to 15 according to Figure 9 of ETS 300 231, lsb
244 * - ``V4L2_SLICED_CAPTION_525``
245 - 0x1000
246 - :ref:`cea608`
247 - NTSC line 21, 284 (second field 21)
248 - Two bytes in transmission order, including parity bit, lsb first
250 * - ``V4L2_SLICED_WSS_625``
251 - 0x4000
252 - :ref:`itu1119`,
255 - PAL/SECAM line 23
256 -
263 * - ``V4L2_SLICED_VBI_525``
264 - 0x1000
265 - :cspan:`2` Set of services applicable to 525 line systems.
266 * - ``V4L2_SLICED_VBI_625``
267 - 0x4401
268 - :cspan:`2` Set of services applicable to 625 line systems.
280 format while i/o is in progress (between a
292 in streaming I/O mode one buffer of ``io_size`` bytes must contain data
299 ---------------------------
303 .. flat-table::
304 :header-rows: 0
305 :stub-columns: 0
308 * - __u32
309 - ``id``
310 - A flag from :ref:`vbi-services` identifying the type of data in
316 no longer insert data on the requested ``field`` and ``line``.
317 * - __u32
318 - ``field``
319 - The video field number this data has been captured from, or shall
322 * - __u32
323 - ``line``
324 - The field (as opposed to frame) line number this data has been
325 captured from, or shall be inserted at. See :ref:`vbi-525` and
326 :ref:`vbi-625` for valid values. Sliced VBI capture devices can
327 set the line number of all packets to ``0`` if the hardware cannot
330 * - __u32
331 - ``reserved``
332 - This field is reserved for future extensions. Applications and
334 * - __u8
335 - ``data``\ [48]
336 - The packet payload. See :ref:`vbi-services` for the contents and
341 Packets are always passed in ascending line number order, without
342 duplicate line numbers. The :c:func:`write()` function and
345 EINVAL error code when applications pass an incorrect field or line
346 number, or a combination of ``field``, ``line`` and ``id`` which has not
348 :ref:`VIDIOC_S_FMT <VIDIOC_G_FMT>` ioctl. When the line numbers are
349 unknown the driver must pass the packets in transmitted order. The
350 driver can insert empty packets with ``id`` set to zero anywhere in the
356 VBI data in time for output, the driver must output the last VPS and WSS
366 Sliced VBI Data in MPEG Streams
371 :ref:`negotiated sliced VBI services <sliced-vbi-format-negotitation>`
372 as data embedded in the MPEG stream. Users or applications control this
374 :ref:`V4L2_CID_MPEG_STREAM_VBI_FMT <v4l2-mpeg-stream-vbi-fmt>`
378 :ref:`V4L2_CID_MPEG_STREAM_VBI_FMT <v4l2-mpeg-stream-vbi-fmt>`
380 :ref:`V4L2_MPEG_STREAM_VBI_FMT_NONE <v4l2-mpeg-stream-vbi-fmt>`,
381 then the device cannot embed sliced VBI data in the MPEG stream.
384 :ref:`V4L2_CID_MPEG_STREAM_VBI_FMT <v4l2-mpeg-stream-vbi-fmt>`
387 VBI data in the MPEG stream, if an application has negotiated sliced VBI
390 It may also be the case that a device can embed sliced VBI data in only
391 certain types of MPEG streams: for example in an MPEG-2 PS but not an
392 MPEG-2 TS. In this situation, if sliced VBI data insertion is requested,
393 the sliced VBI data will be embedded in MPEG stream types when
401 --------------------------------------------------
404 :ref:`V4L2_MPEG_STREAM_VBI_FMT_NONE <v4l2-mpeg-stream-vbi-fmt>`
406 to cease embedding sliced VBI data in MPEG streams. Neither the device
407 nor driver shall insert "empty" embedded sliced VBI data packets in the
412 --------------------------------------------------
415 :ref:`V4L2_MPEG_STREAM_VBI_FMT_IVTV <v4l2-mpeg-stream-vbi-fmt>`
417 embed up to 36 lines of sliced VBI data per frame in an MPEG-2 *Private
418 Stream 1 PES* packet encapsulated in an MPEG-2 *Program Pack* in the
423 This format has already been informally specified in the kernel sources
424 in the file ``Documentation/userspace-api/media/drivers/cx2341x-uapi.rst`` . The
432 into the MPEG stream is implemented in driver software. At least the
433 ``cx18`` driver provides sliced VBI data insertion into an MPEG-2 PS in
436 The following definitions specify the payload of the MPEG-2 *Private
438 :ref:`V4L2_MPEG_STREAM_VBI_FMT_IVTV <v4l2-mpeg-stream-vbi-fmt>`
439 is set. (The MPEG-2 *Private Stream 1 PES* packet header and
440 encapsulating MPEG-2 *Program Pack* header are not detailed here. Please
441 refer to the MPEG-2 specifications for details on those packet headers.)
443 The payload of the MPEG-2 *Private Stream 1 PES* packets that contain
447 sliced VBI data present in a video frame. The payload may be padded at
449 4-byte boundary. The payload shall never exceed 1552 bytes (2 fields
450 with 18 lines/field with 43 bytes of data/line and a 4 byte magic
456 -----------------------------
460 .. flat-table::
461 :header-rows: 0
462 :stub-columns: 0
465 * - __u8
466 - ``magic``\ [4]
467 - A "magic" constant from :ref:`v4l2-mpeg-vbi-fmt-ivtv-magic` that
471 * - union {
472 - (anonymous)
473 * - struct :c:type:`v4l2_mpeg_vbi_itv0`
474 - ``itv0``
475 - The primary form of the sliced VBI data payload that contains
476 anywhere from 1 to 35 lines of sliced VBI data. Line masks are
477 provided in this form of the payload indicating which VBI lines
479 * - struct :ref:`v4l2_mpeg_vbi_ITV0 <v4l2-mpeg-vbi-itv0-1>`
480 - ``ITV0``
481 - An alternate form of the sliced VBI data payload used when 36
482 lines of sliced VBI data are present. No line masks are provided
483 in this form of the payload; all valid line mask bits are
485 * - }
486 -
488 .. _v4l2-mpeg-vbi-fmt-ivtv-magic:
491 -------------------------------------------------------------
495 .. flat-table::
496 :header-rows: 1
497 :stub-columns: 0
500 * - Defined Symbol
501 - Value
502 - Description
503 * - ``V4L2_MPEG_VBI_IVTV_MAGIC0``
504 - "itv0"
505 - Indicates the ``itv0`` member of the union in struct
508 * - ``V4L2_MPEG_VBI_IVTV_MAGIC1``
509 - "ITV0"
510 - Indicates the ``ITV0`` member of the union in struct
520 -------------------------------------------------
524 .. flat-table::
525 :header-rows: 0
526 :stub-columns: 0
529 * - __le32
530 - ``linemask``\ [2]
531 - Bitmasks indicating the VBI service lines present. These
532 ``linemask`` values are stored in little endian byte order in the
534 corresponding VBI line number and video field are given below.
541 linemask[0] b0: line 6 first field
542 linemask[0] b17: line 23 first field
543 linemask[0] b18: line 6 second field
544 linemask[0] b31: line 19 second field
545 linemask[1] b0: line 20 second field
546 linemask[1] b3: line 23 second field
547 linemask[1] b4-b31: unused and set to 0
548 * - struct
550 - ``line``\ [35]
551 - This is a variable length array that holds from 1 to 35 lines of
553 the bits set in the ``linemask`` array, starting from b\ :sub:`0`
556 ``linemask``\ [1]. ``line``\ [0] corresponds to the first bit
557 found set in the ``linemask`` array, ``line``\ [1] corresponds to
558 the second bit found set in the ``linemask`` array, etc. If no
559 ``linemask`` array bits are set, then ``line``\ [0] may contain
560 one line of unspecified data that should be ignored by
564 .. _v4l2-mpeg-vbi-itv0-1:
567 -------------------------
571 .. flat-table::
572 :header-rows: 0
573 :stub-columns: 0
576 * - struct
578 - ``line``\ [36]
579 - A fixed length array of 36 lines of sliced VBI data. ``line``\ [0]
580 through ``line``\ [17] correspond to lines 6 through 23 of the
581 first field. ``line``\ [18] through ``line``\ [35] corresponds to
588 ------------------------------
592 .. flat-table::
593 :header-rows: 0
594 :stub-columns: 0
597 * - __u8
598 - ``id``
599 - A line identifier value from
600 :ref:`ITV0-Line-Identifier-Constants` that indicates the type of
601 sliced VBI data stored on this line.
602 * - __u8
603 - ``data``\ [42]
604 - The sliced VBI data for the line.
607 .. _ITV0-Line-Identifier-Constants:
609 Line Identifiers for struct v4l2_mpeg_vbi_itv0_line id field
610 ------------------------------------------------------------
614 .. flat-table::
615 :header-rows: 1
616 :stub-columns: 0
619 * - Defined Symbol
620 - Value
621 - Description
622 * - ``V4L2_MPEG_VBI_IVTV_TELETEXT_B``
623 - 1
624 - Refer to :ref:`Sliced VBI services <vbi-services2>` for a
625 description of the line payload.
626 * - ``V4L2_MPEG_VBI_IVTV_CAPTION_525``
627 - 4
628 - Refer to :ref:`Sliced VBI services <vbi-services2>` for a
629 description of the line payload.
630 * - ``V4L2_MPEG_VBI_IVTV_WSS_625``
631 - 5
632 - Refer to :ref:`Sliced VBI services <vbi-services2>` for a
633 description of the line payload.
634 * - ``V4L2_MPEG_VBI_IVTV_VPS``
635 - 7
636 - Refer to :ref:`Sliced VBI services <vbi-services2>` for a
637 description of the line payload.
641 According to :ref:`ETS 300 706 <ets300706>` lines 6-22 of the first
642 field and lines 5-22 of the second field may carry Teletext data.
645 See also :ref:`vbi-525` and :ref:`vbi-625`.