#!/usr/bin/python3 -i # # Copyright 2023 The Khronos Group Inc. # Copyright 2023 Valve Corporation # Copyright 2023 LunarG, Inc. # # SPDX-License-Identifier: Apache-2.0 import os from generators.base_generator import BaseGenerator class EnumStringHelperOutputGenerator(BaseGenerator): def __init__(self): BaseGenerator.__init__(self) def generate(self): out = [] out.append(f'''// *** THIS FILE IS GENERATED - DO NOT EDIT *** // See {os.path.basename(__file__)} for modifications // Copyright 2023 The Khronos Group Inc. // Copyright 2023 Valve Corporation // Copyright 2023 LunarG, Inc. // // SPDX-License-Identifier: Apache-2.0 ''') out.append(''' #pragma once #ifdef __cplusplus #include #endif #include ''') # If there are no fields (empty enum) ignore for enum in [x for x in self.vk.enums.values() if len(x.fields) > 0]: groupType = enum.name if enum.bitWidth == 32 else 'uint64_t' out.extend([f'#ifdef {enum.protect}\n'] if enum.protect else []) out.append(f'static inline const char* string_{enum.name}({groupType} input_value) {{\n') out.append(' switch (input_value) {\n') for field in enum.fields: out.extend([f'#ifdef {field.protect}\n'] if field.protect else []) out.append(f' case {field.name}:\n') out.append(f' return "{field.name}";\n') out.extend([f'#endif //{field.protect}\n'] if field.protect else []) out.append(' default:\n') out.append(f' return "Unhandled {enum.name}";\n') out.append(' }\n') out.append('}\n') out.extend([f'#endif //{enum.protect}\n'] if enum.protect else []) out.append('\n') # For bitmask, first create a string for FlagBits, then a Flags version that calls into it # If there are no flags (empty bitmask) ignore for bitmask in [x for x in self.vk.bitmasks.values() if len(x.flags) > 0]: groupType = bitmask.name if bitmask.bitWidth == 32 else 'uint64_t' # switch labels must be constant expressions. In C a const-qualified variable is not a constant expression. use_switch_statement = True if groupType == 'uint64_t': use_switch_statement = False out.extend([f'#ifdef {bitmask.protect}\n'] if bitmask.protect else []) out.append(f'static inline const char* string_{bitmask.name}({groupType} input_value) {{\n') if use_switch_statement: out.append(' switch (input_value) {\n') for flag in [x for x in bitmask.flags if not x.multiBit]: out.extend([f'#ifdef {flag.protect}\n'] if flag.protect else []) out.append(f' case {flag.name}:\n') out.append(f' return "{flag.name}";\n') out.extend([f'#endif //{flag.protect}\n'] if flag.protect else []) out.append(' default:\n') out.append(f' return "Unhandled {bitmask.name}";\n') out.append(' }\n') else: # We need to use if statements for flag in [x for x in bitmask.flags if not x.multiBit]: out.extend([f'#ifdef {flag.protect}\n'] if flag.protect else []) out.append(f' if (input_value == {flag.name}) return "{flag.name}";\n') out.extend([f'#endif //{flag.protect}\n'] if flag.protect else []) out.append(f' return "Unhandled {bitmask.name}";\n') out.append('}\n') mulitBitChecks = '' for flag in [x for x in bitmask.flags if x.multiBit]: mulitBitChecks += f' if (input_value == {flag.name}) {{ return "{flag.name}"; }}\n' intSuffix = 'U' if bitmask.bitWidth == 32 else 'ULL' out.append('\n#ifdef __cplusplus') out.append(f''' static inline std::string string_{bitmask.flagName}({bitmask.flagName} input_value) {{ {mulitBitChecks} std::string ret; int index = 0; while(input_value) {{ if (input_value & 1) {{ if( !ret.empty()) ret.append("|"); ret.append(string_{bitmask.name}(static_cast<{groupType}>(1{intSuffix} << index))); }} ++index; input_value >>= 1; }} if (ret.empty()) ret.append("{bitmask.flagName}(0)"); return ret; }}\n''') out.extend([f'#endif //{bitmask.protect}\n'] if bitmask.protect else []) out.append('#endif // __cplusplus\n') self.write("".join(out))