GLSL Struct 1.4.8
glslstruct
Loading...
Searching...
No Matches
base_parser.hpp
1/*
2 * glslstruct - a C++ library designed to easily represent GLSL's Uniform Buffer Objects (UBOs) and Shader Storage Buffer Objects (SSBOs) in C++.
3 *
4 * Licensed under the BSD 3-Clause License with Attribution Requirement.
5 * See the LICENSE file for details: https://github.com/MAIPA01/glslstruct/blob/main/LICENSE
6 *
7 * Copyright (c) 2025, Patryk Antosik (MAIPA01)
8 */
9
10#pragma once
11#ifndef _GLSL_STRUCT_PARSER_HPP_
12 #define _GLSL_STRUCT_PARSER_HPP_
13
14 #include <glslstruct/config.hpp>
15
16 #if !_GLSL_STRUCT_HAS_PARSER
17_GLSL_STRUCT_ERROR("This is only available for c++17 and greater and when parser functionality is not disabled!");
18 #else
19
20 #include <glslstruct/struct/base_struct.hpp>
21
22namespace glslstruct {
23
24 namespace utils {
25 #pragma region BASE_PARSER_PATTERNS
26
27 /**
28 * @ingroup utils
29 * @brief all parser patterns in one struct
30 */
31 struct base_parser_patterns {
32 /// @brief pattern to get scalar data
33 static inline const auto scalarsPattern = pcre2cpp::regex(R"(^\s*+(?<scalar>(?>bool|double|float|u?int))\s*+$)");
34
35 /// @brief pattern to get vec data
36 static inline const auto vecPattern = pcre2cpp::regex(R"(^\s*+(?>(?<scalar>[idbuf])?vec(?<length>[2-4]))\s*+$)");
37
38 /// @brief pattern to get mat data
39 static inline const auto matPattern =
40 pcre2cpp::regex(R"(^\s*+(?>(?<scalar>[idbuf])?mat(?<cols>[2-4])(?>(?:x(?<rows>[2-4]))?))\s*+$)");
41
42 /// @brief pattern to get variable data
43 static inline const auto variablePattern = pcre2cpp::regex(
44 R"(^\s*+(?>(?<type>[a-zA-Z_]\w*+))\s++(?>(?<name>[a-zA-Z_]\w*+))\s*+(?>(?<array>\‍[\s*+(?<count>\d+)?\s*+\‍]))?\s*+(?>;?)\s*+$)"
45 );
46
47 /// @brief pattern to get multiple variables
48 static inline const auto multiVariablesPattern = pcre2cpp::regex(
49 R"((?>(?<=^|;))\s*+(?<var>[a-zA-Z_]\w*+\s++[a-zA-Z_]\w*+(?>(?:\s*+\‍[\s*+\d*+\s*+\‍])*+))\s*+(?:;|$))",
50 pcre2cpp::compile_options_bits::Multiline
51 );
52
53 /// @brief pattern to get struct data
54 static inline const auto structPattern =
55 pcre2cpp::regex(R"(^\s*+(?>(?>struct)\s++(?>(?<name>[a-zA-Z_]\w*+))\s*+(?>\{(?<body>[^}]*+)\})\s*+;)\s*+$)");
56
57 /// @brief pattern to get multiple structs
58 static inline const auto multiStructsPattern = pcre2cpp::regex(
59 R"(\s*+(?<struct>(?>struct|layout\s*+\‍([^)]*+\‍)\s*+(?>uniform|(?:\w++\s++)?buffer))\s++(?>(?:[a-zA-Z_]\w*+))\s*+\{(?>[^}]*+)\}\s*+(?>(?:\w*+\s*+));\s*+))",
60 pcre2cpp::compile_options_bits::Multiline
61 );
62 };
63
64 #pragma endregion
65
66 #pragma region UBO_PARSER_PATTERN
67 /**
68 * @ingroup utils
69 * @brief container for ubo parser pattern
70 */
71 #if _GLSL_STRUCT_HAS_CXX20
72 template<glsl_layout Layout>
73 #else
74 template<class Layout, std::enable_if_t<is_glsl_layout_v<Layout>, bool> = true>
75 #endif
76 struct ubo_parser_pattern {
77 };
78
79 /**
80 * @ingroup utils
81 * @brief template overload of container for ubo parser pattern for std140 layout
82 */
83 template<>
84 struct ubo_parser_pattern<std140_layout> {
85 /// @brief pattern for std140 ubo
86 static inline const auto pattern = pcre2cpp::regex(
87 R"(^\s*+layout\s*+\‍((?>(?:(?:std140|set\s*+=\s*+\d++)\s*+,\s*+)?)\s*+binding\s*+=\s*+\d++\s*+\‍)\s*+uniform\s*+(?<name>[a-zA-Z_]\w*+)\s*+\{(?<body>[^}]*+)\}\s*+(?>(?:[a-zA-Z_]\w*+)?)\s*+;\s*+$)"
88 );
89 };
90
91 #if _GLSL_STRUCT_HAS_CXX20
92 /**
93 * @ingroup utils
94 * @brief concept for check if layout can be used as ubo
95 */
96 template<class Layout>
100
101 /**
102 * @ingroup utils
103 * @brief returns true if layout can be used as ubo
104 */
105 template<class Layout>
106 static _GLSL_STRUCT_CONSTEXPR17 bool has_ubo_pattern_v = has_ubo_pattern<Layout>;
107
108 #else
109 /**
110 * @ingroup utils
111 * @brief struct checking if layout can be used as ubo
112 */
113 template<class Layout, class = void>
114 struct has_ubo_pattern : std::false_type {};
115
116 template<class Layout>
117 struct has_ubo_pattern<Layout,
118 std::void_t<std::enable_if_t<std::is_convertible_v<decltype(ubo_parser_pattern<Layout>::pattern), pcre2cpp::regex> > > >
119 : std::true_type {};
120
121 /**
122 * @ingroup utils
123 * @brief returns true if layout can be used as ubo
124 */
125 template<class Layout>
126 static _GLSL_STRUCT_CONSTEXPR17 bool has_ubo_pattern_v = has_ubo_pattern<Layout>::value;
127 #endif
128 #pragma endregion
129
130 #pragma region SSBO_PARSER_PATTERN
131 /**
132 * @ingroup utils
133 * @brief container for ssbo parser pattern
134 */
135 #if _GLSL_STRUCT_HAS_CXX20
136 template<glsl_layout Layout>
137 #else
138 template<class Layout, std::enable_if_t<is_glsl_layout_v<Layout>, bool> = true>
139 #endif
140 struct ssbo_parser_pattern {
141 };
142
143 /**
144 * @ingroup utils
145 * @brief template overload of container for ssbo parser pattern for std140 layout
146 */
147 template<>
148 struct ssbo_parser_pattern<std140_layout> {
149 static inline const auto pattern = pcre2cpp::regex(
150 R"(^\s*+layout\s*+\‍((?>std140(?>\s*+,\s*+set\s*+=\s*+\d++)?)\s*+,\s*+binding\s*+=\s*+\d++\s*+\‍)\s*+(?>(?:[a-zA-Z]++\s++)?buffer)\s++(?<name>[a-zA-Z_]\w*+)\s*+\{(?<body>[^}]*+)\}\s*+(?>(?:[a-zA-Z_]\w*+)?)\s*+;\s*+$)"
151 );
152 };
153
154 /**
155 * @ingroup utils
156 * @brief template overload of container for ssbo parser pattern for std430 layout
157 */
158 template<>
159 struct ssbo_parser_pattern<std430_layout> {
160 static inline const auto pattern = pcre2cpp::regex(
161 R"(^\s*+layout\s*+\‍((?>std430(?>\s*+,\s*+set\s*+=\s*+\d++)?)\s*+,\s*+binding\s*+=\s*+\d++\s*+\‍)\s*+(?>(?:[a-zA-Z]++\s++)?buffer)\s++(?<name>[a-zA-Z_]\w*+)\s*+\{(?<body>[^}]*+)\}\s*+(?>(?:[a-zA-Z_]\w*+)?)\s*+;\s*+$)"
162 );
163 };
164
165 /**
166 * @ingroup utils
167 * @brief template overload of container for ssbo parser pattern for scalar layout
168 */
169 template<>
170 struct ssbo_parser_pattern<scalar_layout> {
171 static inline const auto pattern = pcre2cpp::regex(
172 R"(^\s*+layout\s*+\‍((?>scalar(?>\s*+,\s*+set\s*+=\s*+\d++)?)\s*+,\s*+binding\s*+=\s*+\d++\s*+\‍)\s*+(?>(?:[a-zA-Z]++\s++)?buffer)\s++(?<name>[a-zA-Z_]\w*+)\s*+\{(?<body>[^}]*+)\}\s*+(?>(?:[a-zA-Z_]\w*+)?)\s*+;\s*+$)"
173 );
174 };
175
176 #if _GLSL_STRUCT_HAS_CXX20
177 /**
178 * @ingroup utils
179 * @brief concept for check if layout can be used as ssbo
180 */
181 template<class Layout>
185
186 /**
187 * @ingroup utils
188 * @brief returns true if layout can be used as ssbo
189 */
190 template<class Layout>
191 static _GLSL_STRUCT_CONSTEXPR17 bool has_ssbo_pattern_v = has_ssbo_pattern<Layout>;
192
193 #else
194 /**
195 * @ingroup utils
196 * @brief struct checking if layout can be used as ssbo
197 */
198 template<class Layout, class = void>
199 struct has_ssbo_pattern : std::false_type {};
200
201 template<class Layout>
202 struct has_ssbo_pattern<
203 Layout,
204 std::void_t<std::enable_if_t<std::is_convertible_v<decltype(ssbo_parser_pattern<Layout>::pattern), pcre2cpp::regex> > >
205 > : std::true_type {};
206
207 /**
208 * @ingroup utils
209 * @brief returns true if layout can be used as ssbo
210 */
211 template<class Layout>
212 static _GLSL_STRUCT_CONSTEXPR17 bool has_ssbo_pattern_v = has_ssbo_pattern<Layout>::value;
213 #endif
214 #pragma endregion
215 } // namespace utils
216
217 /**
218 * @ingroup glslstruct
219 * @brief base template class of structs parser
220 * @tparam Layout layout type for parser
221 */
222 #if _GLSL_STRUCT_HAS_CXX20
223 template<glsl_layout Layout>
224 #else
225 template<class Layout, std::enable_if_t<is_glsl_layout_v<Layout>, bool> = true>
226 #endif
227 class base_parser {
228 private:
229 /// @brief layout type
230 using _layout_type = Layout;
231 /// @brief structure type
232 using _struct_type = base_struct<Layout>;
233
234 using _base_patterns = utils::base_parser_patterns;
235 using _ubo_pattern = utils::ubo_parser_pattern<_layout_type>;
236 using _ssbo_pattern = utils::ssbo_parser_pattern<_layout_type>;
237
238 /// @brief returns true if given layout can be used by ubo
239 static _GLSL_STRUCT_CONSTEXPR17 bool has_ubo_pattern = utils::has_ubo_pattern_v<_layout_type>;
240 /// @brief returns true if given layout can be used by ssbo
241 static _GLSL_STRUCT_CONSTEXPR17 bool has_ssbo_pattern = utils::has_ssbo_pattern_v<_layout_type>;
242
243 /// @brief loaded and not converted to layouts structs bodies
244 std::unordered_map<std::string, std::string> _structsBodies;
245 /// @brief loaded and converted to layouts structs
246 std::unordered_map<std::string, _layout_type> _structsLayouts = {};
247
248 #pragma region GENERAL_VARIABLE_FUNCTIONS
249
250 /// @brief returns ValueType based on type in string
251 static _GLSL_STRUCT_CONSTEXPR17 ValueType _get_value_type_from_string(const std::string_view type) noexcept {
252 // Option for vec and mat
253 if (type.empty() || type[0] == 'f') { return ValueType::Float; }
254
255 if (type[0] == 'i') { return ValueType::Int; }
256
257 if (type[0] == 'u') { return ValueType::Uint; }
258
259 if (type[0] == 'd') { return ValueType::Double; }
260
261 if (type[0] == 'b') { return ValueType::Bool; }
262
263 [[unlikely]] return ValueType::Int;
264 }
265
266 /// @brief adds variable of type T to struct or layout (if count != 0 then it adds array of variables of type T)
267 template<class T, class S>
268 static _GLSL_STRUCT_CONSTEXPR17 S& _add_variable(S& ref, const std::string_view name, const size_t count) {
269 if _GLSL_STRUCT_CONSTEXPR17 (std::is_same_v<S, _layout_type> || std::is_same_v<S, _struct_type>) {
270 if (count != 0) { ref.template add<std::vector<T> >(name, count); }
271 else { ref.template add<T>(name); }
272 }
273 return ref;
274 }
275
276 #pragma endregion
277
278 #pragma region SCALAR_VARIABLE
279
280 /// @brief adds scalar with name and of type based on ValueType to struct or layout
281 template<class S>
282 static _GLSL_STRUCT_CONSTEXPR17 S& _add_scalar_variable(S& ref, const ValueType type, const std::string_view name,
283 const size_t count) {
284 switch (type) {
285 case ValueType::Bool: return _add_variable<bool>(ref, name, count);
286 default:
287 case ValueType::Int: return _add_variable<int>(ref, name, count);
288 case ValueType::Uint: return _add_variable<unsigned int>(ref, name, count);
289 case ValueType::Float: return _add_variable<float>(ref, name, count);
290 case ValueType::Double: return _add_variable<double>(ref, name, count);
291 }
292 }
293
294 #pragma endregion
295
296 #pragma region VEC_VARIABLE
297
298 /// @brief adds vec with name and with provided length to struct or layout
299 template<class T, class S>
300 static _GLSL_STRUCT_CONSTEXPR17 S& _add_vec_variable(S& ref, const size_t length, const std::string_view name,
301 const size_t count) {
302 switch (length) {
303 default:
304 case 2: return _add_variable<glm::vec<2, T> >(ref, name, count);
305 case 3: return _add_variable<glm::vec<3, T> >(ref, name, count);
306 case 4: return _add_variable<glm::vec<4, T> >(ref, name, count);
307 }
308 }
309
310 /// @brief adds vec with name and of type based on ValueType and with provided length to struct or layout
311 template<class S>
312 static _GLSL_STRUCT_CONSTEXPR17 S& _add_vec_variable(S& ref, const ValueType type, const size_t length,
313 const std::string_view name, const size_t count) {
314 switch (type) {
315 case ValueType::Bool: return _add_vec_variable<bool>(ref, length, name, count);
316 default:
317 case ValueType::Int: return _add_vec_variable<int>(ref, length, name, count);
318 case ValueType::Uint: return _add_vec_variable<unsigned int>(ref, length, name, count);
319 case ValueType::Float: return _add_vec_variable<float>(ref, length, name, count);
320 case ValueType::Double: return _add_vec_variable<double>(ref, length, name, count);
321 }
322 }
323
324 #pragma endregion
325
326 #pragma region MAT_VARIABLE
327
328 /// @brief adds mat with name and with provided rows to struct or layout
329 template<class T, size_t Cols, class S>
330 static _GLSL_STRUCT_CONSTEXPR17 S& _add_mat_variable(S& ref, const size_t rows, const std::string_view name,
331 const size_t count) {
332 switch (rows) {
333 default:
334 case 2: return _add_variable<glm::mat<Cols, 2, T> >(ref, name, count);
335 case 3: return _add_variable<glm::mat<Cols, 3, T> >(ref, name, count);
336 case 4: return _add_variable<glm::mat<Cols, 4, T> >(ref, name, count);
337 }
338 }
339
340 /// @brief adds mat with name and with provided columns and rows to struct or layout
341 template<class T, class S>
342 static _GLSL_STRUCT_CONSTEXPR17 S& _add_mat_variable(S& ref, const size_t cols, const size_t rows,
343 const std::string_view name, const size_t count) {
344 switch (cols) {
345 default:
346 case 2: return _add_mat_variable<T, 2>(ref, rows, name, count);
347 case 3: return _add_mat_variable<T, 3>(ref, rows, name, count);
348 case 4: return _add_mat_variable<T, 3>(ref, rows, name, count);
349 }
350 }
351
352 /// @brief adds mat with name and of type based on ValueType and with provided columns and rows to struct or layout
353 template<class S>
354 static _GLSL_STRUCT_CONSTEXPR17 S& _add_mat_variable(S& ref, const ValueType type, const size_t cols, const size_t rows,
355 const std::string_view name, const size_t count) {
356 switch (type) {
357 case ValueType::Bool: return _add_mat_variable<bool>(ref, cols, rows, name, count);
358 default:
359 case ValueType::Int: return _add_mat_variable<int>(ref, cols, rows, name, count);
360 case ValueType::Uint: return _add_mat_variable<unsigned int>(ref, cols, rows, name, count);
361 case ValueType::Float: return _add_mat_variable<float>(ref, cols, rows, name, count);
362 case ValueType::Double: return _add_mat_variable<double>(ref, cols, rows, name, count);
363 }
364 }
365
366 #pragma endregion
367
368 #pragma region EXTRACT_STRUCTS
369
370 /// @brief extracts name and body of structure from string
371 _GLSL_STRUCT_CONSTEXPR20 std::pair<std::string, std::string> _extract_struct_data(const std::string_view structStr) {
372 pcre2cpp::match_result result;
373 if (_base_patterns::structPattern.match(structStr, result)) {
374 return std::make_pair(result.get_sub_result_value("name"), result.get_sub_result_value("body"));
375 }
376
377 if _GLSL_STRUCT_CONSTEXPR17 (has_ubo_pattern) {
378 if (_ubo_pattern::pattern.match(structStr, result)) {
379 return std::make_pair(result.get_sub_result_value("name"), result.get_sub_result_value("body"));
380 }
381 }
382
383 if _GLSL_STRUCT_CONSTEXPR17 (has_ssbo_pattern) {
384 if (_ssbo_pattern::pattern.match(structStr, result)) {
385 return std::make_pair(result.get_sub_result_value("name"), result.get_sub_result_value("body"));
386 }
387 }
388
389 glsl_struct_assert(false, "Provided string '{}' was not a struct definition", structStr);
390 return std::make_pair(std::string(), std::string());
391 }
392
393 /// @brief extracts struct strings from structs list
394 _GLSL_STRUCT_CONSTEXPR20 std::vector<std::string> _extract_structs(const std::string_view structsStr) {
395 std::vector<pcre2cpp::match_result> results;
396 if (!_base_patterns::multiStructsPattern.match_all(structsStr, results)) {
397 glsl_struct_assert(false, "Provided structs string '{}' didn't have any struct definition", structsStr);
398 return {};
399 }
400
401 std::vector<std::string> structs;
402 structs.reserve(results.size());
403 for (const auto& result : results) { structs.push_back(result.get_sub_result_value("struct")); }
404 return structs;
405 }
406
407 #pragma endregion
408
409 #pragma region LAYOUT
410
411 /// @brief creates layout with variables in vars list
412 _GLSL_STRUCT_CONSTEXPR17 _layout_type _create_layout(const std::string_view varsStr) {
413 _layout_type layout;
414 return _add_variables(layout, varsStr);
415 }
416
417 /// @brief loads layout from structsBodies to structsLayouts and returns if there is a layout with given name in structsLayouts
426
427 #pragma endregion
428
429 #pragma region CONTAINS
430
431 /// @brief returns true if struct with given name is in _structsBodies
432 _GLSL_STRUCT_CONSTEXPR17 bool _contains_struct_body(const std::string_view name) {
433 #if _GLSL_STRUCT_HAS_CXX20
434 return _structsBodies.contains(name.data());
435 #else
436 return _structsBodies.find(name.data()) != _structsBodies.end();
437 #endif
438 }
439
440 /// @brief returns true if struct with given name is in _structsLayouts
441 _GLSL_STRUCT_CONSTEXPR17 bool _contains_struct_layout(const std::string_view name) {
442 #if _GLSL_STRUCT_HAS_CXX20
443 return _structsLayouts.contains(name.data());
444 #else
445 return _structsLayouts.find(name.data()) != _structsLayouts.end();
446 #endif
447 }
448
449 #pragma endregion
450
451 #pragma region PARSE_AND_ADD_VARIABLES
452
453 /// @brief adds variable of type given in string and with name and count
454 template<class S>
455 _GLSL_STRUCT_CONSTEXPR20 S& _add_variable(S& ref, const std::string_view type, const std::string_view name,
456 const size_t count = 0) {
457 pcre2cpp::match_result result;
458
459 // Check if scalar type
460 if (_base_patterns::scalarsPattern.match_at(type, result)) {
461 return _add_scalar_variable(ref, _get_value_type_from_string(result.get_sub_result_value("scalar")), name,
462 count);
463 }
464
465 // Check if vec type
466 if (_base_patterns::vecPattern.match_at(type, result)) {
467 size_t length;
468 mstd::strtounum(result.get_sub_result_value("length"), length);
469
470 return _add_vec_variable(ref, _get_value_type_from_string(result.get_sub_result_value("scalar")), length,
471 name, count);
472 }
473
474 // Check if mat type
475 if (_base_patterns::matPattern.match_at(type, result)) {
476 const ValueType valueType = _get_value_type_from_string(result.get_sub_result_value("scalar"));
477
478 size_t cols;
479 mstd::strtounum(result.get_sub_result_value("cols"), cols);
480
481 if (!result.has_sub_value("rows")) { return _add_mat_variable(ref, valueType, cols, cols, name, count); }
482
483 size_t rows;
484 mstd::strtounum(result.get_sub_result_value("rows"), rows);
485
486 return _add_mat_variable(ref, valueType, cols, rows, name, count);
487 }
488
489 // Check if struct type
490 if (_load_layout(type.data())) {
491 ref.add(name, _structsLayouts.at(type.data()));
492 return ref;
493 }
494
495 glsl_struct_assert(false, "Provided type str '{}' was not a correct variable type", type);
496 return ref;
497 }
498
499 /// @brief adds variable given in string
500 template<class S>
501 _GLSL_STRUCT_CONSTEXPR20 S& _add_variable(S& ref, const std::string_view varStr) {
502 pcre2cpp::match_result result;
503 if (!_base_patterns::variablePattern.match_at(varStr, result)) {
504 glsl_struct_assert(false, "Provided var str '{}' was not a correct variable", varStr);
505 return ref;
506 }
507
508 size_t count = 0;
509 if (result.has_sub_value("count")) { mstd::strtounum(result.get_sub_result_value("count"), count); }
510 else if (result.has_sub_value("array")) { count = 1; }
511
512 return _add_variable(ref, result.get_sub_result_value("type"), result.get_sub_result_value("name"), count);
513 }
514
515 /// @brief adds variables given in var list string
516 template<class S>
517 _GLSL_STRUCT_CONSTEXPR20 S& _add_variables(S& ref, const std::string_view varsStr) {
518 std::vector<pcre2cpp::match_result> results;
519 if (!_base_patterns::multiVariablesPattern.match_all(varsStr, results)) {
520 glsl_struct_assert(false, "Provided vars str '{}' was not a correct variables list", varsStr);
521 return ref;
522 }
523
524 for (const auto& result : results) { _add_variable(ref, result.get_sub_result_value("var")); }
525
526 return ref;
527 }
528
529 #pragma endregion
530
531 public:
532 /// @brief default constructor
533 _GLSL_STRUCT_CONSTEXPR17 base_parser() = default;
534
535 #pragma region VARIABLE_PARSER
536
537 /// @brief adds variable array to layout
538 _GLSL_STRUCT_CONSTEXPR17 _layout_type& add_variable(_layout_type& layoutRef, const std::string_view type,
539 const std::string_view name, const size_t count) {
540 return _add_variable(layoutRef, type, name, count);
541 }
542
543 /// @brief adds variable array to struct
548
549 /// @brief adds variable to layout
550 _GLSL_STRUCT_CONSTEXPR17 _layout_type& add_variable(_layout_type& layoutRef, const std::string_view type,
551 const std::string_view name) {
552 return _add_variable(layoutRef, type, name);
553 }
554
555 /// @brief adds variable to struct
560
561 /// @brief adds variable to layout
562 _GLSL_STRUCT_CONSTEXPR17 _layout_type& add_variable(_layout_type& layoutRef, const std::string_view varStr) {
563 return _add_variable(layoutRef, varStr);
564 }
565
566 /// @brief adds variable to struct
570
571 /// @brief adds variables to layout
572 _GLSL_STRUCT_CONSTEXPR17 _layout_type& add_variables(_layout_type& layoutRef, const std::string_view varsStr) {
573 return _add_variables(layoutRef, varsStr);
574 }
575
576 /// @brief adds variables to struct
580
581 #pragma endregion
582
583 #pragma region STRUCTS_PARSER
584
585 /// @brief adds struct definition
586 _GLSL_STRUCT_CONSTEXPR17 void add_struct_definition(const std::string_view name, const std::string_view varsStr) {
587 _structsBodies.emplace(name.data(), varsStr.data());
588 }
589
590 /// @brief adds struct definition
591 _GLSL_STRUCT_CONSTEXPR17 void add_struct_definition(const std::string_view structStr) {
592 const auto [name, body] = _extract_struct_data(structStr);
593 add_struct_definition(name, body);
594 }
595
596 /// @brief adds structs definitions
597 _GLSL_STRUCT_CONSTEXPR17 void add_structs_definitions(const std::string_view structsStr) {
598 for (const auto& structStr : _extract_structs(structsStr)) { add_struct_definition(structStr); }
599 }
600
601 /// @brief creates layout with given variables
606
607 /// @brief creates struct with given variables
611
612 /// @brief get layout of struct earlier defined
613 _GLSL_STRUCT_CONSTEXPR17 _layout_type get_struct_layout(const std::string_view structName) {
614 if (!_load_layout(structName)) {
615 glsl_struct_assert(false, "Couldn't find definition for struct with name '{}'", structName);
616 return {};
617 }
618
619 return _structsLayouts.at(structName.data());
620 }
621
622 /// @brief get struct earlier defined
626
627 /// @brief creates layouts from strings array
637
638 /// @brief creates layouts from string
642
643 /// @brief creates structs from strings array
653
654 /// @brief creates structs from string
658
659 /// @brief gets layouts with names in array
668
669 /// @brief gets structs with names in array
678
679 #pragma endregion
680 };
681
682 /**
683 * @ingroup glslstruct
684 * @brief parser for std140 layout
685 */
686 using std140_parser = base_parser<std140_layout>;
687 /**
688 * @ingroup glslstruct
689 * @brief parser for std430 layout
690 */
691 using std430_parser = base_parser<std430_layout>;
692 /**
693 * @ingroup glslstruct
694 * @brief parser for scalar layout
695 */
696 using scalar_parser = base_parser<scalar_layout>;
697
698} // namespace glslstruct
699
700 #endif
701#endif
glslstruct::base_parser
base template class of structs parser
Definition base_parser.hpp:227
glslstruct::base_parser::create_struct_layout
_GLSL_STRUCT_CONSTEXPR17 _layout_type create_struct_layout(const std::string_view varsStr)
creates layout with given variables
Definition base_parser.hpp:602
glslstruct::base_parser::create_struct
_GLSL_STRUCT_CONSTEXPR17 _struct_type create_struct(const std::string_view varsStr)
creates struct with given variables
Definition base_parser.hpp:608
glslstruct::base_parser::get_structs
_GLSL_STRUCT_CONSTEXPR20 std::vector< _struct_type > get_structs(const std::vector< std::string_view > &structsNames)
gets structs with names in array
Definition base_parser.hpp:670
glslstruct::base_parser::get_structs_layouts
_GLSL_STRUCT_CONSTEXPR20 std::vector< _layout_type > get_structs_layouts(const std::vector< std::string > &structsNames)
gets layouts with names in array
Definition base_parser.hpp:660
glslstruct::base_parser::add_variable
_GLSL_STRUCT_CONSTEXPR17 _struct_type & add_variable(_struct_type &structRef, const std::string_view varStr)
adds variable to struct
Definition base_parser.hpp:567
glslstruct::base_parser::_add_mat_variable
static _GLSL_STRUCT_CONSTEXPR17 S & _add_mat_variable(S &ref, const size_t cols, const size_t rows, const std::string_view name, const size_t count)
adds mat with name and with provided columns and rows to struct or layout
Definition base_parser.hpp:342
glslstruct::base_parser::_contains_struct_body
_GLSL_STRUCT_CONSTEXPR17 bool _contains_struct_body(const std::string_view name)
returns true if struct with given name is in _structsBodies
Definition base_parser.hpp:432
glslstruct::base_parser::add_variable
_GLSL_STRUCT_CONSTEXPR17 _struct_type & add_variable(_struct_type &structRef, const std::string_view type, const std::string_view name)
adds variable to struct
Definition base_parser.hpp:556
glslstruct::base_parser::_structsLayouts
std::unordered_map< std::string, _layout_type > _structsLayouts
loaded and converted to layouts structs
Definition base_parser.hpp:246
glslstruct::base_parser::add_variables
_GLSL_STRUCT_CONSTEXPR17 _layout_type & add_variables(_layout_type &layoutRef, const std::string_view varsStr)
adds variables to layout
Definition base_parser.hpp:572
glslstruct::base_parser::_extract_structs
_GLSL_STRUCT_CONSTEXPR20 std::vector< std::string > _extract_structs(const std::string_view structsStr)
extracts struct strings from structs list
Definition base_parser.hpp:394
glslstruct::base_parser::add_variables
_GLSL_STRUCT_CONSTEXPR17 _struct_type & add_variables(_struct_type &structRef, const std::string_view varsStr)
adds variables to struct
Definition base_parser.hpp:577
glslstruct::base_parser::create_structs
_GLSL_STRUCT_CONSTEXPR17 std::vector< _struct_type > create_structs(const std::vector< std::string > &structsStrs)
creates structs from strings array
Definition base_parser.hpp:644
glslstruct::base_parser::_add_vec_variable
static _GLSL_STRUCT_CONSTEXPR17 S & _add_vec_variable(S &ref, const ValueType type, const size_t length, const std::string_view name, const size_t count)
adds vec with name and of type based on ValueType and with provided length to struct or layout
Definition base_parser.hpp:312
glslstruct::base_parser::create_structs_layouts
_GLSL_STRUCT_CONSTEXPR17 std::vector< _layout_type > create_structs_layouts(const std::string_view structsStr)
creates layouts from string
Definition base_parser.hpp:639
glslstruct::base_parser::_add_variable
_GLSL_STRUCT_CONSTEXPR20 S & _add_variable(S &ref, const std::string_view varStr)
adds variable given in string
Definition base_parser.hpp:501
glslstruct::base_parser::get_struct
_GLSL_STRUCT_CONSTEXPR17 _struct_type get_struct(const std::string_view structName)
get struct earlier defined
Definition base_parser.hpp:623
glslstruct::base_parser::create_structs
_GLSL_STRUCT_CONSTEXPR17 std::vector< _struct_type > create_structs(const std::string_view structsStr)
creates structs from string
Definition base_parser.hpp:655
glslstruct::base_parser::has_ssbo_pattern
static _GLSL_STRUCT_CONSTEXPR17 bool has_ssbo_pattern
returns true if given layout can be used by ssbo
Definition base_parser.hpp:241
glslstruct::base_parser::add_structs_definitions
_GLSL_STRUCT_CONSTEXPR17 void add_structs_definitions(const std::string_view structsStr)
adds structs definitions
Definition base_parser.hpp:597
glslstruct::base_parser::_get_value_type_from_string
static _GLSL_STRUCT_CONSTEXPR17 ValueType _get_value_type_from_string(const std::string_view type) noexcept
returns ValueType based on type in string
Definition base_parser.hpp:251
glslstruct::base_parser::add_variable
_GLSL_STRUCT_CONSTEXPR17 _layout_type & add_variable(_layout_type &layoutRef, const std::string_view type, const std::string_view name, const size_t count)
adds variable array to layout
Definition base_parser.hpp:538
glslstruct::base_parser::_contains_struct_layout
_GLSL_STRUCT_CONSTEXPR17 bool _contains_struct_layout(const std::string_view name)
returns true if struct with given name is in _structsLayouts
Definition base_parser.hpp:441
glslstruct::base_parser::add_variable
_GLSL_STRUCT_CONSTEXPR17 _layout_type & add_variable(_layout_type &layoutRef, const std::string_view type, const std::string_view name)
adds variable to layout
Definition base_parser.hpp:550
glslstruct::base_parser::_extract_struct_data
_GLSL_STRUCT_CONSTEXPR20 std::pair< std::string, std::string > _extract_struct_data(const std::string_view structStr)
extracts name and body of structure from string
Definition base_parser.hpp:371
glslstruct::base_parser::create_structs_layouts
_GLSL_STRUCT_CONSTEXPR20 std::vector< _layout_type > create_structs_layouts(const std::vector< std::string > &structs)
creates layouts from strings array
Definition base_parser.hpp:628
glslstruct::base_parser::_create_layout
_GLSL_STRUCT_CONSTEXPR17 _layout_type _create_layout(const std::string_view varsStr)
creates layout with variables in vars list
Definition base_parser.hpp:412
glslstruct::base_parser::_load_layout
_GLSL_STRUCT_CONSTEXPR17 bool _load_layout(const std::string_view structName)
loads layout from structsBodies to structsLayouts and returns if there is a layout with given name in...
Definition base_parser.hpp:418
glslstruct::base_parser::_structsBodies
std::unordered_map< std::string, std::string > _structsBodies
loaded and not converted to layouts structs bodies
Definition base_parser.hpp:244
glslstruct::base_parser::_add_vec_variable
static _GLSL_STRUCT_CONSTEXPR17 S & _add_vec_variable(S &ref, const size_t length, const std::string_view name, const size_t count)
adds vec with name and with provided length to struct or layout
Definition base_parser.hpp:300
glslstruct::base_parser::_add_variable
_GLSL_STRUCT_CONSTEXPR20 S & _add_variable(S &ref, const std::string_view type, const std::string_view name, const size_t count=0)
adds variable of type given in string and with name and count
Definition base_parser.hpp:455
glslstruct::base_parser::get_struct_layout
_GLSL_STRUCT_CONSTEXPR17 _layout_type get_struct_layout(const std::string_view structName)
get layout of struct earlier defined
Definition base_parser.hpp:613
glslstruct::base_parser::base_parser
_GLSL_STRUCT_CONSTEXPR17 base_parser()=default
default constructor
glslstruct::base_parser::_layout_type
Layout _layout_type
layout type
Definition base_parser.hpp:230
glslstruct::base_parser::_add_variables
_GLSL_STRUCT_CONSTEXPR20 S & _add_variables(S &ref, const std::string_view varsStr)
adds variables given in var list string
Definition base_parser.hpp:517
glslstruct::base_parser::_add_scalar_variable
static _GLSL_STRUCT_CONSTEXPR17 S & _add_scalar_variable(S &ref, const ValueType type, const std::string_view name, const size_t count)
adds scalar with name and of type based on ValueType to struct or layout
Definition base_parser.hpp:282
glslstruct::base_parser::add_variable
_GLSL_STRUCT_CONSTEXPR17 _layout_type & add_variable(_layout_type &layoutRef, const std::string_view varStr)
adds variable to layout
Definition base_parser.hpp:562
glslstruct::base_parser::add_struct_definition
_GLSL_STRUCT_CONSTEXPR17 void add_struct_definition(const std::string_view structStr)
adds struct definition
Definition base_parser.hpp:591
glslstruct::base_parser::_add_mat_variable
static _GLSL_STRUCT_CONSTEXPR17 S & _add_mat_variable(S &ref, const size_t rows, const std::string_view name, const size_t count)
adds mat with name and with provided rows to struct or layout
Definition base_parser.hpp:330
glslstruct::base_parser::add_struct_definition
_GLSL_STRUCT_CONSTEXPR17 void add_struct_definition(const std::string_view name, const std::string_view varsStr)
adds struct definition
Definition base_parser.hpp:586
glslstruct::base_parser::add_variable
_GLSL_STRUCT_CONSTEXPR17 _struct_type & add_variable(_struct_type &structRef, const std::string_view type, const std::string_view name, const size_t count)
adds variable array to struct
Definition base_parser.hpp:544
glslstruct::base_parser::has_ubo_pattern
static _GLSL_STRUCT_CONSTEXPR17 bool has_ubo_pattern
returns true if given layout can be used by ubo
Definition base_parser.hpp:239
glslstruct::base_parser::_add_variable
static _GLSL_STRUCT_CONSTEXPR17 S & _add_variable(S &ref, const std::string_view name, const size_t count)
adds variable of type T to struct or layout (if count != 0 then it adds array of variables of type T)
Definition base_parser.hpp:268
glslstruct::base_parser::_add_mat_variable
static _GLSL_STRUCT_CONSTEXPR17 S & _add_mat_variable(S &ref, const ValueType type, const size_t cols, const size_t rows, const std::string_view name, const size_t count)
adds mat with name and of type based on ValueType and with provided columns and rows to struct or lay...
Definition base_parser.hpp:354
glslstruct::base_parser::_base_patterns
utils::base_parser_patterns _base_patterns
Definition base_parser.hpp:234
_GLSL_STRUCT_HAS_PARSER
#define _GLSL_STRUCT_HAS_PARSER
check if user want to include parser functionality
Definition config.hpp:186
_GLSL_STRUCT_CONSTEXPR20
#define _GLSL_STRUCT_CONSTEXPR20
constexpr keyword for c++20 and higher
Definition config.hpp:213
glsl_struct_assert
#define glsl_struct_assert(expression,...)
glslstruct assert
Definition assert.hpp:33
_GLSL_STRUCT_HAS_CXX20
#define _GLSL_STRUCT_HAS_CXX20
check if compiler has c++ version greater or equal to c++20 and if user enabled c++20 features using ...
Definition config.hpp:142
_GLSL_STRUCT_CONSTEXPR17
#define _GLSL_STRUCT_CONSTEXPR17
constexpr for c++17 and higher
Definition config.hpp:196
glslstruct::utils
Definition writer.hpp:25
glslstruct
Main namespace of glslstruct library.
Definition contexts.hpp:20
glslstruct::utils::base_parser_patterns
all parser patterns in one struct
Definition base_parser.hpp:31
glslstruct::utils::base_parser_patterns::structPattern
static const auto structPattern
pattern to get struct data
Definition base_parser.hpp:54
glslstruct::utils::base_parser_patterns::vecPattern
static const auto vecPattern
pattern to get vec data
Definition base_parser.hpp:36
glslstruct::utils::base_parser_patterns::multiStructsPattern
static const auto multiStructsPattern
pattern to get multiple structs
Definition base_parser.hpp:58
glslstruct::utils::base_parser_patterns::matPattern
static const auto matPattern
pattern to get mat data
Definition base_parser.hpp:39
glslstruct::utils::base_parser_patterns::scalarsPattern
static const auto scalarsPattern
pattern to get scalar data
Definition base_parser.hpp:33
glslstruct::utils::base_parser_patterns::variablePattern
static const auto variablePattern
pattern to get variable data
Definition base_parser.hpp:43
glslstruct::utils::base_parser_patterns::multiVariablesPattern
static const auto multiVariablesPattern
pattern to get multiple variables
Definition base_parser.hpp:48
glslstruct::utils::ssbo_parser_pattern
container for ssbo parser pattern
Definition base_parser.hpp:140
glslstruct::utils::ubo_parser_pattern
container for ubo parser pattern
Definition base_parser.hpp:76