← Back to branch summary

~ubuntu-branches/ubuntu/trusty/linux-armadaxp/trusty

« back to all changes in this revision

Viewing changes to Documentation/DocBook/v4l/pixfmt-yuv420m.xml

  • Committer: Package Import Robot
  • Author(s): Michael Casadevall, Bryan Wu, Dann Frazier, Michael Casadeall
  • Date: 2012-03-10 15:00:54 UTC
  • mfrom: (1.1.1)
  • Revision ID: package-import@ubuntu.com-20120310150054-flugb39zon8vvgwe
Tags: 3.2.0-1600.1
[ Bryan Wu ]
* UBUNTU: import debian/debian.env and debian.armadaxp

[ Dann Frazier ]
* ARM: Armada XP: remove trailing '/' in dirnames in mvRules.mk

[ Michael Casadeall ]
* tools: add some tools for Marvell Armada XP processor
* kernel: timer tick hacking from Marvell
* kernel: Sheeva Errata: add delay on Sheeva when powering down
* net: add Marvell NFP netfilter
* net: socket and skb modifications made by Marvell
* miscdevice: add minor IDs for some Marvell Armada drivers
* fs: introduce memory pool for splice()
* video: EDID detection updates from Marvell Armada XP patchset
* video: backlight: add Marvell Dove LCD backlight driver
* video: display: add THS8200 display driver
* video: framebuffer: add Marvell Dove and Armada XP processor onchip LCD controller driver
* usbtest: add Interrupt transfer testing by Marvell Armada XP code
* usb: ehci: add support for Marvell EHCI controler
* tty/serial: 8250: add support for Marvell Armada XP processor and DeviceTree work
* rtc: add support for Marvell Armada XP onchip RTC controller
* net: pppoe: add Marvell ethernet NFP hook in PPPoE networking driver
* mtd: nand: add support for Marvell Armada XP Nand Flash Controller
* mtd: maps: add Marvell Armada XP specific map driver
* mmc: add support for Marvell Armada XP MMC/SD host controller
* i2c: add support for Marvell Armada XP onchip i2c bus controller
* hwmon: add Kconfig option for Armada XP onchip thermal sensor driver
* dmaengine: add Net DMA support for splice and update Marvell XOR DMA engine driver
* ata: add support for Marvell Armada XP SATA controller and update some quirks
* ARM: add Marvell Armada XP machine to mach-types
* ARM: oprofile: add support for Marvell PJ4B core
* ARM: mm: more ARMv6 switches for Marvell Armada XP
* ARM: remove static declaration to allow compilation
* ARM: alignment access fault trick
* ARM: mm: skip some fault fixing when run on NONE SMP ARMv6 mode during early abort event
* ARM: mm: add Marvell Sheeva CPU Architecture for PJ4B
* ARM: introduce optimized copy operation for Marvell Armada XP
* ARM: SAUCE: hardware breakpoint trick for Marvell Armada XP
* ARM: big endian and little endian tricks for Marvell Armada XP
* ARM: SAUCE: Add Marvell Armada XP build rules to arch/arm/kernel/Makefile
* ARM: vfp: add special handling for Marvell Armada XP
* ARM: add support for Marvell U-Boot
* ARM: add mv_controller_num for ARM PCI drivers
* ARM: add support for local PMUs, general SMP tweaks and cache flushing
* ARM: add Marvell device identifies in glue-proc.h
* ARM: add IPC driver support for Marvell platforms
* ARM: add DMA mapping for Marvell platforms
* ARM: add Sheeva errata and PJ4B code for booting
* ARM: update Kconfig and Makefile to include Marvell Armada XP platforms
* ARM: Armada XP: import LSP from Marvell for Armada XP 3.2 kernel enablement

Show diffs side-by-side

added added

removed removed

Lines of Context:
Documentation/DocBook/v4l/pixfmt-yuv420m.xml
1
 
    <refentry id="V4L2-PIX-FMT-YUV420M">
