blob: 46daad5fb2c72f217c2ceb0a0ac9f225232cfaa5 [file] [log] [blame]
Tobin Ehlis3ed06942014-11-10 16:03:19 -07001#!/usr/bin/env python3
2#
Courtney Goeltzenleuchter9cc421e2015-04-08 15:36:08 -06003# VK
Tobin Ehlis3ed06942014-11-10 16:03:19 -07004#
5# Copyright (C) 2014 LunarG, Inc.
6#
7# Permission is hereby granted, free of charge, to any person obtaining a
8# copy of this software and associated documentation files (the "Software"),
9# to deal in the Software without restriction, including without limitation
10# the rights to use, copy, modify, merge, publish, distribute, sublicense,
11# and/or sell copies of the Software, and to permit persons to whom the
12# Software is furnished to do so, subject to the following conditions:
13#
14# The above copyright notice and this permission notice shall be included
15# in all copies or substantial portions of the Software.
16#
17# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
20# THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
21# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
22# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
23# DEALINGS IN THE SOFTWARE.
Tobin Ehlisee33fa52014-10-22 15:13:53 -060024import argparse
25import os
26import sys
Tobin Ehlisfde2fc32015-06-12 12:49:01 -060027from source_line_info import sourcelineinfo
Tobin Ehlisee33fa52014-10-22 15:13:53 -060028
Tobin Ehlisfde2fc32015-06-12 12:49:01 -060029# vk_helper.py overview
30# This script generates code based on vulkan input header
31# It generate wrappers functions that can be used to display
Tobin Ehlisee33fa52014-10-22 15:13:53 -060032# structs in a human-readable txt format, as well as utility functions
33# to print enum values as strings
34
Tobin Ehlisee33fa52014-10-22 15:13:53 -060035def handle_args():
36 parser = argparse.ArgumentParser(description='Perform analysis of vogl trace.')
37 parser.add_argument('input_file', help='The input header file from which code will be generated.')
38 parser.add_argument('--rel_out_dir', required=False, default='glave_gen', help='Path relative to exec path to write output files. Will be created if needed.')
39 parser.add_argument('--abs_out_dir', required=False, default=None, help='Absolute path to write output files. Will be created if needed.')
40 parser.add_argument('--gen_enum_string_helper', required=False, action='store_true', default=False, help='Enable generation of helper header file to print string versions of enums.')
41 parser.add_argument('--gen_struct_wrappers', required=False, action='store_true', default=False, help='Enable generation of struct wrapper classes.')
42 parser.add_argument('--gen_cmake', required=False, action='store_true', default=False, help='Enable generation of cmake file for generated code.')
43 parser.add_argument('--gen_graphviz', required=False, action='store_true', default=False, help='Enable generation of graphviz dot file.')
44 #parser.add_argument('--test', action='store_true', default=False, help='Run simple test.')
45 return parser.parse_args()
46
47# TODO : Ideally these data structs would be opaque to user and could be wrapped
48# in their own class(es) to make them friendly for data look-up
49# Dicts for Data storage
50# enum_val_dict[value_name] = dict keys are the string enum value names for all enums
51# |-------->['type'] = the type of enum class into which the value falls
52# |-------->['val'] = the value assigned to this particular value_name
53# '-------->['unique'] = bool designating if this enum 'val' is unique within this enum 'type'
54enum_val_dict = {}
55# enum_type_dict['type'] = the type or class of of enum
56# '----->['val_name1', 'val_name2'...] = each type references a list of val_names within this type
57enum_type_dict = {}
58# struct_dict['struct_basename'] = the base (non-typedef'd) name of the struct
59# |->[<member_num>] = members are stored via their integer placement in the struct
60# | |->['name'] = string name of this struct member
61# ... |->['full_type'] = complete type qualifier for this member
62# |->['type'] = base type for this member
63# |->['ptr'] = bool indicating if this member is ptr
64# |->['const'] = bool indicating if this member is const
65# |->['struct'] = bool indicating if this member is a struct type
66# |->['array'] = bool indicating if this member is an array
Tobin Ehlisf57562c2015-03-13 07:18:05 -060067# |->['dyn_array'] = bool indicating if member is a dynamically sized array
68# '->['array_size'] = For dyn_array, member name used to size array, else int size for static array
Tobin Ehlisee33fa52014-10-22 15:13:53 -060069struct_dict = {}
70# typedef_fwd_dict stores mapping from orig_type_name -> new_type_name
71typedef_fwd_dict = {}
72# typedef_rev_dict stores mapping from new_type_name -> orig_type_name
73typedef_rev_dict = {} # store new_name -> orig_name mapping
74# types_dict['id_name'] = identifier name will map to it's type
75# '---->'type' = currently either 'struct' or 'enum'
76types_dict = {} # store orig_name -> type mapping
77
78
79# Class that parses header file and generates data structures that can
80# Then be used for other tasks
81class HeaderFileParser:
82 def __init__(self, header_file=None):
83 self.header_file = header_file
84 # store header data in various formats, see above for more info
85 self.enum_val_dict = {}
86 self.enum_type_dict = {}
87 self.struct_dict = {}
88 self.typedef_fwd_dict = {}
89 self.typedef_rev_dict = {}
90 self.types_dict = {}
Tobin Ehlis91cc24a2015-03-06 10:38:25 -070091 self.last_struct_count_name = ''
Tobin Ehlisee33fa52014-10-22 15:13:53 -060092
93 def setHeaderFile(self, header_file):
94 self.header_file = header_file
95
96 def get_enum_val_dict(self):
97 return self.enum_val_dict
98
99 def get_enum_type_dict(self):
100 return self.enum_type_dict
101
102 def get_struct_dict(self):
103 return self.struct_dict
104
105 def get_typedef_fwd_dict(self):
106 return self.typedef_fwd_dict
107
108 def get_typedef_rev_dict(self):
109 return self.typedef_rev_dict
110
111 def get_types_dict(self):
112 return self.types_dict
113
114 # Parse header file into data structures
115 def parse(self):
116 # parse through the file, identifying different sections
117 parse_enum = False
118 parse_struct = False
119 member_num = 0
120 # TODO : Comment parsing is very fragile but handles 2 known files
121 block_comment = False
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700122 prev_count_name = ''
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600123 with open(self.header_file) as f:
124 for line in f:
125 if block_comment:
126 if '*/' in line:
127 block_comment = False
128 continue
129 if '/*' in line:
130 block_comment = True
131 elif 0 == len(line.split()):
132 #print("Skipping empty line")
133 continue
134 elif line.split()[0].strip().startswith("//"):
Jon Ashburna0ddc902015-01-09 09:11:44 -0700135 #print("Skipping commented line %s" % line)
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600136 continue
137 elif 'typedef enum' in line:
138 (ty_txt, en_txt, base_type) = line.strip().split(None, 2)
139 #print("Found ENUM type %s" % base_type)
140 parse_enum = True
Jon Ashburna0ddc902015-01-09 09:11:44 -0700141 default_enum_val = 0
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600142 self.types_dict[base_type] = 'enum'
143 elif 'typedef struct' in line:
144 (ty_txt, st_txt, base_type) = line.strip().split(None, 2)
145 #print("Found STRUCT type: %s" % base_type)
146 parse_struct = True
147 self.types_dict[base_type] = 'struct'
Jon Ashburna0ddc902015-01-09 09:11:44 -0700148 elif 'typedef union' in line:
149 (ty_txt, st_txt, base_type) = line.strip().split(None, 2)
150 #print("Found UNION type: %s" % base_type)
151 parse_struct = True
152 self.types_dict[base_type] = 'struct'
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600153 elif '}' in line and (parse_enum or parse_struct):
154 if len(line.split()) > 1: # deals with embedded union in one struct
155 parse_enum = False
156 parse_struct = False
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700157 self.last_struct_count_name = ''
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600158 member_num = 0
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600159 (cur_char, targ_type) = line.strip().split(None, 1)
160 self.typedef_fwd_dict[base_type] = targ_type.strip(';')
161 self.typedef_rev_dict[targ_type.strip(';')] = base_type
Courtney Goeltzenleuchterddcb6192015-04-14 18:48:46 -0600162 #print("fwd_dict: %s = %s" % (base_type, targ_type))
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600163 elif parse_enum:
Courtney Goeltzenleuchter9cc421e2015-04-08 15:36:08 -0600164 #if 'VK_MAX_ENUM' not in line and '{' not in line:
165 if True not in [ens in line for ens in ['{', 'VK_MAX_ENUM', '_RANGE']]:
Jon Ashburna0ddc902015-01-09 09:11:44 -0700166 self._add_enum(line, base_type, default_enum_val)
167 default_enum_val += 1
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600168 elif parse_struct:
169 if ';' in line:
170 self._add_struct(line, base_type, member_num)
171 member_num = member_num + 1
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600172
173 # populate enum dicts based on enum lines
Jon Ashburna0ddc902015-01-09 09:11:44 -0700174 def _add_enum(self, line_txt, enum_type, def_enum_val):
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600175 #print("Parsing enum line %s" % line_txt)
Jon Ashburna0ddc902015-01-09 09:11:44 -0700176 if '=' in line_txt:
177 (enum_name, eq_char, enum_val) = line_txt.split(None, 2)
178 else:
179 enum_name = line_txt.split(',')[0]
180 enum_val = str(def_enum_val)
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600181 self.enum_val_dict[enum_name] = {}
182 self.enum_val_dict[enum_name]['type'] = enum_type
183 # strip comma and comment, then extra split in case of no comma w/ comments
184 enum_val = enum_val.strip().split(',', 1)[0]
185 self.enum_val_dict[enum_name]['val'] = enum_val.split()[0]
Tobin Ehlis3ed9f8f2015-04-22 13:59:43 -0600186 # Perform conversion of VK_BIT macro
187 if 'VK_BIT' in self.enum_val_dict[enum_name]['val']:
188 vk_bit_val = self.enum_val_dict[enum_name]['val']
189 bit_shift = int(vk_bit_val[vk_bit_val.find('(')+1:vk_bit_val.find(')')], 0)
190 self.enum_val_dict[enum_name]['val'] = str(1 << bit_shift)
191 else:
192 # account for negative values surrounded by parens
193 self.enum_val_dict[enum_name]['val'] = self.enum_val_dict[enum_name]['val'].strip(')').replace('-(', '-')
Tobin Ehlis5e848502014-12-05 12:13:07 -0700194 # Try to cast to int to determine if enum value is unique
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600195 try:
196 #print("ENUM val:", self.enum_val_dict[enum_name]['val'])
197 int(self.enum_val_dict[enum_name]['val'], 0)
198 self.enum_val_dict[enum_name]['unique'] = True
199 #print("ENUM has num value")
200 except ValueError:
201 self.enum_val_dict[enum_name]['unique'] = False
202 #print("ENUM is not a number value")
203 # Update enum_type_dict as well
204 if not enum_type in self.enum_type_dict:
205 self.enum_type_dict[enum_type] = []
206 self.enum_type_dict[enum_type].append(enum_name)
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700207
208 # Return True of struct member is a dynamic array
209 # RULES : This is a bit quirky based on the API
210 # NOTE : Changes in API spec may cause these rules to change
211 # 1. There must be a previous uint var w/ 'count' in the name in the struct
212 # 2. Dynam array must have 'const' and '*' qualifiers
213 # 3a. Name of dynam array must end in 's' char OR
214 # 3b. Name of count var minus 'count' must be contained in name of dynamic array
215 def _is_dynamic_array(self, full_type, name):
216 if '' != self.last_struct_count_name:
217 if 'const' in full_type and '*' in full_type:
218 if name.endswith('s') or self.last_struct_count_name.lower().replace('count', '') in name.lower():
219 return True
220 return False
221
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600222 # populate struct dicts based on struct lines
223 # TODO : Handle ":" bitfield, "**" ptr->ptr and "const type*const*"
224 def _add_struct(self, line_txt, struct_type, num):
225 #print("Parsing struct line %s" % line_txt)
226 if not struct_type in self.struct_dict:
227 self.struct_dict[struct_type] = {}
228 members = line_txt.strip().split(';', 1)[0] # first strip semicolon & comments
229 # TODO : Handle bitfields more correctly
230 members = members.strip().split(':', 1)[0] # strip bitfield element
231 (member_type, member_name) = members.rsplit(None, 1)
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700232 # Store counts to help recognize and size dynamic arrays
Tobin Ehlise653c2d2015-04-15 16:01:16 -0600233 if 'count' in member_name.lower() and 'samplecount' != member_name.lower() and 'uint' in member_type:
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700234 self.last_struct_count_name = member_name
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600235 self.struct_dict[struct_type][num] = {}
236 self.struct_dict[struct_type][num]['full_type'] = member_type
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700237 self.struct_dict[struct_type][num]['dyn_array'] = False
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600238 if '*' in member_type:
239 self.struct_dict[struct_type][num]['ptr'] = True
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700240 # TODO : Need more general purpose way here to reduce down to basic type
241 member_type = member_type.replace(' const*', '')
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600242 member_type = member_type.strip('*')
243 else:
244 self.struct_dict[struct_type][num]['ptr'] = False
245 if 'const' in member_type:
246 self.struct_dict[struct_type][num]['const'] = True
Courtney Goeltzenleuchterddcb6192015-04-14 18:48:46 -0600247 member_type = member_type.replace('const', '').strip()
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600248 else:
249 self.struct_dict[struct_type][num]['const'] = False
Tobin Ehlis6f7029b2014-11-11 12:28:12 -0700250 # TODO : There is a bug here where it seems that at the time we do this check,
251 # the data is not in the types or typedef_rev_dict, so we never pass this if check
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600252 if is_type(member_type, 'struct'):
253 self.struct_dict[struct_type][num]['struct'] = True
254 else:
255 self.struct_dict[struct_type][num]['struct'] = False
256 self.struct_dict[struct_type][num]['type'] = member_type
257 if '[' in member_name:
258 (member_name, array_size) = member_name.split('[', 1)
Courtney Goeltzenleuchter1c7c65d2015-06-10 17:39:03 -0600259 if 'char' in member_type:
260 self.struct_dict[struct_type][num]['array'] = False
261 self.struct_dict[struct_type][num]['array_size'] = 0
262 self.struct_dict[struct_type][num]['ptr'] = True
263 else:
264 self.struct_dict[struct_type][num]['array'] = True
265 self.struct_dict[struct_type][num]['array_size'] = array_size.strip(']')
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700266 elif self._is_dynamic_array(self.struct_dict[struct_type][num]['full_type'], member_name):
267 #print("Found dynamic array %s of size %s" % (member_name, self.last_struct_count_name))
268 self.struct_dict[struct_type][num]['array'] = True
269 self.struct_dict[struct_type][num]['dyn_array'] = True
270 self.struct_dict[struct_type][num]['array_size'] = self.last_struct_count_name
Tobin Ehlisd1c0e662015-02-26 12:57:08 -0700271 elif not 'array' in self.struct_dict[struct_type][num]:
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600272 self.struct_dict[struct_type][num]['array'] = False
273 self.struct_dict[struct_type][num]['array_size'] = 0
274 self.struct_dict[struct_type][num]['name'] = member_name
275
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700276# check if given identifier is of specified type_to_check
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600277def is_type(identifier, type_to_check):
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600278 if identifier in types_dict and type_to_check == types_dict[identifier]:
279 return True
280 if identifier in typedef_rev_dict:
281 new_id = typedef_rev_dict[identifier]
282 if new_id in types_dict and type_to_check == types_dict[new_id]:
283 return True
284 return False
285
286# This is a validation function to verify that we can reproduce the original structs
287def recreate_structs():
288 for struct_name in struct_dict:
289 sys.stdout.write("typedef struct %s\n{\n" % struct_name)
290 for mem_num in sorted(struct_dict[struct_name]):
291 sys.stdout.write(" ")
292 if struct_dict[struct_name][mem_num]['const']:
293 sys.stdout.write("const ")
294 #if struct_dict[struct_name][mem_num]['struct']:
295 # sys.stdout.write("struct ")
296 sys.stdout.write (struct_dict[struct_name][mem_num]['type'])
297 if struct_dict[struct_name][mem_num]['ptr']:
298 sys.stdout.write("*")
299 sys.stdout.write(" ")
300 sys.stdout.write(struct_dict[struct_name][mem_num]['name'])
301 if struct_dict[struct_name][mem_num]['array']:
302 sys.stdout.write("[")
303 sys.stdout.write(struct_dict[struct_name][mem_num]['array_size'])
304 sys.stdout.write("]")
305 sys.stdout.write(";\n")
306 sys.stdout.write("} ")
307 sys.stdout.write(typedef_fwd_dict[struct_name])
308 sys.stdout.write(";\n\n")
309
Courtney Goeltzenleuchterddcb6192015-04-14 18:48:46 -0600310#
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -0600311# TODO: Fix construction of struct name
Courtney Goeltzenleuchterddcb6192015-04-14 18:48:46 -0600312def get_struct_name_from_struct_type(struct_type):
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -0600313 # Note: All struct types are now camel-case
Courtney Goeltzenleuchterddcb6192015-04-14 18:48:46 -0600314 caps_struct_name = struct_type.replace("_STRUCTURE_TYPE", "")
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -0600315 char_idx = 0
316 struct_name = ''
317 for char in caps_struct_name:
318 if (0 == char_idx) or (caps_struct_name[char_idx-1] == '_'):
319 struct_name += caps_struct_name[char_idx]
320 elif (caps_struct_name[char_idx] == '_'):
321 pass
322 else:
323 struct_name += caps_struct_name[char_idx].lower()
324 char_idx += 1
Courtney Goeltzenleuchterddcb6192015-04-14 18:48:46 -0600325 return struct_name
326
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600327# class for writing common file elements
328# Here's how this class lays out a file:
329# COPYRIGHT
330# HEADER
331# BODY
332# FOOTER
333#
334# For each of these sections, there's a "set*" function
335# The class as a whole has a generate function which will write each section in order
336class CommonFileGen:
337 def __init__(self, filename=None, copyright_txt="", header_txt="", body_txt="", footer_txt=""):
338 self.filename = filename
339 self.contents = {'copyright': copyright_txt, 'header': header_txt, 'body': body_txt, 'footer': footer_txt}
340 # TODO : Set a default copyright & footer at least
341
342 def setFilename(self, filename):
343 self.filename = filename
344
345 def setCopyright(self, c):
346 self.contents['copyright'] = c
347
348 def setHeader(self, h):
349 self.contents['header'] = h
350
351 def setBody(self, b):
352 self.contents['body'] = b
353
354 def setFooter(self, f):
355 self.contents['footer'] = f
356
357 def generate(self):
358 #print("Generate to file %s" % self.filename)
359 with open(self.filename, "w") as f:
360 f.write(self.contents['copyright'])
361 f.write(self.contents['header'])
362 f.write(self.contents['body'])
363 f.write(self.contents['footer'])
364
365# class for writing a wrapper class for structures
366# The wrapper class wraps the structs and includes utility functions for
367# setting/getting member values and displaying the struct data in various formats
368class StructWrapperGen:
369 def __init__(self, in_struct_dict, prefix, out_dir):
370 self.struct_dict = in_struct_dict
371 self.include_headers = []
372 self.api = prefix
Courtney Goeltzenleuchtercbf13812015-04-14 16:30:53 -0600373 if prefix.lower() == "vulkan":
Courtney Goeltzenleuchter9cc421e2015-04-08 15:36:08 -0600374 self.api_prefix = "vk"
375 else:
376 self.api_prefix = prefix
377 self.header_filename = os.path.join(out_dir, self.api_prefix+"_struct_wrappers.h")
378 self.class_filename = os.path.join(out_dir, self.api_prefix+"_struct_wrappers.cpp")
379 self.string_helper_filename = os.path.join(out_dir, self.api_prefix+"_struct_string_helper.h")
380 self.string_helper_no_addr_filename = os.path.join(out_dir, self.api_prefix+"_struct_string_helper_no_addr.h")
381 self.string_helper_cpp_filename = os.path.join(out_dir, self.api_prefix+"_struct_string_helper_cpp.h")
382 self.string_helper_no_addr_cpp_filename = os.path.join(out_dir, self.api_prefix+"_struct_string_helper_no_addr_cpp.h")
383 self.validate_helper_filename = os.path.join(out_dir, self.api_prefix+"_struct_validate_helper.h")
Tobin Ehlis07fe9ab2014-11-25 17:43:26 -0700384 self.no_addr = False
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600385 self.hfg = CommonFileGen(self.header_filename)
386 self.cfg = CommonFileGen(self.class_filename)
387 self.shg = CommonFileGen(self.string_helper_filename)
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700388 self.shcppg = CommonFileGen(self.string_helper_cpp_filename)
Tobin Ehlis6cd06372014-12-17 17:44:50 -0700389 self.vhg = CommonFileGen(self.validate_helper_filename)
Courtney Goeltzenleuchter9cc421e2015-04-08 15:36:08 -0600390 self.size_helper_filename = os.path.join(out_dir, self.api_prefix+"_struct_size_helper.h")
391 self.size_helper_c_filename = os.path.join(out_dir, self.api_prefix+"_struct_size_helper.c")
Tobin Ehlisff765b02015-03-12 14:50:40 -0600392 self.size_helper_gen = CommonFileGen(self.size_helper_filename)
Peter Lohrmann3a9c63a2015-04-03 11:43:06 -0700393 self.size_helper_c_gen = CommonFileGen(self.size_helper_c_filename)
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600394 #print(self.header_filename)
395 self.header_txt = ""
396 self.definition_txt = ""
397
398 def set_include_headers(self, include_headers):
399 self.include_headers = include_headers
400
Tobin Ehlis07fe9ab2014-11-25 17:43:26 -0700401 def set_no_addr(self, no_addr):
402 self.no_addr = no_addr
403 if self.no_addr:
404 self.shg = CommonFileGen(self.string_helper_no_addr_filename)
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700405 self.shcppg = CommonFileGen(self.string_helper_no_addr_cpp_filename)
Tobin Ehlis07fe9ab2014-11-25 17:43:26 -0700406 else:
407 self.shg = CommonFileGen(self.string_helper_filename)
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700408 self.shcppg = CommonFileGen(self.string_helper_cpp_filename)
Tobin Ehlis07fe9ab2014-11-25 17:43:26 -0700409
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600410 # Return class name for given struct name
411 def get_class_name(self, struct_name):
412 class_name = struct_name.strip('_').lower() + "_struct_wrapper"
413 return class_name
414
415 def get_file_list(self):
416 return [os.path.basename(self.header_filename), os.path.basename(self.class_filename), os.path.basename(self.string_helper_filename)]
417
418 # Generate class header file
419 def generateHeader(self):
420 self.hfg.setCopyright(self._generateCopyright())
421 self.hfg.setHeader(self._generateHeader())
422 self.hfg.setBody(self._generateClassDeclaration())
423 self.hfg.setFooter(self._generateFooter())
424 self.hfg.generate()
425
426 # Generate class definition
427 def generateBody(self):
428 self.cfg.setCopyright(self._generateCopyright())
429 self.cfg.setHeader(self._generateCppHeader())
430 self.cfg.setBody(self._generateClassDefinition())
431 self.cfg.setFooter(self._generateFooter())
432 self.cfg.generate()
433
434 # Generate c-style .h file that contains functions for printing structs
435 def generateStringHelper(self):
436 print("Generating struct string helper")
437 self.shg.setCopyright(self._generateCopyright())
438 self.shg.setHeader(self._generateStringHelperHeader())
439 self.shg.setBody(self._generateStringHelperFunctions())
440 self.shg.generate()
441
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700442 # Generate cpp-style .h file that contains functions for printing structs
443 def generateStringHelperCpp(self):
444 print("Generating struct string helper cpp")
445 self.shcppg.setCopyright(self._generateCopyright())
446 self.shcppg.setHeader(self._generateStringHelperHeaderCpp())
447 self.shcppg.setBody(self._generateStringHelperFunctionsCpp())
448 self.shcppg.generate()
449
Tobin Ehlis6cd06372014-12-17 17:44:50 -0700450 # Generate c-style .h file that contains functions for printing structs
451 def generateValidateHelper(self):
452 print("Generating struct validate helper")
453 self.vhg.setCopyright(self._generateCopyright())
454 self.vhg.setHeader(self._generateValidateHelperHeader())
455 self.vhg.setBody(self._generateValidateHelperFunctions())
456 self.vhg.generate()
457
Tobin Ehlisff765b02015-03-12 14:50:40 -0600458 def generateSizeHelper(self):
459 print("Generating struct size helper")
460 self.size_helper_gen.setCopyright(self._generateCopyright())
461 self.size_helper_gen.setHeader(self._generateSizeHelperHeader())
462 self.size_helper_gen.setBody(self._generateSizeHelperFunctions())
463 self.size_helper_gen.generate()
464
Peter Lohrmann3a9c63a2015-04-03 11:43:06 -0700465 def generateSizeHelperC(self):
466 print("Generating struct size helper c")
467 self.size_helper_c_gen.setCopyright(self._generateCopyright())
468 self.size_helper_c_gen.setHeader(self._generateSizeHelperHeaderC())
469 self.size_helper_c_gen.setBody(self._generateSizeHelperFunctionsC())
470 self.size_helper_c_gen.generate()
471
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600472 def _generateCopyright(self):
Peter Lohrmann3a9c63a2015-04-03 11:43:06 -0700473 copyright = []
474 copyright.append('/* THIS FILE IS GENERATED. DO NOT EDIT. */');
475 copyright.append('');
476 copyright.append('/*');
Ian Elliotte3b10452015-04-15 11:15:13 -0600477 copyright.append(' * Vulkan');
Peter Lohrmann3a9c63a2015-04-03 11:43:06 -0700478 copyright.append(' *');
479 copyright.append(' * Copyright (C) 2014 LunarG, Inc.');
480 copyright.append(' *');
481 copyright.append(' * Permission is hereby granted, free of charge, to any person obtaining a');
482 copyright.append(' * copy of this software and associated documentation files (the "Software"),');
483 copyright.append(' * to deal in the Software without restriction, including without limitation');
484 copyright.append(' * the rights to use, copy, modify, merge, publish, distribute, sublicense,');
485 copyright.append(' * and/or sell copies of the Software, and to permit persons to whom the');
486 copyright.append(' * Software is furnished to do so, subject to the following conditions:');
487 copyright.append(' *');
488 copyright.append(' * The above copyright notice and this permission notice shall be included');
489 copyright.append(' * in all copies or substantial portions of the Software.');
490 copyright.append(' *');
491 copyright.append(' * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR');
492 copyright.append(' * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,');
493 copyright.append(' * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL');
494 copyright.append(' * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER');
495 copyright.append(' * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING');
496 copyright.append(' * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER');
497 copyright.append(' * DEALINGS IN THE SOFTWARE.');
498 copyright.append(' */');
499 copyright.append('');
500 return "\n".join(copyright)
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600501
502 def _generateCppHeader(self):
503 header = []
504 header.append("//#includes, #defines, globals and such...\n")
Courtney Goeltzenleuchter9cc421e2015-04-08 15:36:08 -0600505 header.append("#include <stdio.h>\n#include <%s>\n#include <%s_enum_string_helper.h>\n" % (os.path.basename(self.header_filename), self.api_prefix))
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600506 return "".join(header)
507
508 def _generateClassDefinition(self):
509 class_def = []
Courtney Goeltzenleuchter9cc421e2015-04-08 15:36:08 -0600510 if 'vk' == self.api: # Mantle doesn't have pNext to worry about
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600511 class_def.append(self._generateDynamicPrintFunctions())
Peter Lohrmannc55cfa12015-03-30 16:29:56 -0700512 for s in sorted(self.struct_dict):
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600513 class_def.append("\n// %s class definition" % self.get_class_name(s))
514 class_def.append(self._generateConstructorDefinitions(s))
515 class_def.append(self._generateDestructorDefinitions(s))
516 class_def.append(self._generateDisplayDefinitions(s))
517 return "\n".join(class_def)
518
519 def _generateConstructorDefinitions(self, s):
520 con_defs = []
521 con_defs.append("%s::%s() : m_struct(), m_indent(0), m_dummy_prefix('\\0'), m_origStructAddr(NULL) {}" % (self.get_class_name(s), self.get_class_name(s)))
522 # TODO : This is a shallow copy of ptrs
523 con_defs.append("%s::%s(%s* pInStruct) : m_indent(0), m_dummy_prefix('\\0')\n{\n m_struct = *pInStruct;\n m_origStructAddr = pInStruct;\n}" % (self.get_class_name(s), self.get_class_name(s), typedef_fwd_dict[s]))
524 con_defs.append("%s::%s(const %s* pInStruct) : m_indent(0), m_dummy_prefix('\\0')\n{\n m_struct = *pInStruct;\n m_origStructAddr = pInStruct;\n}" % (self.get_class_name(s), self.get_class_name(s), typedef_fwd_dict[s]))
525 return "\n".join(con_defs)
526
527 def _generateDestructorDefinitions(self, s):
528 return "%s::~%s() {}" % (self.get_class_name(s), self.get_class_name(s))
529
530 def _generateDynamicPrintFunctions(self):
531 dp_funcs = []
Mark Lobodzinskie2d07a52015-01-29 08:55:56 -0600532 dp_funcs.append("\nvoid dynamic_display_full_txt(const void* pStruct, uint32_t indent)\n{\n // Cast to APP_INFO ptr initially just to pull sType off struct")
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -0600533 dp_funcs.append(" VkStructureType sType = ((VkApplicationInfo*)pStruct)->sType;\n")
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600534 dp_funcs.append(" switch (sType)\n {")
535 for e in enum_type_dict:
536 class_num = 0
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -0600537 if "StructureType" in e:
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600538 for v in sorted(enum_type_dict[e]):
Courtney Goeltzenleuchterddcb6192015-04-14 18:48:46 -0600539 struct_name = get_struct_name_from_struct_type(v)
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600540 class_name = self.get_class_name(struct_name)
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600541 instance_name = "swc%i" % class_num
542 dp_funcs.append(" case %s:\n {" % (v))
543 dp_funcs.append(" %s %s((%s*)pStruct);" % (class_name, instance_name, struct_name))
544 dp_funcs.append(" %s.set_indent(indent);" % (instance_name))
545 dp_funcs.append(" %s.display_full_txt();" % (instance_name))
546 dp_funcs.append(" }")
547 dp_funcs.append(" break;")
548 class_num += 1
549 dp_funcs.append(" }")
550 dp_funcs.append("}\n")
551 return "\n".join(dp_funcs)
552
Tobin Ehlis6cd06372014-12-17 17:44:50 -0700553 def _get_func_name(self, struct, mid_str):
Courtney Goeltzenleuchter9cc421e2015-04-08 15:36:08 -0600554 return "%s_%s_%s" % (self.api_prefix, mid_str, struct.lower().strip("_"))
Tobin Ehlis6cd06372014-12-17 17:44:50 -0700555
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600556 def _get_sh_func_name(self, struct):
Tobin Ehlis6cd06372014-12-17 17:44:50 -0700557 return self._get_func_name(struct, 'print')
558
559 def _get_vh_func_name(self, struct):
560 return self._get_func_name(struct, 'validate')
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600561
Tobin Ehlisff765b02015-03-12 14:50:40 -0600562 def _get_size_helper_func_name(self, struct):
563 return self._get_func_name(struct, 'size')
564
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600565 # Return elements to create formatted string for given struct member
566 def _get_struct_print_formatted(self, struct_member, pre_var_name="prefix", postfix = "\\n", struct_var_name="pStruct", struct_ptr=True, print_array=False):
567 struct_op = "->"
568 if not struct_ptr:
569 struct_op = "."
570 member_name = struct_member['name']
571 print_type = "p"
572 cast_type = ""
573 member_post = ""
574 array_index = ""
575 member_print_post = ""
Tobin Ehlisbf0146e2015-02-11 14:24:02 -0700576 print_delimiter = "%"
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700577 if struct_member['array'] and 'char' in struct_member['type'].lower(): # just print char array as string
578 if member_name.startswith('pp'): # TODO : Only printing first element of dynam array of char* for now
579 member_post = "[0]"
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600580 print_type = "s"
581 print_array = False
582 elif struct_member['array'] and not print_array:
583 # Just print base address of array when not full print_array
584 cast_type = "(void*)"
585 elif is_type(struct_member['type'], 'enum'):
586 cast_type = "string_%s" % struct_member['type']
Jon Ashburna0ddc902015-01-09 09:11:44 -0700587 if struct_member['ptr']:
588 struct_var_name = "*" + struct_var_name
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600589 print_type = "s"
590 elif is_type(struct_member['type'], 'struct'): # print struct address for now
591 cast_type = "(void*)"
592 if not struct_member['ptr']:
593 cast_type = "(void*)&"
Tobin Ehlis2f3726c2015-01-15 17:51:52 -0700594 elif 'bool' in struct_member['type']:
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600595 print_type = "s"
596 member_post = ' ? "TRUE" : "FALSE"'
Tobin Ehlis2f3726c2015-01-15 17:51:52 -0700597 elif 'float' in struct_member['type']:
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600598 print_type = "f"
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -0600599 elif 'uint64' in struct_member['type'] or 'gpusize' in struct_member['type'].lower():
600 print_type = '" PRId64 "'
Tobin Ehlis2f3726c2015-01-15 17:51:52 -0700601 elif 'uint8' in struct_member['type']:
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600602 print_type = "hu"
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -0600603 elif 'size' in struct_member['type'].lower():
Tobin Ehlisbf0146e2015-02-11 14:24:02 -0700604 print_type = '" PRINTF_SIZE_T_SPECIFIER "'
605 print_delimiter = ""
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -0600606 elif True in [ui_str.lower() in struct_member['type'].lower() for ui_str in ['uint', 'flags', 'samplemask']]:
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600607 print_type = "u"
Tobin Ehlis2f3726c2015-01-15 17:51:52 -0700608 elif 'int' in struct_member['type']:
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600609 print_type = "i"
610 elif struct_member['ptr']:
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600611 pass
612 else:
613 #print("Unhandled struct type: %s" % struct_member['type'])
614 cast_type = "(void*)"
615 if print_array and struct_member['array']:
616 member_print_post = "[%u]"
617 array_index = " i,"
618 member_post = "[i]"
Tobin Ehlisbf0146e2015-02-11 14:24:02 -0700619 print_out = "%%s%s%s = %s%s%s" % (member_name, member_print_post, print_delimiter, print_type, postfix) # section of print that goes inside of quotes
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600620 print_arg = ", %s,%s %s(%s%s%s)%s" % (pre_var_name, array_index, cast_type, struct_var_name, struct_op, member_name, member_post) # section of print passed to portion in quotes
Tobin Ehlis07fe9ab2014-11-25 17:43:26 -0700621 if self.no_addr and "p" == print_type:
622 print_out = "%%s%s%s = addr\\n" % (member_name, member_print_post) # section of print that goes inside of quotes
623 print_arg = ", %s" % (pre_var_name)
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600624 return (print_out, print_arg)
625
626 def _generateStringHelperFunctions(self):
627 sh_funcs = []
Tobin Ehlis6f7029b2014-11-11 12:28:12 -0700628 # We do two passes, first pass just generates prototypes for all the functsions
Tobin Ehlisd204b1a2015-01-20 09:48:48 -0700629 for s in sorted(self.struct_dict):
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700630 sh_funcs.append('char* %s(const %s* pStruct, const char* prefix);' % (self._get_sh_func_name(s), typedef_fwd_dict[s]))
631 sh_funcs.append('')
632 sh_funcs.append('#if defined(_WIN32)')
633 sh_funcs.append('// Microsoft did not implement C99 in Visual Studio; but started adding it with')
634 sh_funcs.append('// VS2013. However, VS2013 still did not have snprintf(). The following is a')
635 sh_funcs.append('// work-around.')
636 sh_funcs.append('#define snprintf _snprintf')
637 sh_funcs.append('#endif // _WIN32\n')
Peter Lohrmannc55cfa12015-03-30 16:29:56 -0700638 for s in sorted(self.struct_dict):
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600639 p_out = ""
640 p_args = ""
Tobin Ehlis6f7029b2014-11-11 12:28:12 -0700641 stp_list = [] # stp == "struct to print" a list of structs for this API call that should be printed as structs
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700642 # This pre-pass flags embedded structs and pNext
Tobin Ehlisd204b1a2015-01-20 09:48:48 -0700643 for m in sorted(self.struct_dict[s]):
Tobin Ehlis6f7029b2014-11-11 12:28:12 -0700644 if 'pNext' == self.struct_dict[s][m]['name'] or is_type(self.struct_dict[s][m]['type'], 'struct'):
645 stp_list.append(self.struct_dict[s][m])
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700646 sh_funcs.append('char* %s(const %s* pStruct, const char* prefix)\n{\n char* str;' % (self._get_sh_func_name(s), typedef_fwd_dict[s]))
647 sh_funcs.append(" size_t len;")
Tobin Ehlis6f7029b2014-11-11 12:28:12 -0700648 num_stps = len(stp_list);
649 total_strlen_str = ''
650 if 0 != num_stps:
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700651 sh_funcs.append(" char* tmpStr;")
652 sh_funcs.append(' char* extra_indent = (char*)malloc(strlen(prefix) + 3);')
653 sh_funcs.append(' strcpy(extra_indent, " ");')
654 sh_funcs.append(' strncat(extra_indent, prefix, strlen(prefix));')
655 sh_funcs.append(' char* stp_strs[%i];' % num_stps)
Tobin Ehlis6f7029b2014-11-11 12:28:12 -0700656 for index in range(num_stps):
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700657 # If it's an array, print all of the elements
658 # If it's a ptr, print thing it's pointing to
659 # Non-ptr struct case. Print the struct using its address
660 struct_deref = '&'
661 if 1 < stp_list[index]['full_type'].count('*'):
662 struct_deref = ''
Tobin Ehlis6f7029b2014-11-11 12:28:12 -0700663 if (stp_list[index]['ptr']):
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700664 sh_funcs.append(' if (pStruct->%s) {' % stp_list[index]['name'])
Tobin Ehlis6f7029b2014-11-11 12:28:12 -0700665 if 'pNext' == stp_list[index]['name']:
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700666 sh_funcs.append(' tmpStr = dynamic_display((void*)pStruct->pNext, prefix);')
667 sh_funcs.append(' len = 256+strlen(tmpStr);')
668 sh_funcs.append(' stp_strs[%i] = (char*)malloc(len);' % index)
Tobin Ehlis07fe9ab2014-11-25 17:43:26 -0700669 if self.no_addr:
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700670 sh_funcs.append(' snprintf(stp_strs[%i], len, " %%spNext (addr)\\n%%s", prefix, tmpStr);' % index)
Tobin Ehlis07fe9ab2014-11-25 17:43:26 -0700671 else:
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700672 sh_funcs.append(' snprintf(stp_strs[%i], len, " %%spNext (%%p)\\n%%s", prefix, (void*)pStruct->pNext, tmpStr);' % index)
673 sh_funcs.append(' free(tmpStr);')
Tobin Ehlis6f7029b2014-11-11 12:28:12 -0700674 else:
Tobin Ehlisd1c0e662015-02-26 12:57:08 -0700675 if stp_list[index]['name'] in ['pImageViews', 'pBufferViews']:
676 # TODO : This is a quick hack to handle these arrays of ptrs
Courtney Goeltzenleuchter24591b62015-04-02 22:54:15 -0600677 sh_funcs.append(' tmpStr = %s(&pStruct->%s[0], extra_indent);' % (self._get_sh_func_name(stp_list[index]['type']), stp_list[index]['name']))
Tobin Ehlisd1c0e662015-02-26 12:57:08 -0700678 else:
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700679 sh_funcs.append(' tmpStr = %s(pStruct->%s, extra_indent);' % (self._get_sh_func_name(stp_list[index]['type']), stp_list[index]['name']))
680 sh_funcs.append(' len = 256+strlen(tmpStr)+strlen(prefix);')
681 sh_funcs.append(' stp_strs[%i] = (char*)malloc(len);' % (index))
Tobin Ehlis07fe9ab2014-11-25 17:43:26 -0700682 if self.no_addr:
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700683 sh_funcs.append(' snprintf(stp_strs[%i], len, " %%s%s (addr)\\n%%s", prefix, tmpStr);' % (index, stp_list[index]['name']))
Tobin Ehlis07fe9ab2014-11-25 17:43:26 -0700684 else:
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700685 sh_funcs.append(' snprintf(stp_strs[%i], len, " %%s%s (%%p)\\n%%s", prefix, (void*)pStruct->%s, tmpStr);' % (index, stp_list[index]['name'], stp_list[index]['name']))
686 sh_funcs.append(' }')
687 sh_funcs.append(" else\n stp_strs[%i] = \"\";" % (index))
688 elif stp_list[index]['array']:
689 sh_funcs.append(' tmpStr = %s(&pStruct->%s[0], extra_indent);' % (self._get_sh_func_name(stp_list[index]['type']), stp_list[index]['name']))
690 sh_funcs.append(' len = 256+strlen(tmpStr);')
691 sh_funcs.append(' stp_strs[%i] = (char*)malloc(len);' % (index))
Tobin Ehlis07fe9ab2014-11-25 17:43:26 -0700692 if self.no_addr:
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700693 sh_funcs.append(' snprintf(stp_strs[%i], len, " %%s%s[0] (addr)\\n%%s", prefix, tmpStr);' % (index, stp_list[index]['name']))
Tobin Ehlis07fe9ab2014-11-25 17:43:26 -0700694 else:
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700695 sh_funcs.append(' snprintf(stp_strs[%i], len, " %%s%s[0] (%%p)\\n%%s", prefix, (void*)&pStruct->%s[0], tmpStr);' % (index, stp_list[index]['name'], stp_list[index]['name']))
Tobin Ehlis6f7029b2014-11-11 12:28:12 -0700696 else:
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700697 sh_funcs.append(' tmpStr = %s(&pStruct->%s, extra_indent);' % (self._get_sh_func_name(stp_list[index]['type']), stp_list[index]['name']))
698 sh_funcs.append(' len = 256+strlen(tmpStr);')
699 sh_funcs.append(' stp_strs[%i] = (char*)malloc(len);' % (index))
Tobin Ehlis07fe9ab2014-11-25 17:43:26 -0700700 if self.no_addr:
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700701 sh_funcs.append(' snprintf(stp_strs[%i], len, " %%s%s (addr)\\n%%s", prefix, tmpStr);' % (index, stp_list[index]['name']))
Tobin Ehlis07fe9ab2014-11-25 17:43:26 -0700702 else:
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700703 sh_funcs.append(' snprintf(stp_strs[%i], len, " %%s%s (%%p)\\n%%s", prefix, (void*)&pStruct->%s, tmpStr);' % (index, stp_list[index]['name'], stp_list[index]['name']))
Tobin Ehlis6f7029b2014-11-11 12:28:12 -0700704 total_strlen_str += 'strlen(stp_strs[%i]) + ' % index
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700705 sh_funcs.append(' len = %ssizeof(char)*1024;' % (total_strlen_str))
706 sh_funcs.append(' str = (char*)malloc(len);')
Courtney Goeltzenleuchtercde421c2014-12-01 09:31:17 -0700707 sh_funcs.append(' snprintf(str, len, "')
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600708 for m in sorted(self.struct_dict[s]):
709 (p_out1, p_args1) = self._get_struct_print_formatted(self.struct_dict[s][m])
710 p_out += p_out1
711 p_args += p_args1
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600712 p_out += '"'
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700713 p_args += ");"
714 sh_funcs[-1] = '%s%s%s' % (sh_funcs[-1], p_out, p_args)
Tobin Ehlis6f7029b2014-11-11 12:28:12 -0700715 if 0 != num_stps:
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700716 sh_funcs.append(' for (int32_t stp_index = %i; stp_index >= 0; stp_index--) {' % (num_stps-1))
717 sh_funcs.append(' if (0 < strlen(stp_strs[stp_index])) {')
718 sh_funcs.append(' strncat(str, stp_strs[stp_index], strlen(stp_strs[stp_index]));')
719 sh_funcs.append(' free(stp_strs[stp_index]);')
720 sh_funcs.append(' }')
721 sh_funcs.append(' }')
722 sh_funcs.append(' free(extra_indent);')
723 sh_funcs.append(" return str;\n}")
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600724 # Add function to dynamically print out unknown struct
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700725 sh_funcs.append("char* dynamic_display(const void* pStruct, const char* prefix)\n{")
726 sh_funcs.append(" // Cast to APP_INFO ptr initially just to pull sType off struct")
727 sh_funcs.append(" if (pStruct == NULL) {")
728 sh_funcs.append(" return NULL;")
729 sh_funcs.append(" }")
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -0600730 sh_funcs.append(" VkStructureType sType = ((VkApplicationInfo*)pStruct)->sType;")
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700731 sh_funcs.append(' char indent[100];\n strcpy(indent, " ");\n strcat(indent, prefix);')
732 sh_funcs.append(" switch (sType)\n {")
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600733 for e in enum_type_dict:
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -0600734 if "StructureType" in e:
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600735 for v in sorted(enum_type_dict[e]):
Courtney Goeltzenleuchterddcb6192015-04-14 18:48:46 -0600736 struct_name = get_struct_name_from_struct_type(v)
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600737 print_func_name = self._get_sh_func_name(struct_name)
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700738 sh_funcs.append(' case %s:\n {' % (v))
739 sh_funcs.append(' return %s((%s*)pStruct, indent);' % (print_func_name, struct_name))
740 sh_funcs.append(' }')
741 sh_funcs.append(' break;')
742 sh_funcs.append(" default:")
743 sh_funcs.append(" return NULL;")
744 sh_funcs.append(" }")
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600745 sh_funcs.append("}")
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700746 return "\n".join(sh_funcs)
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700747
748 def _generateStringHelperFunctionsCpp(self):
749 # declare str & tmp str
750 # declare array of stringstreams for every struct ptr in current struct
751 # declare array of stringstreams for every non-string element in current struct
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700752 # For every struct ptr, if non-Null, then set its string, else set to NULL str
753 # For every non-string element, set its string stream
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700754 # create and return final string
755 sh_funcs = []
756 # First generate prototypes for every struct
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -0600757 # XXX - REMOVE this comment
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600758 lineinfo = sourcelineinfo()
759 sh_funcs.append('%s' % lineinfo.get())
Tobin Ehlisd204b1a2015-01-20 09:48:48 -0700760 for s in sorted(self.struct_dict):
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700761 sh_funcs.append('string %s(const %s* pStruct, const string prefix);' % (self._get_sh_func_name(s), typedef_fwd_dict[s]))
762 sh_funcs.append('\n')
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600763 sh_funcs.append('%s' % lineinfo.get())
Tobin Ehlisd204b1a2015-01-20 09:48:48 -0700764 for s in sorted(self.struct_dict):
Tobin Ehlis3d742282015-06-11 09:37:00 -0600765 num_non_enum_elems = [(is_type(self.struct_dict[s][elem]['type'], 'enum') and not self.struct_dict[s][elem]['ptr']) for elem in self.struct_dict[s]].count(False)
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700766 stp_list = [] # stp == "struct to print" a list of structs for this API call that should be printed as structs
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700767 # This pre-pass flags embedded structs and pNext
Tobin Ehlisd204b1a2015-01-20 09:48:48 -0700768 for m in sorted(self.struct_dict[s]):
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700769 if 'pNext' == self.struct_dict[s][m]['name'] or is_type(self.struct_dict[s][m]['type'], 'struct') or self.struct_dict[s][m]['array']:
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700770 stp_list.append(self.struct_dict[s][m])
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600771 sh_funcs.append('%s' % lineinfo.get())
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700772 sh_funcs.append('string %s(const %s* pStruct, const string prefix)\n{' % (self._get_sh_func_name(s), typedef_fwd_dict[s]))
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600773 sh_funcs.append('%s' % lineinfo.get())
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700774 indent = ' '
Tobin Ehlis4a636a12015-04-09 09:19:36 -0600775 sh_funcs.append('%susing namespace StreamControl;' % (indent))
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700776 sh_funcs.append('%sstring final_str;' % (indent))
777 sh_funcs.append('%sstring tmp_str;' % (indent))
778 sh_funcs.append('%sstring extra_indent = " " + prefix;' % (indent))
Tobin Ehlisd204b1a2015-01-20 09:48:48 -0700779 if (0 != num_non_enum_elems):
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700780 sh_funcs.append('%sstringstream ss[%u];' % (indent, num_non_enum_elems))
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700781 num_stps = len(stp_list)
Tobin Ehlis3d742282015-06-11 09:37:00 -0600782 # First generate code for any embedded structs or arrays
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700783 if 0 < num_stps:
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700784 sh_funcs.append('%sstring stp_strs[%u];' % (indent, num_stps))
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700785 idx_ss_decl = False # Make sure to only decl this once
786 for index in range(num_stps):
787 addr_char = '&'
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700788 if 1 < stp_list[index]['full_type'].count('*'):
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700789 addr_char = ''
Courtney Goeltzenleuchter1c7c65d2015-06-10 17:39:03 -0600790 if (stp_list[index]['array'] and 'char' not in stp_list[index]['type']):
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600791 sh_funcs.append('%s' % lineinfo.get())
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700792 if stp_list[index]['dyn_array']:
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600793 sh_funcs.append('%s' % lineinfo.get())
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700794 array_count = 'pStruct->%s' % (stp_list[index]['array_size'])
795 else:
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600796 sh_funcs.append('%s' % lineinfo.get())
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700797 array_count = '%s' % (stp_list[index]['array_size'])
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600798 sh_funcs.append('%s' % lineinfo.get())
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700799 sh_funcs.append('%sstp_strs[%u] = "";' % (indent, index))
800 if not idx_ss_decl:
801 sh_funcs.append('%sstringstream index_ss;' % (indent))
802 idx_ss_decl = True
Tobin Ehlisdd82f6b2015-04-03 12:01:11 -0600803 sh_funcs.append('%sif (pStruct->%s) {' % (indent, stp_list[index]['name']))
804 indent += ' '
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700805 sh_funcs.append('%sfor (uint32_t i = 0; i < %s; i++) {' % (indent, array_count))
Tobin Ehlisdd82f6b2015-04-03 12:01:11 -0600806 indent += ' '
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700807 sh_funcs.append('%sindex_ss.str("");' % (indent))
808 sh_funcs.append('%sindex_ss << i;' % (indent))
Tobin Ehlis3d742282015-06-11 09:37:00 -0600809 if is_type(stp_list[index]['type'], 'enum'):
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600810 sh_funcs.append('%s' % lineinfo.get())
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700811 addr_char = ''
Tobin Ehlis3d742282015-06-11 09:37:00 -0600812 #value_print = 'string_%s(%spStruct->%s)' % (self.struct_dict[s][m]['type'], deref, self.struct_dict[s][m]['name'])
813 sh_funcs.append('%sss[%u] << string_%s(pStruct->%s[i]);' % (indent, index, stp_list[index]['type'], stp_list[index]['name']))
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700814 sh_funcs.append('%sstp_strs[%u] += " " + prefix + "%s[" + index_ss.str() + "] = " + ss[%u].str() + "\\n";' % (indent, index, stp_list[index]['name'], index))
Tobin Ehlis3d742282015-06-11 09:37:00 -0600815 elif is_type(stp_list[index]['type'], 'struct'):
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600816 sh_funcs.append('%s' % lineinfo.get())
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700817 sh_funcs.append('%sss[%u] << %spStruct->%s[i];' % (indent, index, addr_char, stp_list[index]['name']))
818 sh_funcs.append('%stmp_str = %s(%spStruct->%s[i], extra_indent);' % (indent, self._get_sh_func_name(stp_list[index]['type']), addr_char, stp_list[index]['name']))
819 if self.no_addr:
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600820 sh_funcs.append('%s' % lineinfo.get())
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700821 sh_funcs.append('%sstp_strs[%u] += " " + prefix + "%s[" + index_ss.str() + "] (addr)\\n" + tmp_str;' % (indent, index, stp_list[index]['name']))
822 else:
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600823 sh_funcs.append('%s' % lineinfo.get())
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700824 sh_funcs.append('%sstp_strs[%u] += " " + prefix + "%s[" + index_ss.str() + "] (" + ss[%u].str() + ")\\n" + tmp_str;' % (indent, index, stp_list[index]['name'], index))
Tobin Ehlis3d742282015-06-11 09:37:00 -0600825 else:
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600826 sh_funcs.append('%s' % lineinfo.get())
Tobin Ehlis3d742282015-06-11 09:37:00 -0600827 addr_char = ''
828 sh_funcs.append('%sss[%u] << %spStruct->%s[i];' % (indent, index, addr_char, stp_list[index]['name']))
829 sh_funcs.append('%sstp_strs[%u] += " " + prefix + "%s[" + index_ss.str() + "] = " + ss[%u].str() + "\\n";' % (indent, index, stp_list[index]['name'], index))
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600830 sh_funcs.append('%s' % lineinfo.get())
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700831 sh_funcs.append('%sss[%u].str("");' % (indent, index))
Tobin Ehlisdd82f6b2015-04-03 12:01:11 -0600832 indent = indent[4:]
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700833 sh_funcs.append('%s}' % (indent))
Tobin Ehlisa74d53a2015-04-17 13:26:33 -0600834 indent = indent[4:]
835 sh_funcs.append('%s}' % (indent))
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700836 elif (stp_list[index]['ptr']):
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600837 sh_funcs.append('%s' % lineinfo.get())
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700838 sh_funcs.append(' if (pStruct->%s) {' % stp_list[index]['name'])
839 if 'pNext' == stp_list[index]['name']:
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600840 sh_funcs.append('%s' % lineinfo.get())
Mark Lobodzinskie2d07a52015-01-29 08:55:56 -0600841 sh_funcs.append(' tmp_str = dynamic_display((void*)pStruct->pNext, prefix);')
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700842 else:
Tobin Ehlisd1c0e662015-02-26 12:57:08 -0700843 if stp_list[index]['name'] in ['pImageViews', 'pBufferViews']:
844 # TODO : This is a quick hack to handle these arrays of ptrs
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600845 sh_funcs.append('%s' % lineinfo.get())
Courtney Goeltzenleuchter24591b62015-04-02 22:54:15 -0600846 sh_funcs.append(' tmp_str = %s(&pStruct->%s[0], extra_indent);' % (self._get_sh_func_name(stp_list[index]['type']), stp_list[index]['name']))
Tobin Ehlisd1c0e662015-02-26 12:57:08 -0700847 else:
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600848 sh_funcs.append('%s' % lineinfo.get())
Tobin Ehlisd1c0e662015-02-26 12:57:08 -0700849 sh_funcs.append(' tmp_str = %s(pStruct->%s, extra_indent);' % (self._get_sh_func_name(stp_list[index]['type']), stp_list[index]['name']))
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700850 sh_funcs.append(' ss[%u] << %spStruct->%s;' % (index, addr_char, stp_list[index]['name']))
851 if self.no_addr:
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600852 sh_funcs.append('%s' % lineinfo.get())
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700853 sh_funcs.append(' stp_strs[%u] = " " + prefix + "%s (addr)\\n" + tmp_str;' % (index, stp_list[index]['name']))
854 else:
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600855 sh_funcs.append('%s' % lineinfo.get())
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700856 sh_funcs.append(' stp_strs[%u] = " " + prefix + "%s (" + ss[%u].str() + ")\\n" + tmp_str;' % (index, stp_list[index]['name'], index))
857 sh_funcs.append(' ss[%u].str("");' % (index))
858 sh_funcs.append(' }')
859 sh_funcs.append(' else')
860 sh_funcs.append(' stp_strs[%u] = "";' % index)
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700861 else:
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600862 sh_funcs.append('%s' % lineinfo.get())
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700863 sh_funcs.append(' tmp_str = %s(&pStruct->%s, extra_indent);' % (self._get_sh_func_name(stp_list[index]['type']), stp_list[index]['name']))
864 sh_funcs.append(' ss[%u] << %spStruct->%s;' % (index, addr_char, stp_list[index]['name']))
865 if self.no_addr:
866 sh_funcs.append(' stp_strs[%u] = " " + prefix + "%s (addr)\\n" + tmp_str;' % (index, stp_list[index]['name']))
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600867 sh_funcs.append('%s' % lineinfo.get())
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700868 else:
869 sh_funcs.append(' stp_strs[%u] = " " + prefix + "%s (" + ss[%u].str() + ")\\n" + tmp_str;' % (index, stp_list[index]['name'], index))
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600870 sh_funcs.append('%s' % lineinfo.get())
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700871 sh_funcs.append(' ss[%u].str("");' % index)
Tobin Ehlis3d742282015-06-11 09:37:00 -0600872 # Now print one-line info for all data members
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700873 index = 0
874 final_str = ''
875 for m in sorted(self.struct_dict[s]):
876 if not is_type(self.struct_dict[s][m]['type'], 'enum'):
877 if is_type(self.struct_dict[s][m]['type'], 'struct') and not self.struct_dict[s][m]['ptr']:
878 if self.no_addr:
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600879 sh_funcs.append('%s' % lineinfo.get())
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700880 sh_funcs.append(' ss[%u].str("addr");' % (index))
881 else:
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600882 sh_funcs.append('%s' % lineinfo.get())
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700883 sh_funcs.append(' ss[%u] << &pStruct->%s;' % (index, self.struct_dict[s][m]['name']))
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700884 elif 'bool' in self.struct_dict[s][m]['type'].lower():
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600885 sh_funcs.append('%s' % lineinfo.get())
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700886 sh_funcs.append(' ss[%u].str(pStruct->%s ? "TRUE" : "FALSE");' % (index, self.struct_dict[s][m]['name']))
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700887 elif 'uint8' in self.struct_dict[s][m]['type'].lower():
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600888 sh_funcs.append('%s' % lineinfo.get())
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700889 sh_funcs.append(' ss[%u] << (uint32_t)pStruct->%s;' % (index, self.struct_dict[s][m]['name']))
Tobin Ehlisf46627e2015-04-28 17:27:16 -0600890 elif 'void' in self.struct_dict[s][m]['type'].lower() and self.struct_dict[s][m]['ptr']:
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600891 sh_funcs.append('%s' % lineinfo.get())
Tobin Ehlisf46627e2015-04-28 17:27:16 -0600892 sh_funcs.append(' if (StreamControl::writeAddress)')
893 sh_funcs.append(' ss[%u] << pStruct->%s;' % (index, self.struct_dict[s][m]['name']))
894 sh_funcs.append(' else')
895 sh_funcs.append(' ss[%u].str("address");' % (index))
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700896 else:
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600897 sh_funcs.append('%s' % lineinfo.get())
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700898 (po, pa) = self._get_struct_print_formatted(self.struct_dict[s][m])
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700899 if "addr" in po: # or self.struct_dict[s][m]['ptr']:
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700900 sh_funcs.append(' ss[%u].str("addr");' % (index))
901 else:
902 sh_funcs.append(' ss[%u] << pStruct->%s;' % (index, self.struct_dict[s][m]['name']))
903 value_print = 'ss[%u].str()' % index
904 index += 1
905 else:
Tobin Ehlis3d742282015-06-11 09:37:00 -0600906 # For an non-empty array of enums just print address w/ note that array will be displayed below
Tobin Ehlis2f3726c2015-01-15 17:51:52 -0700907 if self.struct_dict[s][m]['ptr']:
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600908 sh_funcs.append('%s' % lineinfo.get())
Tobin Ehlis3d742282015-06-11 09:37:00 -0600909 sh_funcs.append(' if (pStruct->%s)' % (self.struct_dict[s][m]['name']))
910 sh_funcs.append(' ss[%u] << pStruct->%s << " (See individual array values below)";' % (index, self.struct_dict[s][m]['name']))
911 sh_funcs.append(' else')
912 sh_funcs.append(' ss[%u].str("NULL");' % (index))
913 value_print = 'ss[%u].str()' % index
914 index += 1
915 # For single enum just print the string representation
916 else:
917 value_print = 'string_%s(pStruct->%s)' % (self.struct_dict[s][m]['type'], self.struct_dict[s][m]['name'])
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700918 final_str += ' + prefix + "%s = " + %s + "\\n"' % (self.struct_dict[s][m]['name'], value_print)
919 final_str = final_str[3:] # strip off the initial ' + '
Tobin Ehlis91cc24a2015-03-06 10:38:25 -0700920 if 0 != num_stps: # Append data for any embedded structs
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700921 final_str += " + %s" % " + ".join(['stp_strs[%u]' % n for n in reversed(range(num_stps))])
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600922 sh_funcs.append('%s' % lineinfo.get())
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700923 sh_funcs.append(' final_str = %s;' % final_str)
924 sh_funcs.append(' return final_str;\n}')
Tobin Ehlisd204b1a2015-01-20 09:48:48 -0700925 # Add function to return a string value for input void*
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600926 sh_funcs.append('%s' % lineinfo.get())
Tobin Ehlisd204b1a2015-01-20 09:48:48 -0700927 sh_funcs.append("string string_convert_helper(const void* toString, const string prefix)\n{")
Tobin Ehlis4a636a12015-04-09 09:19:36 -0600928 sh_funcs.append(" using namespace StreamControl;")
Tobin Ehlisd204b1a2015-01-20 09:48:48 -0700929 sh_funcs.append(" stringstream ss;")
930 sh_funcs.append(' ss << toString;')
931 sh_funcs.append(' string final_str = prefix + ss.str();')
932 sh_funcs.append(" return final_str;")
933 sh_funcs.append("}")
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600934 sh_funcs.append('%s' % lineinfo.get())
Tobin Ehlisc99cb0d2015-04-16 15:56:11 -0600935 # Add function to return a string value for input uint32_t
936 sh_funcs.append("string string_convert_helper(const uint32_t toString, const string prefix)\n{")
937 sh_funcs.append(" using namespace StreamControl;")
938 sh_funcs.append(" stringstream ss;")
939 sh_funcs.append(' ss << toString;')
940 sh_funcs.append(' string final_str = prefix + ss.str();')
941 sh_funcs.append(" return final_str;")
942 sh_funcs.append("}")
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600943 sh_funcs.append('%s' % lineinfo.get())
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700944 # Add function to dynamically print out unknown struct
Mark Lobodzinskie2d07a52015-01-29 08:55:56 -0600945 sh_funcs.append("string dynamic_display(const void* pStruct, const string prefix)\n{")
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700946 sh_funcs.append(" // Cast to APP_INFO ptr initially just to pull sType off struct")
Ian Elliotta5a0a172015-02-25 17:40:38 -0700947 sh_funcs.append(" if (pStruct == NULL) {\n")
Jon Ashburn49398b32015-02-25 12:45:23 -0700948 sh_funcs.append(" return NULL;")
Ian Elliotta5a0a172015-02-25 17:40:38 -0700949 sh_funcs.append(" }\n")
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -0600950 sh_funcs.append(" VkStructureType sType = ((VkApplicationInfo*)pStruct)->sType;")
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700951 sh_funcs.append(' string indent = " ";')
952 sh_funcs.append(' indent += prefix;')
953 sh_funcs.append(" switch (sType)\n {")
954 for e in enum_type_dict:
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -0600955 if "StructureType" in e:
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700956 for v in sorted(enum_type_dict[e]):
Courtney Goeltzenleuchterddcb6192015-04-14 18:48:46 -0600957 struct_name = get_struct_name_from_struct_type(v)
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700958 print_func_name = self._get_sh_func_name(struct_name)
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -0600959 #sh_funcs.append('string %s(const %s* pStruct, const string prefix);' % (self._get_sh_func_name(s), typedef_fwd_dict[s]))
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700960 sh_funcs.append(' case %s:\n {' % (v))
961 sh_funcs.append(' return %s((%s*)pStruct, indent);' % (print_func_name, struct_name))
962 sh_funcs.append(' }')
963 sh_funcs.append(' break;')
964 sh_funcs.append(" default:")
965 sh_funcs.append(" return NULL;")
Tobin Ehlisfde2fc32015-06-12 12:49:01 -0600966 sh_funcs.append('%s' % lineinfo.get())
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -0600967 sh_funcs.append(" }")
Tobin Ehlis434db7c2015-01-10 12:42:41 -0700968 sh_funcs.append("}")
969 return "\n".join(sh_funcs)
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600970
971 def _genStructMemberPrint(self, member, s, array, struct_array):
972 (p_out, p_arg) = self._get_struct_print_formatted(self.struct_dict[s][member], pre_var_name="&m_dummy_prefix", struct_var_name="m_struct", struct_ptr=False, print_array=True)
973 extra_indent = ""
974 if array:
975 extra_indent = " "
976 if is_type(self.struct_dict[s][member]['type'], 'struct'): # print struct address for now
977 struct_array.insert(0, self.struct_dict[s][member])
978 elif self.struct_dict[s][member]['ptr']:
Tobin Ehlis2f3726c2015-01-15 17:51:52 -0700979 # Special case for void* named "pNext"
980 if "void" in self.struct_dict[s][member]['type'] and "pNext" == self.struct_dict[s][member]['name']:
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600981 struct_array.insert(0, self.struct_dict[s][member])
982 return (' %sprintf("%%*s %s", m_indent, ""%s);' % (extra_indent, p_out, p_arg), struct_array)
983
984 def _generateDisplayDefinitions(self, s):
985 disp_def = []
986 struct_array = []
987 # Single-line struct print function
988 disp_def.append("// Output 'structname = struct_address' on a single line")
989 disp_def.append("void %s::display_single_txt()\n{" % self.get_class_name(s))
990 disp_def.append(' printf(" %%*s%s = %%p", m_indent, "", (void*)m_origStructAddr);' % typedef_fwd_dict[s])
991 disp_def.append("}\n")
992 # Private helper function to print struct members
993 disp_def.append("// Private helper function that displays the members of the wrapped struct")
994 disp_def.append("void %s::display_struct_members()\n{" % self.get_class_name(s))
995 i_declared = False
996 for member in sorted(self.struct_dict[s]):
997 # TODO : Need to display each member based on its type
Mark Lobodzinskie2d07a52015-01-29 08:55:56 -0600998 # TODO : Need to handle pNext which are structs, but of void* type
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600999 # Can grab struct type off of header of struct pointed to
1000 # TODO : Handle Arrays
1001 if self.struct_dict[s][member]['array']:
1002 # Create for loop to print each element of array
1003 if not i_declared:
1004 disp_def.append(' uint32_t i;')
1005 i_declared = True
1006 disp_def.append(' for (i = 0; i<%s; i++) {' % self.struct_dict[s][member]['array_size'])
1007 (return_str, struct_array) = self._genStructMemberPrint(member, s, True, struct_array)
1008 disp_def.append(return_str)
1009 disp_def.append(' }')
1010 else:
1011 (return_str, struct_array) = self._genStructMemberPrint(member, s, False, struct_array)
1012 disp_def.append(return_str)
1013 disp_def.append("}\n")
1014 i_declared = False
1015 # Basic print function to display struct members
1016 disp_def.append("// Output all struct elements, each on their own line")
1017 disp_def.append("void %s::display_txt()\n{" % self.get_class_name(s))
1018 disp_def.append(' printf("%%*s%s struct contents at %%p:\\n", m_indent, "", (void*)m_origStructAddr);' % typedef_fwd_dict[s])
1019 disp_def.append(' this->display_struct_members();')
1020 disp_def.append("}\n")
1021 # Advanced print function to display current struct and contents of any pointed-to structs
1022 disp_def.append("// Output all struct elements, and for any structs pointed to, print complete contents")
1023 disp_def.append("void %s::display_full_txt()\n{" % self.get_class_name(s))
1024 disp_def.append(' printf("%%*s%s struct contents at %%p:\\n", m_indent, "", (void*)m_origStructAddr);' % typedef_fwd_dict[s])
1025 disp_def.append(' this->display_struct_members();')
1026 class_num = 0
1027 # TODO : Need to handle arrays of structs here
1028 for ms in struct_array:
1029 swc_name = "class%s" % str(class_num)
1030 if ms['array']:
1031 if not i_declared:
1032 disp_def.append(' uint32_t i;')
1033 i_declared = True
1034 disp_def.append(' for (i = 0; i<%s; i++) {' % ms['array_size'])
1035 #disp_def.append(" if (m_struct.%s[i]) {" % (ms['name']))
1036 disp_def.append(" %s %s(&(m_struct.%s[i]));" % (self.get_class_name(ms['type']), swc_name, ms['name']))
1037 disp_def.append(" %s.set_indent(m_indent + 4);" % (swc_name))
1038 disp_def.append(" %s.display_full_txt();" % (swc_name))
1039 #disp_def.append(' }')
1040 disp_def.append(' }')
1041 elif 'pNext' == ms['name']:
1042 # Need some code trickery here
1043 # I'm thinking have a generated function that takes pNext ptr value
1044 # then it checks sType and in large switch statement creates appropriate
1045 # wrapper class type and then prints contents
1046 disp_def.append(" if (m_struct.%s) {" % (ms['name']))
1047 #disp_def.append(' printf("%*s This is where we would call dynamic print function\\n", m_indent, "");')
1048 disp_def.append(' dynamic_display_full_txt(m_struct.%s, m_indent);' % (ms['name']))
1049 disp_def.append(" }")
1050 else:
1051 if ms['ptr']:
1052 disp_def.append(" if (m_struct.%s) {" % (ms['name']))
1053 disp_def.append(" %s %s(m_struct.%s);" % (self.get_class_name(ms['type']), swc_name, ms['name']))
1054 else:
1055 disp_def.append(" if (&m_struct.%s) {" % (ms['name']))
1056 disp_def.append(" %s %s(&m_struct.%s);" % (self.get_class_name(ms['type']), swc_name, ms['name']))
1057 disp_def.append(" %s.set_indent(m_indent + 4);" % (swc_name))
1058 disp_def.append(" %s.display_full_txt();\n }" % (swc_name))
1059 class_num += 1
1060 disp_def.append("}\n")
1061 return "\n".join(disp_def)
1062
1063 def _generateStringHelperHeader(self):
1064 header = []
1065 header.append("//#includes, #defines, globals and such...\n")
1066 for f in self.include_headers:
Courtney Goeltzenleuchter9cc421e2015-04-08 15:36:08 -06001067 if 'vk_enum_string_helper' not in f:
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001068 header.append("#include <%s>\n" % f)
Courtney Goeltzenleuchter9cc421e2015-04-08 15:36:08 -06001069 header.append('#include "vk_enum_string_helper.h"\n\n// Function Prototypes\n')
Mark Lobodzinskie2d07a52015-01-29 08:55:56 -06001070 header.append("char* dynamic_display(const void* pStruct, const char* prefix);\n")
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001071 return "".join(header)
Tobin Ehlis434db7c2015-01-10 12:42:41 -07001072
1073 def _generateStringHelperHeaderCpp(self):
1074 header = []
1075 header.append("//#includes, #defines, globals and such...\n")
1076 for f in self.include_headers:
Courtney Goeltzenleuchter9cc421e2015-04-08 15:36:08 -06001077 if 'vk_enum_string_helper' not in f:
Tobin Ehlis434db7c2015-01-10 12:42:41 -07001078 header.append("#include <%s>\n" % f)
Courtney Goeltzenleuchter9cc421e2015-04-08 15:36:08 -06001079 header.append('#include "vk_enum_string_helper.h"\n')
Tobin Ehlis434db7c2015-01-10 12:42:41 -07001080 header.append('using namespace std;\n\n// Function Prototypes\n')
Tobin Ehlis4a636a12015-04-09 09:19:36 -06001081 header.append('\n')
1082 header.append('namespace StreamControl\n')
1083 header.append('{\n')
1084 header.append('bool writeAddress = true;\n')
1085 header.append('template <typename T>\n')
1086 header.append('std::ostream& operator<< (std::ostream &out, T const* pointer)\n')
1087 header.append('{\n')
1088 header.append(' if(writeAddress)\n')
1089 header.append(' {\n')
1090 header.append(' out.operator<<(pointer);\n')
1091 header.append(' }\n')
1092 header.append(' else\n')
1093 header.append(' {\n')
1094 header.append(' std::operator<<(out, "address");\n')
1095 header.append(' }\n')
1096 header.append(' return out;\n')
1097 header.append('}\n')
1098 header.append('std::ostream& operator<<(std::ostream &out, char const*const s)\n')
1099 header.append('{\n')
1100 header.append(' return std::operator<<(out, s);\n')
1101 header.append('}\n')
1102 header.append('}\n')
1103 header.append('\n')
Mark Lobodzinskie2d07a52015-01-29 08:55:56 -06001104 header.append("string dynamic_display(const void* pStruct, const string prefix);\n")
Tobin Ehlis434db7c2015-01-10 12:42:41 -07001105 return "".join(header)
1106
Tobin Ehlis6cd06372014-12-17 17:44:50 -07001107 def _generateValidateHelperFunctions(self):
1108 sh_funcs = []
1109 # We do two passes, first pass just generates prototypes for all the functsions
Peter Lohrmannc55cfa12015-03-30 16:29:56 -07001110 for s in sorted(self.struct_dict):
Tobin Ehlis6cd06372014-12-17 17:44:50 -07001111 sh_funcs.append('uint32_t %s(const %s* pStruct);' % (self._get_vh_func_name(s), typedef_fwd_dict[s]))
1112 sh_funcs.append('\n')
Peter Lohrmannc55cfa12015-03-30 16:29:56 -07001113 for s in sorted(self.struct_dict):
Tobin Ehlis6cd06372014-12-17 17:44:50 -07001114 sh_funcs.append('uint32_t %s(const %s* pStruct)\n{' % (self._get_vh_func_name(s), typedef_fwd_dict[s]))
1115 for m in sorted(self.struct_dict[s]):
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -06001116 # TODO : Need to handle arrays of enums like in VkRenderPassCreateInfo struct
Tobin Ehlis2f3726c2015-01-15 17:51:52 -07001117 if is_type(self.struct_dict[s][m]['type'], 'enum') and not self.struct_dict[s][m]['ptr']:
Tobin Ehlis6cd06372014-12-17 17:44:50 -07001118 sh_funcs.append(' if (!validate_%s(pStruct->%s))\n return 0;' % (self.struct_dict[s][m]['type'], self.struct_dict[s][m]['name']))
Jon Ashburnaad29362015-01-12 15:46:51 -07001119 # TODO : Need a little refinement to this code to make sure type of struct matches expected input (ptr, const...)
Tobin Ehlise719e022014-12-18 09:29:58 -07001120 if is_type(self.struct_dict[s][m]['type'], 'struct'):
1121 if (self.struct_dict[s][m]['ptr']):
Tobin Ehlis516aa842015-02-24 15:39:04 -07001122 sh_funcs.append(' if (pStruct->%s && !%s((const %s*)pStruct->%s))\n return 0;' % (self.struct_dict[s][m]['name'], self._get_vh_func_name(self.struct_dict[s][m]['type']), self.struct_dict[s][m]['type'], self.struct_dict[s][m]['name']))
Tobin Ehlise719e022014-12-18 09:29:58 -07001123 else:
1124 sh_funcs.append(' if (!%s((const %s*)&pStruct->%s))\n return 0;' % (self._get_vh_func_name(self.struct_dict[s][m]['type']), self.struct_dict[s][m]['type'], self.struct_dict[s][m]['name']))
Tobin Ehlis6cd06372014-12-17 17:44:50 -07001125 sh_funcs.append(" return 1;\n}")
1126
1127 return "\n".join(sh_funcs)
1128
1129 def _generateValidateHelperHeader(self):
1130 header = []
1131 header.append("//#includes, #defines, globals and such...\n")
1132 for f in self.include_headers:
Courtney Goeltzenleuchter9cc421e2015-04-08 15:36:08 -06001133 if 'vk_enum_validate_helper' not in f:
Tobin Ehlis6cd06372014-12-17 17:44:50 -07001134 header.append("#include <%s>\n" % f)
Courtney Goeltzenleuchter9cc421e2015-04-08 15:36:08 -06001135 header.append('#include "vk_enum_validate_helper.h"\n\n// Function Prototypes\n')
Mark Lobodzinskie2d07a52015-01-29 08:55:56 -06001136 #header.append("char* dynamic_display(const void* pStruct, const char* prefix);\n")
Tobin Ehlis6cd06372014-12-17 17:44:50 -07001137 return "".join(header)
1138
Tobin Ehlisff765b02015-03-12 14:50:40 -06001139 def _generateSizeHelperFunctions(self):
1140 sh_funcs = []
Peter Lohrmann3a9c63a2015-04-03 11:43:06 -07001141 # just generates prototypes for all the functions
Peter Lohrmannc55cfa12015-03-30 16:29:56 -07001142 for s in sorted(self.struct_dict):
Tobin Ehlisff765b02015-03-12 14:50:40 -06001143 sh_funcs.append('size_t %s(const %s* pStruct);' % (self._get_size_helper_func_name(s), typedef_fwd_dict[s]))
Peter Lohrmann3a9c63a2015-04-03 11:43:06 -07001144 return "\n".join(sh_funcs)
1145
1146
1147 def _generateSizeHelperFunctionsC(self):
1148 sh_funcs = []
1149 # generate function definitions
Peter Lohrmannc55cfa12015-03-30 16:29:56 -07001150 for s in sorted(self.struct_dict):
Peter Lohrmann3a9c63a2015-04-03 11:43:06 -07001151 skip_list = [] # Used when struct elements need to be skipped b/c size already accounted for
Tobin Ehlisff765b02015-03-12 14:50:40 -06001152 sh_funcs.append('size_t %s(const %s* pStruct)\n{' % (self._get_size_helper_func_name(s), typedef_fwd_dict[s]))
1153 indent = ' '
1154 sh_funcs.append('%ssize_t structSize = 0;' % (indent))
1155 sh_funcs.append('%sif (pStruct) {' % (indent))
1156 indent = ' '
1157 sh_funcs.append('%sstructSize = sizeof(%s);' % (indent, typedef_fwd_dict[s]))
1158 i_decl = False
1159 for m in sorted(self.struct_dict[s]):
1160 if m in skip_list:
1161 continue
1162 if self.struct_dict[s][m]['dyn_array']:
1163 if self.struct_dict[s][m]['full_type'].count('*') > 1:
1164 if not is_type(self.struct_dict[s][m]['type'], 'struct') and not 'char' in self.struct_dict[s][m]['type'].lower():
Tobin Ehlis91b2b642015-03-16 10:44:40 -06001165 if 'ppMemBarriers' == self.struct_dict[s][m]['name']:
1166 # TODO : For now be conservative and consider all memBarrier ptrs as largest possible struct
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -06001167 sh_funcs.append('%sstructSize += pStruct->%s*(sizeof(%s*) + sizeof(VkImageMemoryBarrier));' % (indent, self.struct_dict[s][m]['array_size'], self.struct_dict[s][m]['type']))
Tobin Ehlis91b2b642015-03-16 10:44:40 -06001168 else:
1169 sh_funcs.append('%sstructSize += pStruct->%s*(sizeof(%s*) + sizeof(%s));' % (indent, self.struct_dict[s][m]['array_size'], self.struct_dict[s][m]['type'], self.struct_dict[s][m]['type']))
Tobin Ehlisff765b02015-03-12 14:50:40 -06001170 else: # This is an array of char* or array of struct ptrs
1171 if not i_decl:
1172 sh_funcs.append('%suint32_t i = 0;' % (indent))
1173 i_decl = True
1174 sh_funcs.append('%sfor (i = 0; i < pStruct->%s; i++) {' % (indent, self.struct_dict[s][m]['array_size']))
1175 indent = ' '
1176 if is_type(self.struct_dict[s][m]['type'], 'struct'):
1177 sh_funcs.append('%sstructSize += (sizeof(%s*) + %s(pStruct->%s[i]));' % (indent, self.struct_dict[s][m]['type'], self._get_size_helper_func_name(self.struct_dict[s][m]['type']), self.struct_dict[s][m]['name']))
1178 else:
Tobin Ehlisf57562c2015-03-13 07:18:05 -06001179 sh_funcs.append('%sstructSize += (sizeof(char*) + (sizeof(char) * (1 + strlen(pStruct->%s[i]))));' % (indent, self.struct_dict[s][m]['name']))
Tobin Ehlisff765b02015-03-12 14:50:40 -06001180 indent = ' '
1181 sh_funcs.append('%s}' % (indent))
1182 else:
1183 if is_type(self.struct_dict[s][m]['type'], 'struct'):
1184 if not i_decl:
1185 sh_funcs.append('%suint32_t i = 0;' % (indent))
1186 i_decl = True
1187 sh_funcs.append('%sfor (i = 0; i < pStruct->%s; i++) {' % (indent, self.struct_dict[s][m]['array_size']))
1188 indent = ' '
1189 sh_funcs.append('%sstructSize += %s(&pStruct->%s[i]);' % (indent, self._get_size_helper_func_name(self.struct_dict[s][m]['type']), self.struct_dict[s][m]['name']))
1190 indent = ' '
1191 sh_funcs.append('%s}' % (indent))
1192 else:
1193 sh_funcs.append('%sstructSize += pStruct->%s*sizeof(%s);' % (indent, self.struct_dict[s][m]['array_size'], self.struct_dict[s][m]['type']))
1194 elif self.struct_dict[s][m]['ptr'] and 'pNext' != self.struct_dict[s][m]['name']:
1195 if 'char' in self.struct_dict[s][m]['type'].lower():
Tobin Ehlisf57562c2015-03-13 07:18:05 -06001196 sh_funcs.append('%sstructSize += sizeof(%s)*(1+strlen(pStruct->%s));' % (indent, self.struct_dict[s][m]['type'], self.struct_dict[s][m]['name']))
Tobin Ehlisff765b02015-03-12 14:50:40 -06001197 elif is_type(self.struct_dict[s][m]['type'], 'struct'):
1198 sh_funcs.append('%sstructSize += %s(pStruct->%s);' % (indent, self._get_size_helper_func_name(self.struct_dict[s][m]['type']), self.struct_dict[s][m]['name']))
Tobin Ehlis91b2b642015-03-16 10:44:40 -06001199 elif 'void' not in self.struct_dict[s][m]['type'].lower():
Tobin Ehlisff765b02015-03-12 14:50:40 -06001200 sh_funcs.append('%sstructSize += sizeof(%s);' % (indent, self.struct_dict[s][m]['type']))
1201 elif 'size_t' == self.struct_dict[s][m]['type'].lower():
1202 sh_funcs.append('%sstructSize += pStruct->%s;' % (indent, self.struct_dict[s][m]['name']))
1203 skip_list.append(m+1)
1204 indent = ' '
1205 sh_funcs.append('%s}' % (indent))
1206 sh_funcs.append("%sreturn structSize;\n}" % (indent))
Tobin Ehlis91b2b642015-03-16 10:44:40 -06001207 # Now generate generic functions to loop over entire struct chain (or just handle single generic structs)
1208 for follow_chain in [True, False]:
1209 if follow_chain:
1210 sh_funcs.append('size_t get_struct_chain_size(const void* pStruct)\n{')
1211 else:
1212 sh_funcs.append('size_t get_dynamic_struct_size(const void* pStruct)\n{')
1213 indent = ' '
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -06001214 sh_funcs.append('%s// Just use VkApplicationInfo as struct until actual type is resolved' % (indent))
1215 sh_funcs.append('%sVkApplicationInfo* pNext = (VkApplicationInfo*)pStruct;' % (indent))
Tobin Ehlis91b2b642015-03-16 10:44:40 -06001216 sh_funcs.append('%ssize_t structSize = 0;' % (indent))
1217 if follow_chain:
1218 sh_funcs.append('%swhile (pNext) {' % (indent))
1219 indent = ' '
1220 sh_funcs.append('%sswitch (pNext->sType) {' % (indent))
1221 indent += ' '
1222 for e in enum_type_dict:
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -06001223 if 'StructureType' in e:
Tobin Ehlis91b2b642015-03-16 10:44:40 -06001224 for v in sorted(enum_type_dict[e]):
Courtney Goeltzenleuchterddcb6192015-04-14 18:48:46 -06001225 struct_name = get_struct_name_from_struct_type(v)
Tobin Ehlis91b2b642015-03-16 10:44:40 -06001226 sh_funcs.append('%scase %s:' % (indent, v))
1227 sh_funcs.append('%s{' % (indent))
1228 indent += ' '
1229 sh_funcs.append('%sstructSize += %s((%s*)pNext);' % (indent, self._get_size_helper_func_name(struct_name), struct_name))
1230 sh_funcs.append('%sbreak;' % (indent))
1231 indent = indent[:-4]
1232 sh_funcs.append('%s}' % (indent))
1233 sh_funcs.append('%sdefault:' % (indent))
1234 indent += ' '
1235 sh_funcs.append('%sassert(0);' % (indent))
1236 sh_funcs.append('%sstructSize += 0;' % (indent))
1237 indent = indent[:-4]
1238 indent = indent[:-4]
1239 sh_funcs.append('%s}' % (indent))
1240 if follow_chain:
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -06001241 sh_funcs.append('%spNext = (VkApplicationInfo*)pNext->pNext;' % (indent))
Tobin Ehlis91b2b642015-03-16 10:44:40 -06001242 indent = indent[:-4]
1243 sh_funcs.append('%s}' % (indent))
1244 sh_funcs.append('%sreturn structSize;\n}' % indent)
Tobin Ehlisff765b02015-03-12 14:50:40 -06001245 return "\n".join(sh_funcs)
1246
1247 def _generateSizeHelperHeader(self):
1248 header = []
1249 header.append("//#includes, #defines, globals and such...\n")
1250 for f in self.include_headers:
1251 header.append("#include <%s>\n" % f)
1252 header.append('\n// Function Prototypes\n')
1253 header.append("size_t get_struct_chain_size(const void* pStruct);\n")
Tobin Ehlis91b2b642015-03-16 10:44:40 -06001254 header.append("size_t get_dynamic_struct_size(const void* pStruct);\n")
Tobin Ehlisff765b02015-03-12 14:50:40 -06001255 return "".join(header)
1256
Peter Lohrmann3a9c63a2015-04-03 11:43:06 -07001257 def _generateSizeHelperHeaderC(self):
1258 header = []
Courtney Goeltzenleuchtercbf13812015-04-14 16:30:53 -06001259 header.append('#include "vk_struct_size_helper.h"')
Peter Lohrmann3a9c63a2015-04-03 11:43:06 -07001260 header.append('#include <string.h>')
1261 header.append('#include <assert.h>')
1262 header.append('\n// Function definitions\n')
1263 return "\n".join(header)
1264
1265
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001266 def _generateHeader(self):
1267 header = []
1268 header.append("//#includes, #defines, globals and such...\n")
1269 for f in self.include_headers:
1270 header.append("#include <%s>\n" % f)
1271 return "".join(header)
1272
1273 # Declarations
1274 def _generateConstructorDeclarations(self, s):
1275 constructors = []
1276 constructors.append(" %s();\n" % self.get_class_name(s))
1277 constructors.append(" %s(%s* pInStruct);\n" % (self.get_class_name(s), typedef_fwd_dict[s]))
1278 constructors.append(" %s(const %s* pInStruct);\n" % (self.get_class_name(s), typedef_fwd_dict[s]))
1279 return "".join(constructors)
1280
1281 def _generateDestructorDeclarations(self, s):
1282 return " virtual ~%s();\n" % self.get_class_name(s)
1283
1284 def _generateDisplayDeclarations(self, s):
1285 return " void display_txt();\n void display_single_txt();\n void display_full_txt();\n"
1286
1287 def _generateGetSetDeclarations(self, s):
1288 get_set = []
1289 get_set.append(" void set_indent(uint32_t indent) { m_indent = indent; }\n")
1290 for member in sorted(self.struct_dict[s]):
1291 # TODO : Skipping array set/get funcs for now
1292 if self.struct_dict[s][member]['array']:
1293 continue
1294 get_set.append(" %s get_%s() { return m_struct.%s; }\n" % (self.struct_dict[s][member]['full_type'], self.struct_dict[s][member]['name'], self.struct_dict[s][member]['name']))
1295 if not self.struct_dict[s][member]['const']:
1296 get_set.append(" void set_%s(%s inValue) { m_struct.%s = inValue; }\n" % (self.struct_dict[s][member]['name'], self.struct_dict[s][member]['full_type'], self.struct_dict[s][member]['name']))
1297 return "".join(get_set)
1298
1299 def _generatePrivateMembers(self, s):
1300 priv = []
1301 priv.append("\nprivate:\n")
1302 priv.append(" %s m_struct;\n" % typedef_fwd_dict[s])
1303 priv.append(" const %s* m_origStructAddr;\n" % typedef_fwd_dict[s])
1304 priv.append(" uint32_t m_indent;\n")
1305 priv.append(" const char m_dummy_prefix;\n")
1306 priv.append(" void display_struct_members();\n")
1307 return "".join(priv)
1308
1309 def _generateClassDeclaration(self):
1310 class_decl = []
Peter Lohrmannc55cfa12015-03-30 16:29:56 -07001311 for s in sorted(self.struct_dict):
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001312 class_decl.append("\n//class declaration")
1313 class_decl.append("class %s\n{\npublic:" % self.get_class_name(s))
1314 class_decl.append(self._generateConstructorDeclarations(s))
1315 class_decl.append(self._generateDestructorDeclarations(s))
1316 class_decl.append(self._generateDisplayDeclarations(s))
1317 class_decl.append(self._generateGetSetDeclarations(s))
1318 class_decl.append(self._generatePrivateMembers(s))
1319 class_decl.append("};\n")
1320 return "\n".join(class_decl)
1321
1322 def _generateFooter(self):
1323 return "\n//any footer info for class\n"
1324
1325class EnumCodeGen:
Tobin Ehlisbe8dded2014-12-17 07:20:23 -07001326 def __init__(self, enum_type_dict=None, enum_val_dict=None, typedef_fwd_dict=None, in_file=None, out_sh_file=None, out_vh_file=None):
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001327 self.et_dict = enum_type_dict
1328 self.ev_dict = enum_val_dict
1329 self.tf_dict = typedef_fwd_dict
1330 self.in_file = in_file
Tobin Ehlisbe8dded2014-12-17 07:20:23 -07001331 self.out_sh_file = out_sh_file
1332 self.eshfg = CommonFileGen(self.out_sh_file)
1333 self.out_vh_file = out_vh_file
1334 self.evhfg = CommonFileGen(self.out_vh_file)
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001335
1336 def generateStringHelper(self):
Tobin Ehlisbe8dded2014-12-17 07:20:23 -07001337 self.eshfg.setHeader(self._generateSHHeader())
1338 self.eshfg.setBody(self._generateSHBody())
1339 self.eshfg.generate()
1340
1341 def generateEnumValidate(self):
1342 self.evhfg.setHeader(self._generateSHHeader())
Tobin Ehlis6cd06372014-12-17 17:44:50 -07001343 self.evhfg.setBody(self._generateVHBody())
Tobin Ehlisbe8dded2014-12-17 07:20:23 -07001344 self.evhfg.generate()
1345
1346 def _generateVHBody(self):
1347 body = []
Peter Lohrmannc55cfa12015-03-30 16:29:56 -07001348 for bet in sorted(self.et_dict):
Tobin Ehlisbe8dded2014-12-17 07:20:23 -07001349 fet = self.tf_dict[bet]
Tobin Ehlis2972ec72015-04-15 17:04:03 -06001350 body.append("static inline uint32_t validate_%s(%s input_value)\n{" % (fet, fet))
1351 # TODO : This is not ideal, but allows for flag combinations. Need more rigorous validation of realistic flag combinations
Tobin Ehlis3ed9f8f2015-04-22 13:59:43 -06001352 if 'flagbits' in bet.lower():
Tobin Ehlis2972ec72015-04-15 17:04:03 -06001353 body.append(' if (input_value > (%s))' % (' | '.join(self.et_dict[bet])))
1354 body.append(' return 0;')
1355 body.append(' return 1;')
1356 body.append('}\n\n')
1357 else:
1358 body.append(' switch ((%s)input_value)\n {' % (fet))
1359 for e in sorted(self.et_dict[bet]):
1360 if (self.ev_dict[e]['unique']):
1361 body.append(' case %s:' % (e))
1362 body.append(' return 1;\n default:\n return 0;\n }\n}\n\n')
Tobin Ehlisbe8dded2014-12-17 07:20:23 -07001363 return "\n".join(body)
1364
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001365 def _generateSHBody(self):
1366 body = []
1367# with open(self.out_file, "a") as hf:
1368 # bet == base_enum_type, fet == final_enum_type
Peter Lohrmannc55cfa12015-03-30 16:29:56 -07001369 for bet in sorted(self.et_dict):
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001370 fet = self.tf_dict[bet]
Ian Elliotta742a622015-02-18 12:38:04 -07001371 body.append("static inline const char* string_%s(%s input_value)\n{\n switch ((%s)input_value)\n {" % (fet, fet, fet))
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001372 for e in sorted(self.et_dict[bet]):
1373 if (self.ev_dict[e]['unique']):
Tobin Ehlis45bc7f82015-01-16 15:13:34 -07001374 body.append(' case %s:\n return "%s";' % (e, e))
1375 body.append(' default:\n return "Unhandled %s";\n }\n}\n\n' % (fet))
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001376 return "\n".join(body)
1377
1378 def _generateSHHeader(self):
Ian Elliott81ac44c2015-01-13 17:52:38 -07001379 header = []
1380 header.append('#pragma once\n')
Ian Elliottede4a2e2015-04-28 16:11:24 -06001381 header.append('#ifdef _WIN32\n')
1382 header.append('#pragma warning( disable : 4065 )\n')
1383 header.append('#endif\n')
Ian Elliotta742a622015-02-18 12:38:04 -07001384 header.append('#include <%s>\n\n\n' % self.in_file)
Ian Elliott81ac44c2015-01-13 17:52:38 -07001385 return "\n".join(header)
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001386
1387
1388class CMakeGen:
1389 def __init__(self, struct_wrapper=None, out_dir=None):
1390 self.sw = struct_wrapper
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001391 self.include_headers = []
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001392 self.add_lib_file_list = self.sw.get_file_list()
1393 self.out_dir = out_dir
1394 self.out_file = os.path.join(self.out_dir, "CMakeLists.txt")
1395 self.cmg = CommonFileGen(self.out_file)
1396
1397 def generate(self):
1398 self.cmg.setBody(self._generateBody())
1399 self.cmg.generate()
1400
1401 def _generateBody(self):
1402 body = []
1403 body.append("project(%s)" % os.path.basename(self.out_dir))
1404 body.append("cmake_minimum_required(VERSION 2.8)\n")
1405 body.append("add_library(${PROJECT_NAME} %s)\n" % " ".join(self.add_lib_file_list))
1406 body.append('set(COMPILE_FLAGS "-fpermissive")')
1407 body.append('set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} ${COMPILE_FLAGS}")\n')
1408 body.append("include_directories(${SRC_DIR}/thirdparty/${GEN_API}/inc/)\n")
1409 body.append("target_include_directories (%s PUBLIC ${CMAKE_CURRENT_SOURCE_DIR})\n" % os.path.basename(self.out_dir))
1410 return "\n".join(body)
1411
1412class GraphVizGen:
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001413 def __init__(self, struct_dict, prefix, out_dir):
1414 self.struct_dict = struct_dict
1415 self.api = prefix
Courtney Goeltzenleuchter9cc421e2015-04-08 15:36:08 -06001416 if prefix == "vulkan":
1417 self.api_prefix = "vk"
1418 else:
1419 self.api_prefix = prefix
1420 self.out_file = os.path.join(out_dir, self.api_prefix+"_struct_graphviz_helper.h")
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001421 self.gvg = CommonFileGen(self.out_file)
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001422
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001423 def generate(self):
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001424 self.gvg.setCopyright("//This is the copyright\n")
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001425 self.gvg.setHeader(self._generateHeader())
1426 self.gvg.setBody(self._generateBody())
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001427 #self.gvg.setFooter('}')
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001428 self.gvg.generate()
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001429
1430 def set_include_headers(self, include_headers):
1431 self.include_headers = include_headers
1432
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001433 def _generateHeader(self):
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001434 header = []
1435 header.append("//#includes, #defines, globals and such...\n")
1436 for f in self.include_headers:
Courtney Goeltzenleuchter9cc421e2015-04-08 15:36:08 -06001437 if 'vk_enum_string_helper' not in f:
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001438 header.append("#include <%s>\n" % f)
Courtney Goeltzenleuchter9cc421e2015-04-08 15:36:08 -06001439 #header.append('#include "vk_enum_string_helper.h"\n\n// Function Prototypes\n')
Mark Lobodzinskie2d07a52015-01-29 08:55:56 -06001440 header.append("\nchar* dynamic_gv_display(const void* pStruct, const char* prefix);\n")
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001441 return "".join(header)
1442
1443 def _get_gv_func_name(self, struct):
Courtney Goeltzenleuchter9cc421e2015-04-08 15:36:08 -06001444 return "%s_gv_print_%s" % (self.api_prefix, struct.lower().strip("_"))
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001445
1446 # Return elements to create formatted string for given struct member
1447 def _get_struct_gv_print_formatted(self, struct_member, pre_var_name="", postfix = "\\n", struct_var_name="pStruct", struct_ptr=True, print_array=False, port_label=""):
1448 struct_op = "->"
1449 pre_var_name = '"%s "' % struct_member['full_type']
1450 if not struct_ptr:
1451 struct_op = "."
1452 member_name = struct_member['name']
1453 print_type = "p"
1454 cast_type = ""
1455 member_post = ""
1456 array_index = ""
1457 member_print_post = ""
Tobin Ehlisbf0146e2015-02-11 14:24:02 -07001458 print_delimiter = "%"
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -06001459 if struct_member['array'] and 'char' in struct_member['type'].lower(): # just print char array as string
1460 print_type = "p"
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001461 print_array = False
1462 elif struct_member['array'] and not print_array:
1463 # Just print base address of array when not full print_array
1464 cast_type = "(void*)"
1465 elif is_type(struct_member['type'], 'enum'):
Jon Ashburna0ddc902015-01-09 09:11:44 -07001466 if struct_member['ptr']:
1467 struct_var_name = "*" + struct_var_name
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001468 cast_type = "string_%s" % struct_member['type']
1469 print_type = "s"
1470 elif is_type(struct_member['type'], 'struct'): # print struct address for now
1471 cast_type = "(void*)"
1472 if not struct_member['ptr']:
1473 cast_type = "(void*)&"
Tobin Ehlis2f3726c2015-01-15 17:51:52 -07001474 elif 'bool' in struct_member['type']:
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001475 print_type = "s"
1476 member_post = ' ? "TRUE" : "FALSE"'
Tobin Ehlis2f3726c2015-01-15 17:51:52 -07001477 elif 'float' in struct_member['type']:
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001478 print_type = "f"
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -06001479 elif 'uint64' in struct_member['type'] or 'gpusize' in struct_member['type'].lower():
1480 print_type = '" PRId64 "'
Tobin Ehlis2f3726c2015-01-15 17:51:52 -07001481 elif 'uint8' in struct_member['type']:
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001482 print_type = "hu"
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -06001483 elif 'size' in struct_member['type'].lower():
Tobin Ehlisbf0146e2015-02-11 14:24:02 -07001484 print_type = '" PRINTF_SIZE_T_SPECIFIER "'
1485 print_delimiter = ""
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -06001486 elif True in [ui_str.lower() in struct_member['type'].lower() for ui_str in ['uint', 'flags', 'samplemask']]:
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001487 print_type = "u"
Tobin Ehlis2f3726c2015-01-15 17:51:52 -07001488 elif 'int' in struct_member['type']:
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001489 print_type = "i"
1490 elif struct_member['ptr']:
1491 pass
1492 else:
1493 #print("Unhandled struct type: %s" % struct_member['type'])
1494 cast_type = "(void*)"
1495 if print_array and struct_member['array']:
1496 member_print_post = "[%u]"
1497 array_index = " i,"
1498 member_post = "[i]"
Tobin Ehlisbf0146e2015-02-11 14:24:02 -07001499 print_out = "<TR><TD>%%s%s%s</TD><TD%s>%s%s%s</TD></TR>" % (member_name, member_print_post, port_label, print_delimiter, print_type, postfix) # section of print that goes inside of quotes
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -06001500 print_arg = ", %s,%s %s(%s%s%s)%s\n" % (pre_var_name, array_index, cast_type, struct_var_name, struct_op, member_name, member_post) # section of print passed to portion in quotes
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001501 return (print_out, print_arg)
1502
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001503 def _generateBody(self):
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001504 gv_funcs = []
1505 array_func_list = [] # structs for which we'll generate an array version of their print function
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -06001506 array_func_list.append('vkbufferviewattachinfo')
1507 array_func_list.append('vkimageviewattachinfo')
1508 array_func_list.append('vksamplerimageviewinfo')
1509 array_func_list.append('vkdescriptortypecount')
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001510 # For first pass, generate prototype
Peter Lohrmannc55cfa12015-03-30 16:29:56 -07001511 for s in sorted(self.struct_dict):
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001512 gv_funcs.append('char* %s(const %s* pStruct, const char* myNodeName);\n' % (self._get_gv_func_name(s), typedef_fwd_dict[s]))
1513 if s.lower().strip("_") in array_func_list:
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -06001514 if s.lower().strip("_") in ['vkbufferviewattachinfo', 'vkimageviewattachinfo']:
Tobin Ehlisd1c0e662015-02-26 12:57:08 -07001515 gv_funcs.append('char* %s_array(uint32_t count, const %s* const* pStruct, const char* myNodeName);\n' % (self._get_gv_func_name(s), typedef_fwd_dict[s]))
1516 else:
1517 gv_funcs.append('char* %s_array(uint32_t count, const %s* pStruct, const char* myNodeName);\n' % (self._get_gv_func_name(s), typedef_fwd_dict[s]))
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001518 gv_funcs.append('\n')
Peter Lohrmannc55cfa12015-03-30 16:29:56 -07001519 for s in sorted(self.struct_dict):
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001520 p_out = ""
1521 p_args = ""
1522 stp_list = [] # stp == "struct to print" a list of structs for this API call that should be printed as structs
1523 # the fields below are a super-hacky way for now to get port labels into GV output, TODO : Clean this up!
1524 pl_dict = {}
1525 struct_num = 0
Tobin Ehlisd1c0e662015-02-26 12:57:08 -07001526 # This isn't great but this pre-pass flags structs w/ pNext and other struct ptrs
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001527 for m in sorted(self.struct_dict[s]):
1528 if 'pNext' == self.struct_dict[s][m]['name'] or is_type(self.struct_dict[s][m]['type'], 'struct'):
1529 stp_list.append(self.struct_dict[s][m])
1530 if 'pNext' == self.struct_dict[s][m]['name']:
1531 pl_dict[m] = ' PORT=\\"pNext\\"'
1532 else:
1533 pl_dict[m] = ' PORT=\\"struct%i\\"' % struct_num
1534 struct_num += 1
1535 gv_funcs.append('char* %s(const %s* pStruct, const char* myNodeName)\n{\n char* str;\n' % (self._get_gv_func_name(s), typedef_fwd_dict[s]))
1536 num_stps = len(stp_list);
1537 total_strlen_str = ''
1538 if 0 != num_stps:
1539 gv_funcs.append(" char* tmpStr;\n")
1540 gv_funcs.append(" char nodeName[100];\n")
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001541 gv_funcs.append(' char* stp_strs[%i];\n' % num_stps)
1542 for index in range(num_stps):
1543 if (stp_list[index]['ptr']):
1544 if 'pDescriptorInfo' == stp_list[index]['name']:
1545 gv_funcs.append(' if (pStruct->pDescriptorInfo && (0 != pStruct->descriptorCount)) {\n')
1546 else:
1547 gv_funcs.append(' if (pStruct->%s) {\n' % stp_list[index]['name'])
1548 if 'pNext' == stp_list[index]['name']:
1549 gv_funcs.append(' sprintf(nodeName, "pNext_%p", (void*)pStruct->pNext);\n')
Mark Lobodzinskie2d07a52015-01-29 08:55:56 -06001550 gv_funcs.append(' tmpStr = dynamic_gv_display((void*)pStruct->pNext, nodeName);\n')
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001551 gv_funcs.append(' stp_strs[%i] = (char*)malloc(256+strlen(tmpStr)+strlen(nodeName)+strlen(myNodeName));\n' % index)
1552 gv_funcs.append(' sprintf(stp_strs[%i], "%%s\\n\\"%%s\\":pNext -> \\"%%s\\" [];\\n", tmpStr, myNodeName, nodeName);\n' % index)
1553 gv_funcs.append(' free(tmpStr);\n')
1554 else:
1555 gv_funcs.append(' sprintf(nodeName, "%s_%%p", (void*)pStruct->%s);\n' % (stp_list[index]['name'], stp_list[index]['name']))
Tobin Ehlisdd82f6b2015-04-03 12:01:11 -06001556 if stp_list[index]['name'] in ['pTypeCount', 'pSamplerImageViews']:
Tobin Ehlisd1c0e662015-02-26 12:57:08 -07001557 gv_funcs.append(' tmpStr = %s_array(pStruct->count, pStruct->%s, nodeName);\n' % (self._get_gv_func_name(stp_list[index]['type']), stp_list[index]['name']))
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001558 else:
1559 gv_funcs.append(' tmpStr = %s(pStruct->%s, nodeName);\n' % (self._get_gv_func_name(stp_list[index]['type']), stp_list[index]['name']))
1560 gv_funcs.append(' stp_strs[%i] = (char*)malloc(256+strlen(tmpStr)+strlen(nodeName)+strlen(myNodeName));\n' % (index))
1561 gv_funcs.append(' sprintf(stp_strs[%i], "%%s\\n\\"%%s\\":struct%i -> \\"%%s\\" [];\\n", tmpStr, myNodeName, nodeName);\n' % (index, index))
1562 gv_funcs.append(' }\n')
Chia-I Wu81f46672014-12-16 00:36:58 +08001563 gv_funcs.append(" else\n stp_strs[%i] = \"\";\n" % (index))
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001564 elif stp_list[index]['array']: # TODO : For now just printing first element of array
1565 gv_funcs.append(' sprintf(nodeName, "%s_%%p", (void*)&pStruct->%s[0]);\n' % (stp_list[index]['name'], stp_list[index]['name']))
1566 gv_funcs.append(' tmpStr = %s(&pStruct->%s[0], nodeName);\n' % (self._get_gv_func_name(stp_list[index]['type']), stp_list[index]['name']))
1567 gv_funcs.append(' stp_strs[%i] = (char*)malloc(256+strlen(tmpStr)+strlen(nodeName)+strlen(myNodeName));\n' % (index))
1568 gv_funcs.append(' sprintf(stp_strs[%i], "%%s\\n\\"%%s\\":struct%i -> \\"%%s\\" [];\\n", tmpStr, myNodeName, nodeName);\n' % (index, index))
1569 else:
1570 gv_funcs.append(' sprintf(nodeName, "%s_%%p", (void*)&pStruct->%s);\n' % (stp_list[index]['name'], stp_list[index]['name']))
1571 gv_funcs.append(' tmpStr = %s(&pStruct->%s, nodeName);\n' % (self._get_gv_func_name(stp_list[index]['type']), stp_list[index]['name']))
1572 gv_funcs.append(' stp_strs[%i] = (char*)malloc(256+strlen(tmpStr)+strlen(nodeName)+strlen(myNodeName));\n' % (index))
1573 gv_funcs.append(' sprintf(stp_strs[%i], "%%s\\n\\"%%s\\":struct%i -> \\"%%s\\" [];\\n", tmpStr, myNodeName, nodeName);\n' % (index, index))
1574 total_strlen_str += 'strlen(stp_strs[%i]) + ' % index
1575 gv_funcs.append(' str = (char*)malloc(%ssizeof(char)*2048);\n' % (total_strlen_str))
1576 gv_funcs.append(' sprintf(str, "\\"%s\\" [\\nlabel = <<TABLE BORDER=\\"0\\" CELLBORDER=\\"1\\" CELLSPACING=\\"0\\"><TR><TD COLSPAN=\\"2\\">%s (%p)</TD></TR>')
1577 p_args = ", myNodeName, myNodeName, pStruct"
1578 for m in sorted(self.struct_dict[s]):
1579 plabel = ""
1580 if m in pl_dict:
1581 plabel = pl_dict[m]
1582 (p_out1, p_args1) = self._get_struct_gv_print_formatted(self.struct_dict[s][m], port_label=plabel)
1583 p_out += p_out1
1584 p_args += p_args1
1585 p_out += '</TABLE>>\\n];\\n\\n"'
1586 p_args += ");\n"
1587 gv_funcs.append(p_out)
1588 gv_funcs.append(p_args)
1589 if 0 != num_stps:
1590 gv_funcs.append(' for (int32_t stp_index = %i; stp_index >= 0; stp_index--) {\n' % (num_stps-1))
1591 gv_funcs.append(' if (0 < strlen(stp_strs[stp_index])) {\n')
1592 gv_funcs.append(' strncat(str, stp_strs[stp_index], strlen(stp_strs[stp_index]));\n')
1593 gv_funcs.append(' free(stp_strs[stp_index]);\n')
1594 gv_funcs.append(' }\n')
1595 gv_funcs.append(' }\n')
1596 gv_funcs.append(" return str;\n}\n")
1597 if s.lower().strip("_") in array_func_list:
Tobin Ehlisd1c0e662015-02-26 12:57:08 -07001598 ptr_array = False
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -06001599 if s.lower().strip("_") in ['vkbufferviewattachinfo', 'vkimageviewattachinfo']:
Tobin Ehlisd1c0e662015-02-26 12:57:08 -07001600 ptr_array = True
1601 gv_funcs.append('char* %s_array(uint32_t count, const %s* const* pStruct, const char* myNodeName)\n{\n char* str;\n char tmpStr[1024];\n' % (self._get_gv_func_name(s), typedef_fwd_dict[s]))
1602 else:
1603 gv_funcs.append('char* %s_array(uint32_t count, const %s* pStruct, const char* myNodeName)\n{\n char* str;\n char tmpStr[1024];\n' % (self._get_gv_func_name(s), typedef_fwd_dict[s]))
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001604 gv_funcs.append(' str = (char*)malloc(sizeof(char)*1024*count);\n')
1605 gv_funcs.append(' sprintf(str, "\\"%s\\" [\\nlabel = <<TABLE BORDER=\\"0\\" CELLBORDER=\\"1\\" CELLSPACING=\\"0\\"><TR><TD COLSPAN=\\"3\\">%s (%p)</TD></TR>", myNodeName, myNodeName, pStruct);\n')
1606 gv_funcs.append(' for (uint32_t i=0; i < count; i++) {\n')
1607 gv_funcs.append(' sprintf(tmpStr, "');
1608 p_args = ""
1609 p_out = ""
1610 for m in sorted(self.struct_dict[s]):
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001611 plabel = ""
1612 (p_out1, p_args1) = self._get_struct_gv_print_formatted(self.struct_dict[s][m], port_label=plabel)
Tobin Ehlisd1c0e662015-02-26 12:57:08 -07001613 if 0 == m: # Add array index notation at end of first row
1614 p_out1 = '%s<TD ROWSPAN=\\"%i\\" PORT=\\"slot%%u\\">%%u</TD></TR>' % (p_out1[:-5], len(self.struct_dict[s]))
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001615 p_args1 += ', i, i'
1616 p_out += p_out1
1617 p_args += p_args1
1618 p_out += '"'
1619 p_args += ");\n"
Tobin Ehlisd1c0e662015-02-26 12:57:08 -07001620 if ptr_array:
1621 p_args = p_args.replace('->', '[i]->')
1622 else:
1623 p_args = p_args.replace('->', '[i].')
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001624 gv_funcs.append(p_out);
1625 gv_funcs.append(p_args);
1626 gv_funcs.append(' strncat(str, tmpStr, strlen(tmpStr));\n')
1627 gv_funcs.append(' }\n')
1628 gv_funcs.append(' strncat(str, "</TABLE>>\\n];\\n\\n", 20);\n')
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001629 gv_funcs.append(' return str;\n}\n')
1630 # Add function to dynamically print out unknown struct
Mark Lobodzinskie2d07a52015-01-29 08:55:56 -06001631 gv_funcs.append("char* dynamic_gv_display(const void* pStruct, const char* nodeName)\n{\n")
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001632 gv_funcs.append(" // Cast to APP_INFO ptr initially just to pull sType off struct\n")
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -06001633 gv_funcs.append(" VkStructureType sType = ((VkApplicationInfo*)pStruct)->sType;\n")
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001634 gv_funcs.append(" switch (sType)\n {\n")
1635 for e in enum_type_dict:
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -06001636 if "StructureType" in e:
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001637 for v in sorted(enum_type_dict[e]):
Courtney Goeltzenleuchterddcb6192015-04-14 18:48:46 -06001638 struct_name = get_struct_name_from_struct_type(v)
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001639 print_func_name = self._get_gv_func_name(struct_name)
1640 # TODO : Hand-coded fixes for some exceptions
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -06001641 #if 'VkPipelineCbStateCreateInfo' in struct_name:
Courtney Goeltzenleuchter9cc421e2015-04-08 15:36:08 -06001642 # struct_name = 'VK_PIPELINE_CB_STATE'
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -06001643 if 'VkSemaphoreCreateInfo' in struct_name:
1644 struct_name = 'VkSemaphoreCreateInfo'
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001645 print_func_name = self._get_gv_func_name(struct_name)
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -06001646 elif 'VkSemaphoreOpenInfo' in struct_name:
1647 struct_name = 'VkSemaphoreOpenInfo'
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001648 print_func_name = self._get_gv_func_name(struct_name)
1649 gv_funcs.append(' case %s:\n' % (v))
1650 gv_funcs.append(' return %s((%s*)pStruct, nodeName);\n' % (print_func_name, struct_name))
1651 #gv_funcs.append(' }\n')
1652 #gv_funcs.append(' break;\n')
Chia-I Wu84d7f5c2014-12-16 00:43:20 +08001653 gv_funcs.append(" default:\n")
1654 gv_funcs.append(" return NULL;\n")
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001655 gv_funcs.append(" }\n")
1656 gv_funcs.append("}")
1657 return "".join(gv_funcs)
1658
1659
1660
1661
1662
1663# def _generateHeader(self):
1664# hdr = []
1665# hdr.append('digraph g {\ngraph [\nrankdir = "LR"\n];')
1666# hdr.append('node [\nfontsize = "16"\nshape = "plaintext"\n];')
1667# hdr.append('edge [\n];\n')
1668# return "\n".join(hdr)
1669#
1670# def _generateBody(self):
1671# body = []
Peter Lohrmannc55cfa12015-03-30 16:29:56 -07001672# for s in sorted(self.struc_dict):
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001673# field_num = 1
1674# body.append('"%s" [\nlabel = <<TABLE BORDER="0" CELLBORDER="1" CELLSPACING="0"> <TR><TD COLSPAN="2" PORT="f0">%s</TD></TR>' % (s, typedef_fwd_dict[s]))
1675# for m in sorted(self.struc_dict[s]):
1676# body.append('<TR><TD PORT="f%i">%s</TD><TD PORT="f%i">%s</TD></TR>' % (field_num, self.struc_dict[s][m]['full_type'], field_num+1, self.struc_dict[s][m]['name']))
1677# field_num += 2
1678# body.append('</TABLE>>\n];\n')
1679# return "".join(body)
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001680
1681def main(argv=None):
1682 opts = handle_args()
1683 # Parse input file and fill out global dicts
1684 hfp = HeaderFileParser(opts.input_file)
1685 hfp.parse()
1686 # TODO : Don't want these to be global, see note at top about wrapper classes
1687 global enum_val_dict
1688 global enum_type_dict
1689 global struct_dict
1690 global typedef_fwd_dict
1691 global typedef_rev_dict
1692 global types_dict
1693 enum_val_dict = hfp.get_enum_val_dict()
1694 enum_type_dict = hfp.get_enum_type_dict()
1695 struct_dict = hfp.get_struct_dict()
Tobin Ehlis6f7029b2014-11-11 12:28:12 -07001696 # TODO : Would like to validate struct data here to verify that all of the bools for struct members are correct at this point
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001697 typedef_fwd_dict = hfp.get_typedef_fwd_dict()
1698 typedef_rev_dict = hfp.get_typedef_rev_dict()
1699 types_dict = hfp.get_types_dict()
1700 #print(enum_val_dict)
1701 #print(typedef_dict)
1702 #print(struct_dict)
Courtney Goeltzenleuchter9cc421e2015-04-08 15:36:08 -06001703 prefix = os.path.basename(opts.input_file).strip(".h")
1704 if prefix == "vulkan":
1705 prefix = "vk"
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001706 if (opts.abs_out_dir is not None):
Courtney Goeltzenleuchter9cc421e2015-04-08 15:36:08 -06001707 enum_sh_filename = os.path.join(opts.abs_out_dir, prefix+"_enum_string_helper.h")
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001708 else:
Courtney Goeltzenleuchter9cc421e2015-04-08 15:36:08 -06001709 enum_sh_filename = os.path.join(os.getcwd(), opts.rel_out_dir, prefix+"_enum_string_helper.h")
Tobin Ehlisbe8dded2014-12-17 07:20:23 -07001710 enum_sh_filename = os.path.abspath(enum_sh_filename)
1711 if not os.path.exists(os.path.dirname(enum_sh_filename)):
1712 print("Creating output dir %s" % os.path.dirname(enum_sh_filename))
1713 os.mkdir(os.path.dirname(enum_sh_filename))
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001714 if opts.gen_enum_string_helper:
Tobin Ehlisbe8dded2014-12-17 07:20:23 -07001715 print("Generating enum string helper to %s" % enum_sh_filename)
Courtney Goeltzenleuchter9cc421e2015-04-08 15:36:08 -06001716 enum_vh_filename = os.path.join(os.path.dirname(enum_sh_filename), prefix+"_enum_validate_helper.h")
Tobin Ehlisbe8dded2014-12-17 07:20:23 -07001717 print("Generating enum validate helper to %s" % enum_vh_filename)
1718 eg = EnumCodeGen(enum_type_dict, enum_val_dict, typedef_fwd_dict, os.path.basename(opts.input_file), enum_sh_filename, enum_vh_filename)
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001719 eg.generateStringHelper()
Tobin Ehlisbe8dded2014-12-17 07:20:23 -07001720 eg.generateEnumValidate()
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001721 #for struct in struct_dict:
1722 #print(struct)
1723 if opts.gen_struct_wrappers:
Tobin Ehlisbe8dded2014-12-17 07:20:23 -07001724 sw = StructWrapperGen(struct_dict, os.path.basename(opts.input_file).strip(".h"), os.path.dirname(enum_sh_filename))
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001725 #print(sw.get_class_name(struct))
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -06001726 sw.set_include_headers([os.path.basename(opts.input_file),os.path.basename(enum_sh_filename),"stdint.h","inttypes.h", "stdio.h","stdlib.h"])
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001727 print("Generating struct wrapper header to %s" % sw.header_filename)
1728 sw.generateHeader()
1729 print("Generating struct wrapper class to %s" % sw.class_filename)
1730 sw.generateBody()
1731 sw.generateStringHelper()
Tobin Ehlis6cd06372014-12-17 17:44:50 -07001732 sw.generateValidateHelper()
Tobin Ehlis07fe9ab2014-11-25 17:43:26 -07001733 # Generate a 2nd helper file that excludes addrs
1734 sw.set_no_addr(True)
1735 sw.generateStringHelper()
Tobin Ehlis434db7c2015-01-10 12:42:41 -07001736 sw.set_no_addr(False)
1737 sw.set_include_headers([os.path.basename(opts.input_file),os.path.basename(enum_sh_filename),"stdint.h","stdio.h","stdlib.h","iostream","sstream","string"])
Tobin Ehlis434db7c2015-01-10 12:42:41 -07001738 sw.set_no_addr(True)
1739 sw.generateStringHelperCpp()
Tobin Ehlis91cc24a2015-03-06 10:38:25 -07001740 sw.set_no_addr(False)
1741 sw.generateStringHelperCpp()
Courtney Goeltzenleuchtera8c06282015-04-14 14:55:44 -06001742 sw.set_include_headers(["stdio.h", "stdlib.h", "vulkan.h"])
Tobin Ehlisff765b02015-03-12 14:50:40 -06001743 sw.generateSizeHelper()
Peter Lohrmann3a9c63a2015-04-03 11:43:06 -07001744 sw.generateSizeHelperC()
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001745 if opts.gen_cmake:
Tobin Ehlisbe8dded2014-12-17 07:20:23 -07001746 cmg = CMakeGen(sw, os.path.dirname(enum_sh_filename))
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001747 cmg.generate()
1748 if opts.gen_graphviz:
Tobin Ehlisbe8dded2014-12-17 07:20:23 -07001749 gv = GraphVizGen(struct_dict, os.path.basename(opts.input_file).strip(".h"), os.path.dirname(enum_sh_filename))
Courtney Goeltzenleuchter382489d2015-04-10 08:34:15 -06001750 gv.set_include_headers([os.path.basename(opts.input_file),os.path.basename(enum_sh_filename),"stdint.h","stdio.h","stdlib.h", "inttypes.h"])
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001751 gv.generate()
1752 print("DONE!")
1753 #print(typedef_rev_dict)
1754 #print(types_dict)
1755 #recreate_structs()
1756
1757if __name__ == "__main__":
1758 sys.exit(main())