1 .. SPDX-License-Identifier: GFDL-1.1-no-invari 1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2 2
3 .. _v4l2-meta-fmt-vsp1-hgo: 3 .. _v4l2-meta-fmt-vsp1-hgo:
4 4
5 ******************************* 5 *******************************
6 V4L2_META_FMT_VSP1_HGO ('VSPH') 6 V4L2_META_FMT_VSP1_HGO ('VSPH')
7 ******************************* 7 *******************************
8 8
9 Renesas R-Car VSP1 1-D Histogram Data 9 Renesas R-Car VSP1 1-D Histogram Data
10 10
11 11
12 Description 12 Description
13 =========== 13 ===========
14 14
15 This format describes histogram data generated 15 This format describes histogram data generated by the Renesas R-Car VSP1 1-D
16 Histogram (HGO) engine. 16 Histogram (HGO) engine.
17 17
18 The VSP1 HGO is a histogram computation engine 18 The VSP1 HGO is a histogram computation engine that can operate on RGB, YCrCb
19 or HSV data. It operates on a possibly cropped 19 or HSV data. It operates on a possibly cropped and subsampled input image and
20 computes the minimum, maximum and sum of all p 20 computes the minimum, maximum and sum of all pixels as well as per-channel
21 histograms. 21 histograms.
22 22
23 The HGO can compute histograms independently p 23 The HGO can compute histograms independently per channel, on the maximum of the
24 three channels (RGB data only) or on the Y cha 24 three channels (RGB data only) or on the Y channel only (YCbCr only). It can
25 additionally output the histogram with 64 or 2 25 additionally output the histogram with 64 or 256 bins, resulting in four
26 possible modes of operation. 26 possible modes of operation.
27 27
28 - In *64 bins normal mode*, the HGO operates o 28 - In *64 bins normal mode*, the HGO operates on the three channels independently
29 to compute three 64-bins histograms. RGB, YC 29 to compute three 64-bins histograms. RGB, YCbCr and HSV image formats are
30 supported. 30 supported.
31 - In *64 bins maximum mode*, the HGO operates 31 - In *64 bins maximum mode*, the HGO operates on the maximum of the (R, G, B)
32 channels to compute a single 64-bins histogr 32 channels to compute a single 64-bins histogram. Only the RGB image format is
33 supported. 33 supported.
34 - In *256 bins normal mode*, the HGO operates 34 - In *256 bins normal mode*, the HGO operates on the Y channel to compute a
35 single 256-bins histogram. Only the YCbCr im 35 single 256-bins histogram. Only the YCbCr image format is supported.
36 - In *256 bins maximum mode*, the HGO operates 36 - In *256 bins maximum mode*, the HGO operates on the maximum of the (R, G, B)
37 channels to compute a single 256-bins histog 37 channels to compute a single 256-bins histogram. Only the RGB image format is
38 supported. 38 supported.
39 39
40 **Byte Order.** 40 **Byte Order.**
41 All data is stored in memory in little endian 41 All data is stored in memory in little endian format. Each cell in the tables
42 contains one byte. 42 contains one byte.
43 43
44 .. flat-table:: VSP1 HGO Data - 64 Bins, Norma 44 .. flat-table:: VSP1 HGO Data - 64 Bins, Normal Mode (792 bytes)
45 :header-rows: 2 45 :header-rows: 2
46 :stub-columns: 0 46 :stub-columns: 0
47 47
48 * - Offset 48 * - Offset
49 - :cspan:`4` Memory 49 - :cspan:`4` Memory
50 * - 50 * -
51 - [31:24] 51 - [31:24]
52 - [23:16] 52 - [23:16]
53 - [15:8] 53 - [15:8]
54 - [7:0] 54 - [7:0]
55 * - 0 55 * - 0
56 - 56 -
57 - R/Cr/H max [7:0] 57 - R/Cr/H max [7:0]
58 - 58 -
59 - R/Cr/H min [7:0] 59 - R/Cr/H min [7:0]
60 * - 4 60 * - 4
61 - 61 -
62 - G/Y/S max [7:0] 62 - G/Y/S max [7:0]
63 - 63 -
64 - G/Y/S min [7:0] 64 - G/Y/S min [7:0]
65 * - 8 65 * - 8
66 - 66 -
67 - B/Cb/V max [7:0] 67 - B/Cb/V max [7:0]
68 - 68 -
69 - B/Cb/V min [7:0] 69 - B/Cb/V min [7:0]
70 * - 12 70 * - 12
71 - :cspan:`4` R/Cr/H sum [31:0] 71 - :cspan:`4` R/Cr/H sum [31:0]
72 * - 16 72 * - 16
73 - :cspan:`4` G/Y/S sum [31:0] 73 - :cspan:`4` G/Y/S sum [31:0]
74 * - 20 74 * - 20
75 - :cspan:`4` B/Cb/V sum [31:0] 75 - :cspan:`4` B/Cb/V sum [31:0]
76 * - 24 76 * - 24
77 - :cspan:`4` R/Cr/H bin 0 [31:0] 77 - :cspan:`4` R/Cr/H bin 0 [31:0]
78 * - 78 * -
79 - :cspan:`4` ... 79 - :cspan:`4` ...
80 * - 276 80 * - 276
81 - :cspan:`4` R/Cr/H bin 63 [31:0] 81 - :cspan:`4` R/Cr/H bin 63 [31:0]
82 * - 280 82 * - 280
83 - :cspan:`4` G/Y/S bin 0 [31:0] 83 - :cspan:`4` G/Y/S bin 0 [31:0]
84 * - 84 * -
85 - :cspan:`4` ... 85 - :cspan:`4` ...
86 * - 532 86 * - 532
87 - :cspan:`4` G/Y/S bin 63 [31:0] 87 - :cspan:`4` G/Y/S bin 63 [31:0]
88 * - 536 88 * - 536
89 - :cspan:`4` B/Cb/V bin 0 [31:0] 89 - :cspan:`4` B/Cb/V bin 0 [31:0]
90 * - 90 * -
91 - :cspan:`4` ... 91 - :cspan:`4` ...
92 * - 788 92 * - 788
93 - :cspan:`4` B/Cb/V bin 63 [31:0] 93 - :cspan:`4` B/Cb/V bin 63 [31:0]
94 94
95 .. flat-table:: VSP1 HGO Data - 64 Bins, Max M 95 .. flat-table:: VSP1 HGO Data - 64 Bins, Max Mode (264 bytes)
96 :header-rows: 2 96 :header-rows: 2
97 :stub-columns: 0 97 :stub-columns: 0
98 98
99 * - Offset 99 * - Offset
100 - :cspan:`4` Memory 100 - :cspan:`4` Memory
101 * - 101 * -
102 - [31:24] 102 - [31:24]
103 - [23:16] 103 - [23:16]
104 - [15:8] 104 - [15:8]
105 - [7:0] 105 - [7:0]
106 * - 0 106 * - 0
107 - 107 -
108 - max(R,G,B) max [7:0] 108 - max(R,G,B) max [7:0]
109 - 109 -
110 - max(R,G,B) min [7:0] 110 - max(R,G,B) min [7:0]
111 * - 4 111 * - 4
112 - :cspan:`4` max(R,G,B) sum [31:0] 112 - :cspan:`4` max(R,G,B) sum [31:0]
113 * - 8 113 * - 8
114 - :cspan:`4` max(R,G,B) bin 0 [31:0] 114 - :cspan:`4` max(R,G,B) bin 0 [31:0]
115 * - 115 * -
116 - :cspan:`4` ... 116 - :cspan:`4` ...
117 * - 260 117 * - 260
118 - :cspan:`4` max(R,G,B) bin 63 [31:0] 118 - :cspan:`4` max(R,G,B) bin 63 [31:0]
119 119
120 .. flat-table:: VSP1 HGO Data - 256 Bins, Norm 120 .. flat-table:: VSP1 HGO Data - 256 Bins, Normal Mode (1032 bytes)
121 :header-rows: 2 121 :header-rows: 2
122 :stub-columns: 0 122 :stub-columns: 0
123 123
124 * - Offset 124 * - Offset
125 - :cspan:`4` Memory 125 - :cspan:`4` Memory
126 * - 126 * -
127 - [31:24] 127 - [31:24]
128 - [23:16] 128 - [23:16]
129 - [15:8] 129 - [15:8]
130 - [7:0] 130 - [7:0]
131 * - 0 131 * - 0
132 - 132 -
133 - Y max [7:0] 133 - Y max [7:0]
134 - 134 -
135 - Y min [7:0] 135 - Y min [7:0]
136 * - 4 136 * - 4
137 - :cspan:`4` Y sum [31:0] 137 - :cspan:`4` Y sum [31:0]
138 * - 8 138 * - 8
139 - :cspan:`4` Y bin 0 [31:0] 139 - :cspan:`4` Y bin 0 [31:0]
140 * - 140 * -
141 - :cspan:`4` ... 141 - :cspan:`4` ...
142 * - 1028 142 * - 1028
143 - :cspan:`4` Y bin 255 [31:0] 143 - :cspan:`4` Y bin 255 [31:0]
144 144
145 .. flat-table:: VSP1 HGO Data - 256 Bins, Max 145 .. flat-table:: VSP1 HGO Data - 256 Bins, Max Mode (1032 bytes)
146 :header-rows: 2 146 :header-rows: 2
147 :stub-columns: 0 147 :stub-columns: 0
148 148
149 * - Offset 149 * - Offset
150 - :cspan:`4` Memory 150 - :cspan:`4` Memory
151 * - 151 * -
152 - [31:24] 152 - [31:24]
153 - [23:16] 153 - [23:16]
154 - [15:8] 154 - [15:8]
155 - [7:0] 155 - [7:0]
156 * - 0 156 * - 0
157 - 157 -
158 - max(R,G,B) max [7:0] 158 - max(R,G,B) max [7:0]
159 - 159 -
160 - max(R,G,B) min [7:0] 160 - max(R,G,B) min [7:0]
161 * - 4 161 * - 4
162 - :cspan:`4` max(R,G,B) sum [31:0] 162 - :cspan:`4` max(R,G,B) sum [31:0]
163 * - 8 163 * - 8
164 - :cspan:`4` max(R,G,B) bin 0 [31:0] 164 - :cspan:`4` max(R,G,B) bin 0 [31:0]
165 * - 165 * -
166 - :cspan:`4` ... 166 - :cspan:`4` ...
167 * - 1028 167 * - 1028
168 - :cspan:`4` max(R,G,B) bin 255 [31:0] 168 - :cspan:`4` max(R,G,B) bin 255 [31:0]
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.