2
 
      <refmeta>
3
 
        <refentrytitle>V4L2_PIX_FMT_YUV420M ('YU12M')</refentrytitle>
4
 
        &manvol;
5
 
      </refmeta>
6
 
      <refnamediv>
7
 
        <refname> <constant>V4L2_PIX_FMT_YUV420M</constant></refname>
8
 
        <refpurpose>Variation of <constant>V4L2_PIX_FMT_YUV420</constant>
9
 
          with planes non contiguous in memory. </refpurpose>
10
 
      </refnamediv>
11
 
 
12
 
      <refsect1>
13
 
        <title>Description</title>
14
 
 
15
 
        <para>This is a multi-planar format, as opposed to a packed format.
16
 
The three components are separated into three sub- images or planes.
17
 
 
18
 
The Y plane is first. The Y plane has one byte per pixel. The Cb data
19
 
constitutes the second plane which is half the width and half
20
 
the height of the Y plane (and of the image). Each Cb belongs to four
21
 
pixels, a two-by-two square of the image. For example,
22
 
Cb<subscript>0</subscript> belongs to Y'<subscript>00</subscript>,
23
 
Y'<subscript>01</subscript>, Y'<subscript>10</subscript>, and
24
 
Y'<subscript>11</subscript>. The Cr data, just like the Cb plane, is
25
 
in the third plane. </para>
26
 
 
27
 
        <para>If the Y plane has pad bytes after each row, then the Cb
28
 
and Cr planes have half as many pad bytes after their rows. In other
29
 
words, two Cx rows (including padding) is exactly as long as one Y row
30
 
(including padding).</para>
31
 
 
32
 
        <para><constant>V4L2_PIX_FMT_NV12M</constant> is intended to be
33
 
used only in drivers and applications that support the multi-planar API,
34
 
described in <xref linkend="planar-apis"/>. </para>
35
 
 
36
 
        <example>
37
 
          <title><constant>V4L2_PIX_FMT_YVU420M</constant> 4 &times; 4
38
 
pixel image</title>
39
 
 
40
 
          <formalpara>
41
 
            <title>Byte Order.</title>
42
 
            <para>Each cell is one byte.
43
 
                <informaltable frame="none">
44
 
                <tgroup cols="5" align="center">
45
 
                  <colspec align="left" colwidth="2*" />
46
 
                  <tbody valign="top">
47
 
                    <row>
48
 
                      <entry>start0&nbsp;+&nbsp;0:</entry>
49
 
                      <entry>Y'<subscript>00</subscript></entry>
50
 
                      <entry>Y'<subscript>01</subscript></entry>
51
 
                      <entry>Y'<subscript>02</subscript></entry>
52
 
                      <entry>Y'<subscript>03</subscript></entry>
53
 
                    </row>
54
 
                    <row>
55
 
                      <entry>start0&nbsp;+&nbsp;4:</entry>
56
 
                      <entry>Y'<subscript>10</subscript></entry>
57
 
                      <entry>Y'<subscript>11</subscript></entry>
58
 
                      <entry>Y'<subscript>12</subscript></entry>
59
 
                      <entry>Y'<subscript>13</subscript></entry>
60
 
                    </row>
61
 
                    <row>
62
 
                      <entry>start0&nbsp;+&nbsp;8:</entry>
63
 
                      <entry>Y'<subscript>20</subscript></entry>
64
 
                      <entry>Y'<subscript>21</subscript></entry>
65
 
                      <entry>Y'<subscript>22</subscript></entry>
66
 
                      <entry>Y'<subscript>23</subscript></entry>
67
 
                    </row>
68
 
                    <row>
69
 
                      <entry>start0&nbsp;+&nbsp;12:</entry>
70
 
                      <entry>Y'<subscript>30</subscript></entry>
71
 
                      <entry>Y'<subscript>31</subscript></entry>
72
 
                      <entry>Y'<subscript>32</subscript></entry>
73
 
                      <entry>Y'<subscript>33</subscript></entry>
