Lines Matching +full:per +full:- +full:stream
1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
17 :ref:`raw VBI interface <raw-vbi>`. The data is passed as short
19 packets per video frame is variable.
51 .. _sliced-vbi-format-negotitation:
62 lines the hardware can capture or output per frame, or the number of
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
130 a driver for the cx25840 video decoder sets lines 7-22 of both
140 * - __u16
141 - ``service_lines``\ [2][24]
142 - :cspan:`2`
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
188 * - __u32
189 - ``io_size``
190 - :cspan:`2` Maximum number of bytes passed by one
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 - See :ref:`v4l2-sliced-wss-625-payload` below.
257 * - ``V4L2_SLICED_VBI_525``
258 - 0x1000
259 - :cspan:`2` Set of services applicable to 525 line systems.
260 * - ``V4L2_SLICED_VBI_625``
261 - 0x4401
262 - :cspan:`2` Set of services applicable to 625 line systems.
279 .. _v4l2-sliced-wss-625-payload:
286 +-----+------------------+-----------------------+
288 +-----+--------+---------+-----------+-----------+
290 | +-+-+-+--+--+-+-+--+--+-+--+---+---+--+-+--+
292 +-----+-+-+-+--+--+-+-+--+--+-+--+---+---+--+-+--+
308 ---------------------------
312 .. flat-table::
313 :header-rows: 0
314 :stub-columns: 0
317 * - __u32
318 - ``id``
319 - A flag from :ref:`vbi-services` identifying the type of data in
326 * - __u32
327 - ``field``
328 - The video field number this data has been captured from, or shall
331 * - __u32
332 - ``line``
333 - The field (as opposed to frame) line number this data has been
334 captured from, or shall be inserted at. See :ref:`vbi-525` and
335 :ref:`vbi-625` for valid values. Sliced VBI capture devices can
339 * - __u32
340 - ``reserved``
341 - This field is reserved for future extensions. Applications and
343 * - __u8
344 - ``data``\ [48]
345 - The packet payload. See :ref:`vbi-services` for the contents and
378 If a device can produce an MPEG output stream, it may be capable of
380 :ref:`negotiated sliced VBI services <sliced-vbi-format-negotitation>`
381 as data embedded in the MPEG stream. Users or applications control this
383 :ref:`V4L2_CID_MPEG_STREAM_VBI_FMT <v4l2-mpeg-stream-vbi-fmt>`
387 :ref:`V4L2_CID_MPEG_STREAM_VBI_FMT <v4l2-mpeg-stream-vbi-fmt>`
389 :ref:`V4L2_MPEG_STREAM_VBI_FMT_NONE <v4l2-mpeg-stream-vbi-fmt>`,
390 then the device cannot embed sliced VBI data in the MPEG stream.
393 :ref:`V4L2_CID_MPEG_STREAM_VBI_FMT <v4l2-mpeg-stream-vbi-fmt>`
396 VBI data in the MPEG stream, if an application has negotiated sliced VBI
400 certain types of MPEG streams: for example in an MPEG-2 PS but not an
401 MPEG-2 TS. In this situation, if sliced VBI data insertion is requested,
402 the sliced VBI data will be embedded in MPEG stream types when
403 supported, and silently omitted from MPEG stream types where sliced VBI
409 MPEG Stream Embedded, Sliced VBI Data Format: NONE
410 --------------------------------------------------
413 :ref:`V4L2_MPEG_STREAM_VBI_FMT_NONE <v4l2-mpeg-stream-vbi-fmt>`
417 MPEG stream when this format is set. No MPEG stream data structures are
420 MPEG Stream Embedded, Sliced VBI Data Format: IVTV
421 --------------------------------------------------
424 :ref:`V4L2_MPEG_STREAM_VBI_FMT_IVTV <v4l2-mpeg-stream-vbi-fmt>`
426 embed up to 36 lines of sliced VBI data per frame in an MPEG-2 *Private
427 Stream 1 PES* packet encapsulated in an MPEG-2 *Program Pack* in the
428 MPEG stream.
433 in the file ``Documentation/userspace-api/media/drivers/cx2341x-uapi.rst`` . The
437 an MPEG stream.
441 into the MPEG stream is implemented in driver software. At least the
442 ``cx18`` driver provides sliced VBI data insertion into an MPEG-2 PS in
445 The following definitions specify the payload of the MPEG-2 *Private
446 Stream 1 PES* packets that contain sliced VBI data when
447 :ref:`V4L2_MPEG_STREAM_VBI_FMT_IVTV <v4l2-mpeg-stream-vbi-fmt>`
448 is set. (The MPEG-2 *Private Stream 1 PES* packet header and
449 encapsulating MPEG-2 *Program Pack* header are not detailed here. Please
450 refer to the MPEG-2 specifications for details on those packet headers.)
452 The payload of the MPEG-2 *Private Stream 1 PES* packets that contain
458 4-byte boundary. The payload shall never exceed 1552 bytes (2 fields
465 -----------------------------
469 .. flat-table::
470 :header-rows: 0
471 :stub-columns: 0
474 * - __u8
475 - ``magic``\ [4]
476 - A "magic" constant from :ref:`v4l2-mpeg-vbi-fmt-ivtv-magic` that
480 * - union {
481 - (anonymous)
482 * - struct :c:type:`v4l2_mpeg_vbi_itv0`
483 - ``itv0``
484 - The primary form of the sliced VBI data payload that contains
488 * - struct :ref:`v4l2_mpeg_vbi_ITV0 <v4l2-mpeg-vbi-itv0-1>`
489 - ``ITV0``
490 - An alternate form of the sliced VBI data payload used when 36
494 * - }
495 -
497 .. _v4l2-mpeg-vbi-fmt-ivtv-magic:
500 -------------------------------------------------------------
504 .. flat-table::
505 :header-rows: 1
506 :stub-columns: 0
509 * - Defined Symbol
510 - Value
511 - Description
512 * - ``V4L2_MPEG_VBI_IVTV_MAGIC0``
513 - "itv0"
514 - Indicates the ``itv0`` member of the union in struct
517 * - ``V4L2_MPEG_VBI_IVTV_MAGIC1``
518 - "ITV0"
519 - Indicates the ``ITV0`` member of the union in struct
529 -------------------------------------------------
537 .. flat-table::
538 :header-rows: 0
539 :stub-columns: 0
542 * - __le32
543 - ``linemask``\ [2]
544 - Bitmasks indicating the VBI service lines present. These
546 MPEG stream. Some reference ``linemask`` bit positions with their
560 linemask[1] b4-b31: unused and set to 0
561 * - struct
563 - ``line``\ [35]
564 - This is a variable length array that holds from 1 to 35 lines of
580 .. _v4l2-mpeg-vbi-itv0-1:
583 -------------------------
587 .. flat-table::
588 :header-rows: 0
589 :stub-columns: 0
592 * - struct
594 - ``line``\ [36]
595 - A fixed length array of 36 lines of sliced VBI data. ``line``\ [0]
604 ------------------------------
608 .. flat-table::
609 :header-rows: 0
610 :stub-columns: 0
613 * - __u8
614 - ``id``
615 - A line identifier value from
616 :ref:`ITV0-Line-Identifier-Constants` that indicates the type of
618 * - __u8
619 - ``data``\ [42]
620 - The sliced VBI data for the line.
623 .. _ITV0-Line-Identifier-Constants:
626 ------------------------------------------------------------
630 .. flat-table::
631 :header-rows: 1
632 :stub-columns: 0
635 * - Defined Symbol
636 - Value
637 - Description
638 * - ``V4L2_MPEG_VBI_IVTV_TELETEXT_B``
639 - 1
640 - Refer to :ref:`Sliced VBI services <vbi-services2>` for a
642 * - ``V4L2_MPEG_VBI_IVTV_CAPTION_525``
643 - 4
644 - Refer to :ref:`Sliced VBI services <vbi-services2>` for a
646 * - ``V4L2_MPEG_VBI_IVTV_WSS_625``
647 - 5
648 - Refer to :ref:`Sliced VBI services <vbi-services2>` for a
650 * - ``V4L2_MPEG_VBI_IVTV_VPS``
651 - 7
652 - Refer to :ref:`Sliced VBI services <vbi-services2>` for a
657 According to :ref:`ETS 300 706 <ets300706>` lines 6-22 of the first
658 field and lines 5-22 of the second field may carry Teletext data.
661 See also :ref:`vbi-525` and :ref:`vbi-625`.