#!/usr/bin/env python3 # # Copyright (c) 2015-2016 The Khronos Group Inc. # Copyright (c) 2015-2016 Valve Corporation # Copyright (c) 2015-2016 LunarG, Inc. # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. # # Author: Jon Ashburn # import os, sys # add main repo directory so vulkan.py can be imported. This needs to be a complete path. ld_path = os.path.dirname(os.path.abspath(__file__)) main_path = os.path.abspath(ld_path + "/../") sys.path.append(main_path) import vulkan def generate_get_proc_addr_check(name): return " if (!%s || %s[0] != 'v' || %s[1] != 'k')\n" \ " return NULL;" % ((name,) * 3) class Subcommand(object): def __init__(self, argv): self.argv = argv self.headers = vulkan.headers self.protos = vulkan.protos def run(self): print(self.generate()) def _requires_special_trampoline_code(self, name): # Don't be cute trying to use a general rule to programmatically populate this list # it just obsfucates what is going on! wsi_creates_dispatchable_object = ["CreateSwapchainKHR"] creates_dispatchable_object = ["CreateDevice", "GetDeviceQueue", "AllocateCommandBuffers"] + wsi_creates_dispatchable_object if name in creates_dispatchable_object: return True else: return False def _is_loader_non_trampoline_entrypoint(self, proto): if proto.name in ["GetDeviceProcAddr", "EnumeratePhysicalDevices", "EnumerateLayers", "DbgRegisterMsgCallback", "DbgUnregisterMsgCallback", "DbgSetGlobalOption", "DestroyInstance"]: return True return not self.is_dispatchable_object_first_param(proto) def is_dispatchable_object_first_param(self, proto): in_objs = proto.object_in_params() non_dispatch_objs = [] param0 = proto.params[0] return (len(in_objs) > 0) and (in_objs[0].ty == param0.ty) and (param0.ty not in non_dispatch_objs) def generate(self): copyright = self.generate_copyright() header = self.generate_header() body = self.generate_body() footer = self.generate_footer() contents = [] if copyright: contents.append(copyright) if header: contents.append(header) if body: contents.append(body) if footer: contents.append(footer) return "\n\n".join(contents) def generate_copyright(self): return """/* THIS FILE IS GENERATED. DO NOT EDIT. */ /* * Copyright (c) 2015-2016 The Khronos Group Inc. * Copyright (c) 2015-2016 Valve Corporation * Copyright (c) 2015-2016 LunarG, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * * Author: Jon Ashburn * Author: Chia-I Wu * Author: Courtney Goeltzenleuchter */""" def generate_header(self): return "\n".join(["#include <" + h + ">" for h in self.headers]) def generate_body(self): pass def generate_footer(self): pass class DispatchTableOpsSubcommand(Subcommand): def run(self): if len(self.argv) != 1: print("DispatchTableOpsSubcommand: unspecified") return self.prefix = self.argv[0] super().run() def generate_header(self): return "\n".join(["#include ", "#include ", "#include ", "#include \"loader_platform.h\""]) def _generate_init(self, type): stmts = [] func = [] if type == "device": for proto in self.protos: if self.is_dispatchable_object_first_param(proto) or proto.name == "CreateInstance": stmts.append("table->%s = (PFN_vk%s) gpa(gpu, \"vk%s\");" % (proto.name, proto.name, proto.name)) else: stmts.append("table->%s = vk%s; /* non-dispatchable */" % (proto.name, proto.name)) func.append("static inline void %s_init_device_dispatch_table(VkLayerDispatchTable *table," % self.prefix) func.append("%s PFN_vkGetDeviceProcAddr gpa," % (" " * len(self.prefix))) func.append("%s VkPhysicalDevice gpu)" % (" " * len(self.prefix))) else: for proto in self.protos: if proto.params[0].ty != "VkInstance" and proto.params[0].ty != "VkPhysicalDevice": continue stmts.append("table->%s = vk%s;" % (proto.name, proto.name)) func.append("static inline void %s_init_instance_dispatch_table(VkLayerInstanceDispatchTable *table)" % self.prefix) func.append("{") func.append(" %s" % "\n ".join(stmts)) func.append("}") return "\n".join(func) def _generate_lookup(self): lookups = [] for proto in self.protos: if self.is_dispatchable_object_first_param(proto): lookups.append("if (!strcmp(name, \"%s\"))" % (proto.name)) lookups.append(" return (void *) table->%s;" % (proto.name)) func = [] func.append("static inline void *%s_lookup_dispatch_table(const VkLayerDispatchTable *table," % self.prefix) func.append("%s const char *name)" % (" " * len(self.prefix))) func.append("{") func.append(generate_get_proc_addr_check("name")) func.append("") func.append(" name += 2;") func.append(" %s" % "\n ".join(lookups)) func.append("") func.append(" return NULL;") func.append("}") return "\n".join(func) def generate_body(self): body = [self._generate_init("device"), self._generate_lookup(), self._generate_init("instance")] return "\n\n".join(body) class WinDefFileSubcommand(Subcommand): def run(self): library_exports = { "all": [], } if len(self.argv) != 2 or self.argv[1] not in library_exports: print("WinDefFileSubcommand: {%s}" % "|".join(library_exports.keys())) return self.library = self.argv[0] self.exports = library_exports[self.argv[1]] super().run() def generate_copyright(self): return """; THIS FILE IS GENERATED. DO NOT EDIT. ;;;; Begin Copyright Notice ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ; Copyright (c) 2015-2016 The Khronos Group Inc. ; Copyright (c) 2015-2016 Valve Corporation ; Copyright (c) 2015-2016 LunarG, Inc. ; ; Licensed under the Apache License, Version 2.0 (the "License"); ; you may not use this file except in compliance with the License. ; You may obtain a copy of the License at ; ; http://www.apache.org/licenses/LICENSE-2.0 ; ; Unless required by applicable law or agreed to in writing, software ; distributed under the License is distributed on an "AS IS" BASIS, ; WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. ; See the License for the specific language governing permissions and ; limitations under the License. ; ; ; Author: Jon Ashburn ;;;; End Copyright Notice ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;""" def generate_header(self): return "; The following is required on Windows, for exporting symbols from the DLL" def generate_body(self): body = [] body.append("LIBRARY " + self.library) body.append("EXPORTS") for proto in self.protos: if self.exports and proto.name not in self.exports: continue # This was intended to reject WSI calls, but actually rejects ALL extensions # TODO: Make this WSI-extension specific # if proto.name.endswith("KHR"): # continue body.append(" vk" + proto.name) return "\n".join(body) def main(): wsi = { "Win32", "Android", "Xcb", "Xlib", "Wayland", "Mir" } subcommands = { "dispatch-table-ops": DispatchTableOpsSubcommand, "win-def-file": WinDefFileSubcommand, } if len(sys.argv) < 3 or sys.argv[1] not in wsi or sys.argv[2] not in subcommands: print("Usage: %s [options]" % sys.argv[0]) print print("Available wsi (displayservers) are: %s" % " ".join(wsi)) print("Available subcommands are: %s" % " ".join(subcommands)) exit(1) subcmd = subcommands[sys.argv[2]](sys.argv[3:]) subcmd.run() if __name__ == "__main__": main()