74
 
                    </row>
75
 
                    <row><entry></entry></row>
76
 
                    <row>
77
 
                      <entry>start1&nbsp;+&nbsp;0:</entry>
78
 
                      <entry>Cb<subscript>00</subscript></entry>
79
 
                      <entry>Cb<subscript>01</subscript></entry>
80
 
                    </row>
81
 
                    <row>
82
 
                      <entry>start1&nbsp;+&nbsp;2:</entry>
83
 
                      <entry>Cb<subscript>10</subscript></entry>
84
 
                      <entry>Cb<subscript>11</subscript></entry>
85
 
                    </row>
86
 
                    <row><entry></entry></row>
87
 
                    <row>
88
 
                      <entry>start2&nbsp;+&nbsp;0:</entry>
89
 
                      <entry>Cr<subscript>00</subscript></entry>
90
 
                      <entry>Cr<subscript>01</subscript></entry>
91
 
                    </row>
92
 
                    <row>
93
 
                      <entry>start2&nbsp;+&nbsp;2:</entry>
94
 
                      <entry>Cr<subscript>10</subscript></entry>
95
 
                      <entry>Cr<subscript>11</subscript></entry>
96
 
                    </row>
97
 
                  </tbody>
98
 
                </tgroup>
99
 
                </informaltable>
100
 
              </para>
101
 
          </formalpara>
102
 
 
103
 
          <formalpara>
104
 
            <title>Color Sample Location.</title>
105
 
            <para>
106
 
                <informaltable frame="none">
107
 
                <tgroup cols="7" align="center">
108
 
                  <tbody valign="top">
109
 
                    <row>
110
 
                      <entry></entry>
111
 
                      <entry>0</entry><entry></entry><entry>1</entry><entry></entry>
112
 
                      <entry>2</entry><entry></entry><entry>3</entry>
113
 
                    </row>
114
 
                    <row>
115
 
                      <entry>0</entry>
116
 
                      <entry>Y</entry><entry></entry><entry>Y</entry><entry></entry>
117
 
                      <entry>Y</entry><entry></entry><entry>Y</entry>
118
 
                    </row>
119
 
                    <row>
120
 
                      <entry></entry>
121
 
                      <entry></entry><entry>C</entry><entry></entry><entry></entry>
122
 
                      <entry></entry><entry>C</entry><entry></entry>
123
 
                    </row>
124
 
                    <row>
125
 
                      <entry>1</entry>
126
 
                      <entry>Y</entry><entry></entry><entry>Y</entry><entry></entry>
127
 
                      <entry>Y</entry><entry></entry><entry>Y</entry>
128
 
                    </row>
129
 
                    <row>
130
 
                      <entry></entry>
131
 
                    </row>
132
 
                    <row>
133
 
                      <entry>2</entry>
134
 
                      <entry>Y</entry><entry></entry><entry>Y</entry><entry></entry>
135
 
                      <entry>Y</entry><entry></entry><entry>Y</entry>
136
 
                    </row>
137
 
                    <row>
138
 
                      <entry></entry>
139
 
                      <entry></entry><entry>C</entry><entry></entry><entry></entry>
140
 
                      <entry></entry><entry>C</entry><entry></entry>
141
 
                    </row>
142
 
                    <row>
143
 
                      <entry>3</entry>
144
 
                      <entry>Y</entry><entry></entry><entry>Y</entry><entry></entry>
145
 
                      <entry>Y</entry><entry></entry><entry>Y</entry>
146
 
                    </row>
147
 
                  </tbody>
148
 
                </tgroup>
149
 
                </informaltable>
150
 
              </para>
151
 
          </formalpara>
152
 
        </example>
153
 
      </refsect1>
154
 
    </refentry>
155
 
 
156
 
  <!--
157
 
Local Variables:
158
 
mode: sgml
159
 
sgml-parent-document: "pixfmt.sgml"
160
 
indent-tabs-mode: nil
161
 
End:
162
 
  -->