Documentation/DocBook/media/v4l/pixfmt-y8i.xml


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80

<refentry id="V4L2-PIX-FMT-Y8I">
  <refmeta>
    <refentrytitle>V4L2_PIX_FMT_Y8I ('Y8I ')</refentrytitle>
    &manvol;
  </refmeta>
  <refnamediv>
    <refname><constant>V4L2_PIX_FMT_Y8I</constant></refname>
    <refpurpose>Interleaved grey-scale image, e.g. from a stereo-pair</refpurpose>
  </refnamediv>
  <refsect1>
    <title>Description</title>

    <para>This is a grey-scale image with a depth of 8 bits per pixel, but with
pixels from 2 sources interleaved. Each pixel is stored in a 16-bit word. E.g.
the R200 RealSense camera stores pixel from the left sensor in lower and from
the right sensor in the higher 8 bits.</para>

    <example>
      <title><constant>V4L2_PIX_FMT_Y8I</constant> 4 &times; 4
pixel image</title>

      <formalpara>
	<title>Byte Order.</title>
	<para>Each cell is one byte.
	  <informaltable frame="none">
	    <tgroup cols="9" align="center">
	      <colspec align="left" colwidth="2*" />
	      <tbody valign="top">
		<row>
		  <entry>start&nbsp;+&nbsp;0:</entry>
		  <entry>Y'<subscript>00left</subscript></entry>
		  <entry>Y'<subscript>00right</subscript></entry>
		  <entry>Y'<subscript>01left</subscript></entry>
		  <entry>Y'<subscript>01right</subscript></entry>
		  <entry>Y'<subscript>02left</subscript></entry>
		  <entry>Y'<subscript>02right</subscript></entry>
		  <entry>Y'<subscript>03left</subscript></entry>
		  <entry>Y'<subscript>03right</subscript></entry>
		</row>
		<row>
		  <entry>start&nbsp;+&nbsp;8:</entry>
		  <entry>Y'<subscript>10left</subscript></entry>
		  <entry>Y'<subscript>10right</subscript></entry>
		  <entry>Y'<subscript>11left</subscript></entry>
		  <entry>Y'<subscript>11right</subscript></entry>
		  <entry>Y'<subscript>12left</subscript></entry>
		  <entry>Y'<subscript>12right</subscript></entry>
		  <entry>Y'<subscript>13left</subscript></entry>
		  <entry>Y'<subscript>13right</subscript></entry>
		</row>
		<row>
		  <entry>start&nbsp;+&nbsp;16:</entry>
		  <entry>Y'<subscript>20left</subscript></entry>
		  <entry>Y'<subscript>20right</subscript></entry>
		  <entry>Y'<subscript>21left</subscript></entry>
		  <entry>Y'<subscript>21right</subscript></entry>
		  <entry>Y'<subscript>22left</subscript></entry>
		  <entry>Y'<subscript>22right</subscript></entry>
		  <entry>Y'<subscript>23left</subscript></entry>
		  <entry>Y'<subscript>23right</subscript></entry>
		</row>
		<row>
		  <entry>start&nbsp;+&nbsp;24:</entry>
		  <entry>Y'<subscript>30left</subscript></entry>
		  <entry>Y'<subscript>30right</subscript></entry>
		  <entry>Y'<subscript>31left</subscript></entry>
		  <entry>Y'<subscript>31right</subscript></entry>
		  <entry>Y'<subscript>32left</subscript></entry>
		  <entry>Y'<subscript>32right</subscript></entry>
		  <entry>Y'<subscript>33left</subscript></entry>
		  <entry>Y'<subscript>33right</subscript></entry>
		</row>
	      </tbody>
	    </tgroup>
	  </informaltable>
	</para>
      </formalpara>
    </example>
  </refsect1>
</refentry>