Documentation/DocBook/media/v4l/pixfmt-y16-be.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
81

<refentry id="V4L2-PIX-FMT-Y16-BE">
  <refmeta>
    <refentrytitle>V4L2_PIX_FMT_Y16_BE ('Y16 ' | (1 &lt;&lt; 31))</refentrytitle>
    &manvol;
  </refmeta>
  <refnamediv>
    <refname><constant>V4L2_PIX_FMT_Y16_BE</constant></refname>
    <refpurpose>Grey-scale image</refpurpose>
  </refnamediv>
  <refsect1>
    <title>Description</title>

    <para>This is a grey-scale image with a depth of 16 bits per
pixel. The most significant byte is stored at lower memory addresses
(big-endian). Note the actual sampling precision may be lower than
16 bits, for example 10 bits per pixel with values in range 0 to
1023.</para>

    <example>
      <title><constant>V4L2_PIX_FMT_Y16_BE</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>00high</subscript></entry>
		  <entry>Y'<subscript>00low</subscript></entry>
		  <entry>Y'<subscript>01high</subscript></entry>
		  <entry>Y'<subscript>01low</subscript></entry>
		  <entry>Y'<subscript>02high</subscript></entry>
		  <entry>Y'<subscript>02low</subscript></entry>
		  <entry>Y'<subscript>03high</subscript></entry>
		  <entry>Y'<subscript>03low</subscript></entry>
		</row>
		<row>
		  <entry>start&nbsp;+&nbsp;8:</entry>
		  <entry>Y'<subscript>10high</subscript></entry>
		  <entry>Y'<subscript>10low</subscript></entry>
		  <entry>Y'<subscript>11high</subscript></entry>
		  <entry>Y'<subscript>11low</subscript></entry>
		  <entry>Y'<subscript>12high</subscript></entry>
		  <entry>Y'<subscript>12low</subscript></entry>
		  <entry>Y'<subscript>13high</subscript></entry>
		  <entry>Y'<subscript>13low</subscript></entry>
		</row>
		<row>
		  <entry>start&nbsp;+&nbsp;16:</entry>
		  <entry>Y'<subscript>20high</subscript></entry>
		  <entry>Y'<subscript>20low</subscript></entry>
		  <entry>Y'<subscript>21high</subscript></entry>
		  <entry>Y'<subscript>21low</subscript></entry>
		  <entry>Y'<subscript>22high</subscript></entry>
		  <entry>Y'<subscript>22low</subscript></entry>
		  <entry>Y'<subscript>23high</subscript></entry>
		  <entry>Y'<subscript>23low</subscript></entry>
		</row>
		<row>
		  <entry>start&nbsp;+&nbsp;24:</entry>
		  <entry>Y'<subscript>30high</subscript></entry>
		  <entry>Y'<subscript>30low</subscript></entry>
		  <entry>Y'<subscript>31high</subscript></entry>
		  <entry>Y'<subscript>31low</subscript></entry>
		  <entry>Y'<subscript>32high</subscript></entry>
		  <entry>Y'<subscript>32low</subscript></entry>
		  <entry>Y'<subscript>33high</subscript></entry>
		  <entry>Y'<subscript>33low</subscript></entry>
		</row>
	      </tbody>
	    </tgroup>
	  </informaltable>
	</para>
      </formalpara>
    </example>
  </refsect1>
</refentry>