Blender V5.3
BLI_math_vector_swizzle.hh
Go to the documentation of this file.
1/* SPDX-FileCopyrightText: 2025 Blender Authors
2 *
3 * SPDX-License-Identifier: GPL-2.0-or-later */
4
5#pragma once
6
10
11#include "BLI_assert.hh"
12
13#include <algorithm>
14#include <array>
15#include <type_traits>
16
17namespace blender {
18
19/* Needed forward declaration to allow the swizzle to reference it. */
20template<typename T, int Size> struct VecBase;
21
26template<typename T, int Size> struct VecSwizzleFunc {};
27
28template<typename T> struct VecSwizzleFunc<T, 2> {
29 [[nodiscard]] VecBase<T, 2> xy() const
30 {
31 const VecBase<T, 2> &vec = *reinterpret_cast<const VecBase<T, 2> *>(this);
32 return {vec.x, vec.y};
33 }
34};
35
36template<typename T> struct VecSwizzleFunc<T, 3> : VecSwizzleFunc<T, 2> {
37 [[nodiscard]] VecBase<T, 3> xyz() const
38 {
39 const VecBase<T, 3> &vec = *reinterpret_cast<const VecBase<T, 3> *>(this);
40 return {vec.x, vec.y, vec.z};
41 }
42
43 [[nodiscard]] VecBase<T, 2> yz() const
44 {
45 const VecBase<T, 3> &vec = *reinterpret_cast<const VecBase<T, 3> *>(this);
46 return {vec.y, vec.z};
47 }
48};
49
50template<typename T> struct VecSwizzleFunc<T, 4> : VecSwizzleFunc<T, 3> {
51 [[nodiscard]] VecBase<T, 2> zw() const
52 {
53 const VecBase<T, 4> &vec = *reinterpret_cast<const VecBase<T, 4> *>(this);
54 return {vec.z, vec.w};
55 }
56
57 [[nodiscard]] VecBase<T, 3> yzw() const
58 {
59 const VecBase<T, 4> &vec = *reinterpret_cast<const VecBase<T, 4> *>(this);
60 return {vec.y, vec.z, vec.w};
61 }
62
63 [[nodiscard]] VecBase<T, 4> xyzw() const
64 {
65 const VecBase<T, 4> &vec = *reinterpret_cast<const VecBase<T, 4> *>(this);
66 return {vec.x, vec.y, vec.z, vec.w};
67 }
68};
69
80template<typename T, int Size, int x, int y, int z = y, int w = z> struct VecSwizzleReadOnly {
82 static constexpr int max_comp = std::max({x, y, z, w});
83 static constexpr int min_comp = std::min({x, y, z, w});
84 static constexpr int effective_len = max_comp - min_comp + 1;
85
86 private:
87 std::array<T, effective_len> values_;
88
89 public:
90 VecSwizzleReadOnly() = default;
91
92 [[nodiscard]] VecT operator()() const
93 {
94 /* Can only do this when VecT has been instantiated. */
95 BLI_STATIC_ASSERT(alignof(VecT) <= alignof(T),
96 "VecSwizzleReadOnly is not compatible with aligned type for now.");
97 BLI_STATIC_ASSERT(std::is_trivial_v<VecT>, "Can only swizzle trivial vectors.");
98 BLI_STATIC_ASSERT(Size >= 2 && Size <= 4, "Only small vector supports swizzles");
99 if constexpr (Size == 4) {
100 return {values_[x - min_comp],
101 values_[y - min_comp],
102 values_[z - min_comp],
103 values_[w - min_comp]};
104 }
105 else if constexpr (Size == 3) {
106 return {values_[x - min_comp], values_[y - min_comp], values_[z - min_comp]};
107 }
108 else if constexpr (Size == 2) {
109 return {values_[x - min_comp], values_[y - min_comp]};
110 }
111 return {};
112 }
113};
114
125template<typename T, int Size> struct VecSwizzleReadWrite {
127
128 private:
129 std::array<T, Size> values_;
130
131 public:
132 [[nodiscard]] VecT &operator()()
133 {
134 /* Can only do this when VecT has been instantiated. */
135 BLI_STATIC_ASSERT(alignof(VecT) <= alignof(T),
136 "VecSwizzleReadWrite is not compatible with aligned type for now.");
137 BLI_STATIC_ASSERT(std::is_trivial_v<VecT>, "Can only swizzle trivial vectors.");
138 BLI_STATIC_ASSERT(Size >= 2 && Size <= 4, "Only small vector supports swizzles");
139 return *reinterpret_cast<VecT *>(this);
140 }
141
142 [[nodiscard]] const VecT &operator()() const
143 {
144 /* Can only do this when VecT has been instantiated. */
145 BLI_STATIC_ASSERT(alignof(VecT) <= alignof(T),
146 "VecSwizzleReadWrite is not compatible with aligned type for now.");
147 BLI_STATIC_ASSERT(std::is_trivial_v<VecT>, "Can only swizzle trivial vectors.");
148 BLI_STATIC_ASSERT(Size >= 2 && Size <= 4, "Only small vector supports swizzles");
149 return *reinterpret_cast<const VecT *>(this);
150 }
151};
152
160
161/* Swizzles containing X. Must be declared in a union alongside X. */
162#define X_SWIZZLES \
163 VecSwizzleReadOnly<T, 2, 0, 0> xx; \
164 VecSwizzleReadOnly<T, 3, 0, 0, 0> xxx; \
165 VecSwizzleReadOnly<T, 4, 0, 0, 0, 0> xxxx;
166
167/* Swizzles containing Y. Must be declared in a union alongside Y. */
168#define Y_SWIZZLES \
169 VecSwizzleReadOnly<T, 2, 1, 1> yy; \
170 VecSwizzleReadOnly<T, 3, 1, 1, 1> yyy; \
171 VecSwizzleReadOnly<T, 4, 1, 1, 1, 1> yyyy;
172
173/* Swizzles containing Z. Must be declared in a union alongside Z. */
174#define Z_SWIZZLES \
175 VecSwizzleReadOnly<T, 2, 2, 2> zz; \
176 VecSwizzleReadOnly<T, 3, 2, 2, 2> zzz; \
177 VecSwizzleReadOnly<T, 4, 2, 2, 2, 2> zzzz;
178
179/* Swizzles containing W. Must be declared in a union alongside W. */
180#define W_SWIZZLES \
181 VecSwizzleReadOnly<T, 2, 3, 3> ww; \
182 VecSwizzleReadOnly<T, 3, 3, 3, 3> www; \
183 VecSwizzleReadOnly<T, 4, 3, 3, 3, 3> wwww;
184
185/* Swizzles containing XY. Must be declared in a union alongside X. */
186#define XY_SWIZZLES \
187 VecSwizzleReadWrite<T, 2> xy; \
188 VecSwizzleReadOnly<T, 2, 1, 0> yx; \
189 /* VecSwizzleReadOnly<T, 3, 0, 0, 1> xxy; */ \
190 /* VecSwizzleReadOnly<T, 3, 0, 1, 0> xyx; */ \
191 /* VecSwizzleReadOnly<T, 3, 0, 1, 1> xyy; */ \
192 /* VecSwizzleReadOnly<T, 3, 1, 0, 0> yxx; */ \
193 /* VecSwizzleReadOnly<T, 3, 1, 0, 1> yxy; */ \
194 /* VecSwizzleReadOnly<T, 3, 1, 1, 0> yyx; */ \
195 /* VecSwizzleReadOnly<T, 4, 0, 0, 0, 1> xxxy; */ \
196 /* VecSwizzleReadOnly<T, 4, 0, 0, 1, 0> xxyx; */ \
197 /* VecSwizzleReadOnly<T, 4, 0, 0, 1, 1> xxyy; */ \
198 /* VecSwizzleReadOnly<T, 4, 0, 1, 0, 0> xyxx; */ \
199 VecSwizzleReadOnly<T, 4, 0, 1, 0, 1> xyxy; \
200 /* VecSwizzleReadOnly<T, 4, 0, 1, 1, 0> xyyx; */ \
201 /* VecSwizzleReadOnly<T, 4, 0, 1, 1, 1> xyyy; */ \
202 /* VecSwizzleReadOnly<T, 4, 1, 0, 0, 0> yxxx; */ \
203 /* VecSwizzleReadOnly<T, 4, 1, 0, 0, 1> yxxy; */ \
204 /* VecSwizzleReadOnly<T, 4, 1, 0, 1, 0> yxyx; */ \
205 /* VecSwizzleReadOnly<T, 4, 1, 0, 1, 1> yxyy; */ \
206 /* VecSwizzleReadOnly<T, 4, 1, 1, 0, 0> yyxx; */ \
207 /* VecSwizzleReadOnly<T, 4, 1, 1, 0, 1> yyxy; */ \
208 /* VecSwizzleReadOnly<T, 4, 1, 1, 1, 0> yyyx; */
209
210/* Swizzles containing YZ. Must be declared in a union alongside Y. */
211#define YZ_SWIZZLES \
212 VecSwizzleReadWrite<T, 2> yz; \
213 VecSwizzleReadOnly<T, 2, 2, 1> zy; \
214 /* VecSwizzleReadOnly<T, 3, 1, 1, 2> yyz; */ \
215 /* VecSwizzleReadOnly<T, 3, 1, 2, 1> yzy; */ \
216 /* VecSwizzleReadOnly<T, 3, 1, 2, 2> yzz; */ \
217 /* VecSwizzleReadOnly<T, 3, 2, 1, 1> zyy; */ \
218 /* VecSwizzleReadOnly<T, 3, 2, 1, 2> zyz; */ \
219 /* VecSwizzleReadOnly<T, 3, 2, 2, 1> zzy; */ \
220 /* VecSwizzleReadOnly<T, 4, 1, 1, 1, 2> yyyz; */ \
221 /* VecSwizzleReadOnly<T, 4, 1, 1, 2, 1> yyzy; */ \
222 /* VecSwizzleReadOnly<T, 4, 1, 1, 2, 2> yyzz; */ \
223 /* VecSwizzleReadOnly<T, 4, 1, 2, 1, 1> yzyy; */ \
224 /* VecSwizzleReadOnly<T, 4, 1, 2, 1, 2> yzyz; */ \
225 /* VecSwizzleReadOnly<T, 4, 1, 2, 2, 1> yzzy; */ \
226 /* VecSwizzleReadOnly<T, 4, 1, 2, 2, 2> yzzz; */ \
227 /* VecSwizzleReadOnly<T, 4, 2, 1, 1, 1> zyyy; */ \
228 /* VecSwizzleReadOnly<T, 4, 2, 1, 1, 2> zyyz; */ \
229 /* VecSwizzleReadOnly<T, 4, 2, 1, 2, 1> zyzy; */ \
230 /* VecSwizzleReadOnly<T, 4, 2, 1, 2, 2> zyzz; */ \
231 /* VecSwizzleReadOnly<T, 4, 2, 2, 1, 1> zzyy; */ \
232 /* VecSwizzleReadOnly<T, 4, 2, 2, 1, 2> zzyz; */ \
233 /* VecSwizzleReadOnly<T, 4, 2, 2, 2, 1> zzzy; */
234
235/* Swizzles containing ZW. Must be declared in a union alongside Z. */
236#define ZW_SWIZZLES \
237 VecSwizzleReadWrite<T, 2> zw; \
238 /* VecSwizzleReadOnly<T, 2, 3, 2> wz; */ \
239 /* VecSwizzleReadOnly<T, 3, 2, 2, 3> zzw; */ \
240 /* VecSwizzleReadOnly<T, 3, 2, 3, 2> zwz; */ \
241 /* VecSwizzleReadOnly<T, 3, 2, 3, 3> zww; */ \
242 /* VecSwizzleReadOnly<T, 3, 3, 2, 2> wzz; */ \
243 /* VecSwizzleReadOnly<T, 3, 3, 2, 3> wzw; */ \
244 /* VecSwizzleReadOnly<T, 3, 3, 3, 2> wwz; */ \
245 /* VecSwizzleReadOnly<T, 4, 2, 2, 2, 3> zzzw; */ \
246 /* VecSwizzleReadOnly<T, 4, 2, 2, 3, 2> zzwz; */ \
247 /* VecSwizzleReadOnly<T, 4, 2, 2, 3, 3> zzww; */ \
248 /* VecSwizzleReadOnly<T, 4, 2, 3, 2, 2> zwzz; */ \
249 /* VecSwizzleReadOnly<T, 4, 2, 3, 2, 3> zwzw; */ \
250 /* VecSwizzleReadOnly<T, 4, 2, 3, 3, 2> zwwz; */ \
251 /* VecSwizzleReadOnly<T, 4, 2, 3, 3, 3> zwww; */ \
252 /* VecSwizzleReadOnly<T, 4, 3, 2, 2, 2> wzzz; */ \
253 /* VecSwizzleReadOnly<T, 4, 3, 2, 2, 3> wzzw; */ \
254 /* VecSwizzleReadOnly<T, 4, 3, 2, 3, 2> wzwz; */ \
255 /* VecSwizzleReadOnly<T, 4, 3, 2, 3, 3> wzww; */ \
256 /* VecSwizzleReadOnly<T, 4, 3, 3, 2, 2> wwzz; */ \
257 /* VecSwizzleReadOnly<T, 4, 3, 3, 2, 3> wwzw; */ \
258 /* VecSwizzleReadOnly<T, 4, 3, 3, 3, 2> wwwz; */
259
260/* Swizzles containing XYZ. Must be declared in a union alongside X. */
261#define XYZ_SWIZZLES \
262 VecSwizzleReadWrite<T, 3> xyz; \
263 VecSwizzleReadOnly<T, 3, 0, 2, 1> xzy; \
264 /* VecSwizzleReadOnly<T, 3, 1, 0, 2> yxz; */ \
265 VecSwizzleReadOnly<T, 3, 1, 2, 0> yzx; \
266 /* VecSwizzleReadOnly<T, 3, 2, 0, 1> zxy; */ \
267 VecSwizzleReadOnly<T, 3, 2, 1, 0> zyx; \
268 /* VecSwizzleReadOnly<T, 4, 0, 0, 1, 2> xxyz; */ \
269 /* VecSwizzleReadOnly<T, 4, 0, 0, 2, 1> xxzy; */ \
270 /* VecSwizzleReadOnly<T, 4, 0, 1, 0, 2> xyxz; */ \
271 /* VecSwizzleReadOnly<T, 4, 0, 1, 1, 2> xyyz; */ \
272 /* VecSwizzleReadOnly<T, 4, 0, 1, 2, 0> xyzx; */ \
273 /* VecSwizzleReadOnly<T, 4, 0, 1, 2, 1> xyzy; */ \
274 VecSwizzleReadOnly<T, 4, 0, 1, 2, 2> xyzz; \
275 /* VecSwizzleReadOnly<T, 4, 0, 2, 0, 1> xzxy; */ \
276 /* VecSwizzleReadOnly<T, 4, 0, 2, 1, 0> xzyx; */ \
277 /* VecSwizzleReadOnly<T, 4, 0, 2, 1, 1> xzyy; */ \
278 /* VecSwizzleReadOnly<T, 4, 0, 2, 1, 2> xzyz; */ \
279 /* VecSwizzleReadOnly<T, 4, 0, 2, 2, 1> xzzy; */ \
280 /* VecSwizzleReadOnly<T, 4, 1, 0, 0, 2> yxxz; */ \
281 /* VecSwizzleReadOnly<T, 4, 1, 0, 1, 2> yxyz; */ \
282 /* VecSwizzleReadOnly<T, 4, 1, 0, 2, 0> yxzx; */ \
283 /* VecSwizzleReadOnly<T, 4, 1, 0, 2, 1> yxzy; */ \
284 /* VecSwizzleReadOnly<T, 4, 1, 0, 2, 2> yxzz; */ \
285 /* VecSwizzleReadOnly<T, 4, 1, 1, 0, 2> yyxz; */ \
286 /* VecSwizzleReadOnly<T, 4, 1, 1, 2, 0> yyzx; */ \
287 /* VecSwizzleReadOnly<T, 4, 1, 2, 0, 0> yzxx; */ \
288 /* VecSwizzleReadOnly<T, 4, 1, 2, 0, 1> yzxy; */ \
289 /* VecSwizzleReadOnly<T, 4, 1, 2, 0, 2> yzxz; */ \
290 /* VecSwizzleReadOnly<T, 4, 1, 2, 1, 0> yzyx; */ \
291 /* VecSwizzleReadOnly<T, 4, 1, 2, 2, 0> yzzx; */ \
292 /* VecSwizzleReadOnly<T, 4, 2, 0, 0, 1> zxxy; */ \
293 /* VecSwizzleReadOnly<T, 4, 2, 0, 1, 0> zxyx; */ \
294 /* VecSwizzleReadOnly<T, 4, 2, 0, 1, 1> zxyy; */ \
295 /* VecSwizzleReadOnly<T, 4, 2, 0, 1, 2> zxyz; */ \
296 /* VecSwizzleReadOnly<T, 4, 2, 0, 2, 1> zxzy; */ \
297 /* VecSwizzleReadOnly<T, 4, 2, 1, 0, 0> zyxx; */ \
298 /* VecSwizzleReadOnly<T, 4, 2, 1, 0, 1> zyxy; */ \
299 /* VecSwizzleReadOnly<T, 4, 2, 1, 0, 2> zyxz; */ \
300 /* VecSwizzleReadOnly<T, 4, 2, 1, 1, 0> zyyx; */ \
301 /* VecSwizzleReadOnly<T, 4, 2, 1, 2, 0> zyzx; */ \
302 /* VecSwizzleReadOnly<T, 4, 2, 2, 0, 1> zzxy; */ \
303 /* VecSwizzleReadOnly<T, 4, 2, 2, 1, 0> zzyx; */
304
305/* Swizzles containing YZW. Must be declared in a union alongside Y. */
306#define YZW_SWIZZLES \
307 VecSwizzleReadWrite<T, 3> yzw; \
308 /* VecSwizzleReadOnly<T, 3, 1, 3, 2> ywz; */ \
309 /* VecSwizzleReadOnly<T, 3, 2, 1, 3> zyw; */ \
310 /* VecSwizzleReadOnly<T, 3, 2, 3, 1> zwy; */ \
311 /* VecSwizzleReadOnly<T, 3, 3, 1, 2> wyz; */ \
312 /* VecSwizzleReadOnly<T, 3, 3, 2, 1> wzy; */ \
313 /* VecSwizzleReadOnly<T, 4, 1, 1, 2, 3> yyzw; */ \
314 /* VecSwizzleReadOnly<T, 4, 1, 1, 3, 2> yywz; */ \
315 /* VecSwizzleReadOnly<T, 4, 1, 2, 1, 3> yzyw; */ \
316 /* VecSwizzleReadOnly<T, 4, 1, 2, 2, 3> yzzw; */ \
317 /* VecSwizzleReadOnly<T, 4, 1, 2, 3, 1> yzwy; */ \
318 /* VecSwizzleReadOnly<T, 4, 1, 2, 3, 2> yzwz; */ \
319 /* VecSwizzleReadOnly<T, 4, 1, 2, 3, 3> yzww; */ \
320 /* VecSwizzleReadOnly<T, 4, 1, 3, 1, 2> ywyz; */ \
321 /* VecSwizzleReadOnly<T, 4, 1, 3, 2, 1> ywzy; */ \
322 /* VecSwizzleReadOnly<T, 4, 1, 3, 2, 2> ywzz; */ \
323 /* VecSwizzleReadOnly<T, 4, 1, 3, 2, 3> ywzw; */ \
324 /* VecSwizzleReadOnly<T, 4, 1, 3, 3, 2> ywwz; */ \
325 /* VecSwizzleReadOnly<T, 4, 2, 1, 1, 3> zyyw; */ \
326 /* VecSwizzleReadOnly<T, 4, 2, 1, 2, 3> zyzw; */ \
327 /* VecSwizzleReadOnly<T, 4, 2, 1, 3, 1> zywy; */ \
328 /* VecSwizzleReadOnly<T, 4, 2, 1, 3, 2> zywz; */ \
329 /* VecSwizzleReadOnly<T, 4, 2, 1, 3, 3> zyww; */ \
330 /* VecSwizzleReadOnly<T, 4, 2, 2, 1, 3> zzyw; */ \
331 /* VecSwizzleReadOnly<T, 4, 2, 2, 3, 1> zzwy; */ \
332 /* VecSwizzleReadOnly<T, 4, 2, 3, 1, 1> zwyy; */ \
333 /* VecSwizzleReadOnly<T, 4, 2, 3, 1, 2> zwyz; */ \
334 /* VecSwizzleReadOnly<T, 4, 2, 3, 1, 3> zwyw; */ \
335 /* VecSwizzleReadOnly<T, 4, 2, 3, 2, 1> zwzy; */ \
336 /* VecSwizzleReadOnly<T, 4, 2, 3, 3, 1> zwwy; */ \
337 /* VecSwizzleReadOnly<T, 4, 3, 1, 1, 2> wyyz; */ \
338 /* VecSwizzleReadOnly<T, 4, 3, 1, 2, 1> wyzy; */ \
339 /* VecSwizzleReadOnly<T, 4, 3, 1, 2, 2> wyzz; */ \
340 /* VecSwizzleReadOnly<T, 4, 3, 1, 2, 3> wyzw; */ \
341 /* VecSwizzleReadOnly<T, 4, 3, 1, 3, 2> wywz; */ \
342 /* VecSwizzleReadOnly<T, 4, 3, 2, 1, 1> wzyy; */ \
343 /* VecSwizzleReadOnly<T, 4, 3, 2, 1, 2> wzyz; */ \
344 /* VecSwizzleReadOnly<T, 4, 3, 2, 1, 3> wzyw; */ \
345 /* VecSwizzleReadOnly<T, 4, 3, 2, 2, 1> wzzy; */ \
346 /* VecSwizzleReadOnly<T, 4, 3, 2, 3, 1> wzwy; */ \
347 /* VecSwizzleReadOnly<T, 4, 3, 3, 1, 2> wwyz; */ \
348 /* VecSwizzleReadOnly<T, 4, 3, 3, 2, 1> wwzy; */
349
350/* Swizzles containing XYZW. Must be declared in a union alongside X. */
351#define XYZW_SWIZZLES \
352 VecSwizzleReadWrite<T, 4> xyzw; \
353 /* VecSwizzleReadOnly<T, 4, 0, 1, 3, 2> xywz; */ \
354 /* VecSwizzleReadOnly<T, 4, 0, 2, 1, 3> xzyw; */ \
355 /* VecSwizzleReadOnly<T, 4, 0, 2, 3, 1> xzwy; */ \
356 /* VecSwizzleReadOnly<T, 4, 0, 3, 1, 2> xwyz; */ \
357 /* VecSwizzleReadOnly<T, 4, 0, 3, 2, 1> xwzy; */ \
358 /* VecSwizzleReadOnly<T, 4, 1, 0, 2, 3> yxzw; */ \
359 /* VecSwizzleReadOnly<T, 4, 1, 0, 3, 2> yxwz; */ \
360 /* VecSwizzleReadOnly<T, 4, 1, 2, 0, 3> yzxw; */ \
361 /* VecSwizzleReadOnly<T, 4, 1, 2, 3, 0> yzwx; */ \
362 /* VecSwizzleReadOnly<T, 4, 1, 3, 0, 2> ywxz; */ \
363 /* VecSwizzleReadOnly<T, 4, 1, 3, 2, 0> ywzx; */ \
364 /* VecSwizzleReadOnly<T, 4, 2, 0, 1, 3> zxyw; */ \
365 /* VecSwizzleReadOnly<T, 4, 2, 0, 3, 1> zxwy; */ \
366 /* VecSwizzleReadOnly<T, 4, 2, 1, 0, 3> zyxw; */ \
367 /* VecSwizzleReadOnly<T, 4, 2, 1, 3, 0> zywx; */ \
368 /* VecSwizzleReadOnly<T, 4, 2, 3, 0, 1> zwxy; */ \
369 /* VecSwizzleReadOnly<T, 4, 2, 3, 1, 0> zwyx; */ \
370 VecSwizzleReadOnly<T, 4, 3, 0, 1, 2> wxyz; \
371 /* VecSwizzleReadOnly<T, 4, 3, 0, 2, 1> wxzy; */ \
372 /* VecSwizzleReadOnly<T, 4, 3, 1, 0, 2> wyxz; */ \
373 /* VecSwizzleReadOnly<T, 4, 3, 1, 2, 0> wyzx; */ \
374 /* VecSwizzleReadOnly<T, 4, 3, 2, 0, 1> wzxy; */ \
375 VecSwizzleReadOnly<T, 4, 3, 2, 1, 0> wzyx;
376
377} // namespace blender
SIMD_FORCE_INLINE const btScalar & z() const
Return the z value.
Definition btQuadWord.h:117
SIMD_FORCE_INLINE const btScalar & w() const
Return the w value.
Definition btQuadWord.h:119
#define T
BMesh Iterators.
BLI_STATIC_ASSERT(ARRAY_SIZE(data_mode_strings)==CTX_MODE_NUM+1, "Must have a string for each context mode") const char *CTX_data_mode_string(const bContext *C)