mirror of
https://github.com/KhronosGroup/Vulkan-Utility-Libraries.git
synced 2025-05-14 16:58:43 +00:00

This code was being generated in both Vulkan-ValidationLayers and Vulkan-ExtensionLayer. Further uses are on the horizon so lets stop the copypasta. Also, add functions to manipulate extension lists and pNext chains, since many client layers have been doing that themselves.
115 lines
4.8 KiB
Python
115 lines
4.8 KiB
Python
#!/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
|
|
from generators.generator_utils import PlatformGuardHelper
|
|
|
|
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
|
|
|
|
// clang-format off
|
|
|
|
#ifdef __cplusplus
|
|
#include <string>
|
|
#endif
|
|
#include <vulkan/vulkan.h>
|
|
''')
|
|
guard_helper = PlatformGuardHelper()
|
|
|
|
# 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(guard_helper.add_guard(enum.protect))
|
|
out.append(f'static inline const char* string_{enum.name}({groupType} input_value) {{\n')
|
|
out.append(' switch (input_value) {\n')
|
|
enum_field_guard_helper = PlatformGuardHelper()
|
|
for field in enum.fields:
|
|
out.extend(enum_field_guard_helper.add_guard(field.protect))
|
|
out.append(f' case {field.name}:\n')
|
|
out.append(f' return "{field.name}";\n')
|
|
out.extend(enum_field_guard_helper.add_guard(None))
|
|
out.append(' default:\n')
|
|
out.append(f' return "Unhandled {enum.name}";\n')
|
|
out.append(' }\n')
|
|
out.append('}\n')
|
|
out.extend(guard_helper.add_guard(None))
|
|
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(guard_helper.add_guard(bitmask.protect))
|
|
out.append(f'static inline const char* string_{bitmask.name}({groupType} input_value) {{\n')
|
|
|
|
bitmask_field_guard_helper = PlatformGuardHelper()
|
|
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(bitmask_field_guard_helper.add_guard(flag.protect))
|
|
out.append(f' case {flag.name}:\n')
|
|
out.append(f' return "{flag.name}";\n')
|
|
out.extend(bitmask_field_guard_helper.add_guard(None))
|
|
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(bitmask_field_guard_helper.add_guard(flag.protect))
|
|
out.append(f' if (input_value == {flag.name}) return "{flag.name}";\n')
|
|
out.extend(bitmask_field_guard_helper.add_guard(None))
|
|
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.append('#endif // __cplusplus\n')
|
|
out.extend(guard_helper.add_guard(None))
|
|
out.append('// clang-format on')
|
|
self.write("".join(out))
|