i965: add and fix fallthrough comments
[mesa.git] / src / panfrost / pandecode / pan_pretty_print.c
1 /*
2 * © Copyright 2017-2098 The Panfrost Communiy
3 *
4 * Permission is hereby granted, free of charge, to any person obtaining a
5 * copy of this software and associated documentation files (the "Software"),
6 * to deal in the Software without restriction, including without limitation
7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8 * and/or sell copies of the Software, and to permit persons to whom the
9 * Software is furnished to do so, subject to the following conditions:
10 *
11 * The above copyright notice and this permission notice (including the next
12 * paragraph) shall be included in all copies or substantial portions of the
13 * Software.
14 *
15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
18 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 * SOFTWARE.
22 */
23
24 #include "pan_pretty_print.h"
25
26 #include <stdio.h>
27 #include <string.h>
28 #include <assert.h>
29
30 /* Some self-contained prettyprinting functions shared between pandecode and
31 * the main driver */
32
33 #define DEFINE_CASE(name) case MALI_## name: return "MALI_" #name
34 char *pandecode_format(enum mali_format format)
35 {
36 static char unk_format_str[10];
37
38 switch (format) {
39 DEFINE_CASE(ETC2_RGB8);
40 DEFINE_CASE(ETC2_R11_UNORM);
41 DEFINE_CASE(ETC2_RGBA8);
42 DEFINE_CASE(ETC2_RG11_UNORM);
43 DEFINE_CASE(ETC2_R11_SNORM);
44 DEFINE_CASE(ETC2_RG11_SNORM);
45 DEFINE_CASE(ETC2_RGB8A1);
46 DEFINE_CASE(ASTC_SRGB_SUPP);
47 DEFINE_CASE(ASTC_HDR_SUPP);
48 DEFINE_CASE(RGB565);
49 DEFINE_CASE(RGB5_X1_UNORM);
50 DEFINE_CASE(RGB5_A1_UNORM);
51 DEFINE_CASE(RGB10_A2_UNORM);
52 DEFINE_CASE(RGB10_A2_SNORM);
53 DEFINE_CASE(RGB10_A2UI);
54 DEFINE_CASE(RGB10_A2I);
55 DEFINE_CASE(RGB332_UNORM);
56 DEFINE_CASE(RGB233_UNORM);
57 DEFINE_CASE(Z24X8_UNORM);
58 DEFINE_CASE(R32_FIXED);
59 DEFINE_CASE(RG32_FIXED);
60 DEFINE_CASE(RGB32_FIXED);
61 DEFINE_CASE(RGBA32_FIXED);
62 DEFINE_CASE(R11F_G11F_B10F);
63 DEFINE_CASE(R9F_G9F_B9F_E5F);
64 DEFINE_CASE(VARYING_POS);
65 DEFINE_CASE(VARYING_DISCARD);
66
67 DEFINE_CASE(R8_SNORM);
68 DEFINE_CASE(R16_SNORM);
69 DEFINE_CASE(R32_SNORM);
70 DEFINE_CASE(RG8_SNORM);
71 DEFINE_CASE(RG16_SNORM);
72 DEFINE_CASE(RG32_SNORM);
73 DEFINE_CASE(RGB8_SNORM);
74 DEFINE_CASE(RGB16_SNORM);
75 DEFINE_CASE(RGB32_SNORM);
76 DEFINE_CASE(RGBA8_SNORM);
77 DEFINE_CASE(RGBA16_SNORM);
78 DEFINE_CASE(RGBA32_SNORM);
79
80 DEFINE_CASE(R8UI);
81 DEFINE_CASE(R16UI);
82 DEFINE_CASE(R32UI);
83 DEFINE_CASE(RG8UI);
84 DEFINE_CASE(RG16UI);
85 DEFINE_CASE(RG32UI);
86 DEFINE_CASE(RGB8UI);
87 DEFINE_CASE(RGB16UI);
88 DEFINE_CASE(RGB32UI);
89 DEFINE_CASE(RGBA8UI);
90 DEFINE_CASE(RGBA16UI);
91 DEFINE_CASE(RGBA32UI);
92
93 DEFINE_CASE(R8_UNORM);
94 DEFINE_CASE(R16_UNORM);
95 DEFINE_CASE(R32_UNORM);
96 DEFINE_CASE(R32F);
97 DEFINE_CASE(RG8_UNORM);
98 DEFINE_CASE(RG16_UNORM);
99 DEFINE_CASE(RG32_UNORM);
100 DEFINE_CASE(RG32F);
101 DEFINE_CASE(RGB8_UNORM);
102 DEFINE_CASE(RGB16_UNORM);
103 DEFINE_CASE(RGB32_UNORM);
104 DEFINE_CASE(RGB32F);
105 DEFINE_CASE(RGBA4_UNORM);
106 DEFINE_CASE(RGBA8_UNORM);
107 DEFINE_CASE(RGBA16_UNORM);
108 DEFINE_CASE(RGBA32_UNORM);
109 DEFINE_CASE(RGBA32F);
110
111 DEFINE_CASE(R8I);
112 DEFINE_CASE(R16I);
113 DEFINE_CASE(R32I);
114 DEFINE_CASE(RG8I);
115 DEFINE_CASE(R16F);
116 DEFINE_CASE(RG16I);
117 DEFINE_CASE(RG32I);
118 DEFINE_CASE(RG16F);
119 DEFINE_CASE(RGB8I);
120 DEFINE_CASE(RGB16I);
121 DEFINE_CASE(RGB32I);
122 DEFINE_CASE(RGB16F);
123 DEFINE_CASE(RGBA8I);
124 DEFINE_CASE(RGBA16I);
125 DEFINE_CASE(RGBA32I);
126 DEFINE_CASE(RGBA16F);
127
128 DEFINE_CASE(RGBA4);
129 DEFINE_CASE(RGBA8_2);
130 DEFINE_CASE(RGB10_A2_2);
131 default:
132 snprintf(unk_format_str, sizeof(unk_format_str), "MALI_0x%02x", format);
133 return unk_format_str;
134 }
135 }
136
137 #undef DEFINE_CASE
138
139 /* Helper to dump fixed-function blend part for debugging */
140
141 static const char *
142 panfrost_factor_name(enum mali_dominant_factor factor)
143 {
144 switch (factor) {
145 case MALI_DOMINANT_UNK0:
146 return "unk0";
147
148 case MALI_DOMINANT_ZERO:
149 return "zero";
150
151 case MALI_DOMINANT_SRC_COLOR:
152 return "source color";
153
154 case MALI_DOMINANT_DST_COLOR:
155 return "dest color";
156
157 case MALI_DOMINANT_UNK4:
158 return "unk4";
159
160 case MALI_DOMINANT_SRC_ALPHA:
161 return "source alpha";
162
163 case MALI_DOMINANT_DST_ALPHA:
164 return "dest alpha";
165
166 case MALI_DOMINANT_CONSTANT:
167 return "constant";
168 }
169
170 return "unreachable";
171 }
172
173 static const char *
174 panfrost_modifier_name(enum mali_blend_modifier mod)
175 {
176 switch (mod) {
177 case MALI_BLEND_MOD_UNK0:
178 return "unk0";
179
180 case MALI_BLEND_MOD_NORMAL:
181 return "normal";
182
183 case MALI_BLEND_MOD_SOURCE_ONE:
184 return "source one";
185
186 case MALI_BLEND_MOD_DEST_ONE:
187 return "dest one";
188 }
189
190 return "unreachable";
191 }
192
193 static void
194 panfrost_print_fixed_part(const char *name, unsigned u)
195 {
196 struct mali_blend_mode part;
197 memcpy(&part, &u, sizeof(part));
198
199 printf("%s blend mode (%X):\n", name, u);
200
201 printf(" %s dominant:\n",
202 (part.dominant == MALI_BLEND_DOM_SOURCE) ? "source" : "destination");
203
204 printf(" %s\n", panfrost_factor_name(part.dominant_factor));
205
206 if (part.complement_dominant)
207 printf(" complement\n");
208
209
210 printf(" nondominant %s\n",
211 (part.nondominant_mode == MALI_BLEND_NON_MIRROR) ? "mirror" : "zero");
212
213
214 printf(" mode: %s\n", panfrost_modifier_name(part.clip_modifier));
215
216 if (part.negate_source) printf(" negate source\n");
217
218 if (part.negate_dest) printf(" negate dest\n");
219
220 assert(!(part.unused_0 || part.unused_1));
221 }
222
223 void
224 panfrost_print_blend_equation(struct mali_blend_equation eq)
225 {
226 printf("\n");
227 panfrost_print_fixed_part("RGB", eq.rgb_mode);
228 panfrost_print_fixed_part("Alpha", eq.alpha_mode);
229
230 assert(!eq.zero1);
231
232 printf("Mask: %s%s%s%s\n",
233 (eq.color_mask & MALI_MASK_R) ? "R" : "",
234 (eq.color_mask & MALI_MASK_G) ? "G" : "",
235 (eq.color_mask & MALI_MASK_B) ? "B" : "",
236 (eq.color_mask & MALI_MASK_A) ? "A" : "");
237 }