blob: 9a52e3392b599cc7c3bc6aa48ed4b665ee95aed5 [file] [log] [blame]
Tobin Ehlis33267fd2014-11-10 16:03:19 -07001#!/usr/bin/env python3
2#
3# XGL
4#
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 Ehlis6442dca2014-10-22 15:13:53 -060024import argparse
25import os
26import sys
27
28# code_gen.py overview
29# This script generates code based on input headers
30# Initially it's intended to support Mantle and XGL headers and
31# generate wrappers functions that can be used to display
32# structs in a human-readable txt format, as well as utility functions
33# to print enum values as strings
34
35
36def handle_args():
37 parser = argparse.ArgumentParser(description='Perform analysis of vogl trace.')
38 parser.add_argument('input_file', help='The input header file from which code will be generated.')
39 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.')
40 parser.add_argument('--abs_out_dir', required=False, default=None, help='Absolute path to write output files. Will be created if needed.')
41 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.')
42 parser.add_argument('--gen_struct_wrappers', required=False, action='store_true', default=False, help='Enable generation of struct wrapper classes.')
43 parser.add_argument('--gen_cmake', required=False, action='store_true', default=False, help='Enable generation of cmake file for generated code.')
44 parser.add_argument('--gen_graphviz', required=False, action='store_true', default=False, help='Enable generation of graphviz dot file.')
45 #parser.add_argument('--test', action='store_true', default=False, help='Run simple test.')
46 return parser.parse_args()
47
48# TODO : Ideally these data structs would be opaque to user and could be wrapped
49# in their own class(es) to make them friendly for data look-up
50# Dicts for Data storage
51# enum_val_dict[value_name] = dict keys are the string enum value names for all enums
52# |-------->['type'] = the type of enum class into which the value falls
53# |-------->['val'] = the value assigned to this particular value_name
54# '-------->['unique'] = bool designating if this enum 'val' is unique within this enum 'type'
55enum_val_dict = {}
56# enum_type_dict['type'] = the type or class of of enum
57# '----->['val_name1', 'val_name2'...] = each type references a list of val_names within this type
58enum_type_dict = {}
59# struct_dict['struct_basename'] = the base (non-typedef'd) name of the struct
60# |->[<member_num>] = members are stored via their integer placement in the struct
61# | |->['name'] = string name of this struct member
62# ... |->['full_type'] = complete type qualifier for this member
63# |->['type'] = base type for this member
64# |->['ptr'] = bool indicating if this member is ptr
65# |->['const'] = bool indicating if this member is const
66# |->['struct'] = bool indicating if this member is a struct type
67# |->['array'] = bool indicating if this member is an array
Tobin Ehlisbd6a9162015-03-13 07:18:05 -060068# |->['dyn_array'] = bool indicating if member is a dynamically sized array
69# '->['array_size'] = For dyn_array, member name used to size array, else int size for static array
Tobin Ehlis6442dca2014-10-22 15:13:53 -060070struct_dict = {}
71# typedef_fwd_dict stores mapping from orig_type_name -> new_type_name
72typedef_fwd_dict = {}
73# typedef_rev_dict stores mapping from new_type_name -> orig_type_name
74typedef_rev_dict = {} # store new_name -> orig_name mapping
75# types_dict['id_name'] = identifier name will map to it's type
76# '---->'type' = currently either 'struct' or 'enum'
77types_dict = {} # store orig_name -> type mapping
78
79
80# Class that parses header file and generates data structures that can
81# Then be used for other tasks
82class HeaderFileParser:
83 def __init__(self, header_file=None):
84 self.header_file = header_file
85 # store header data in various formats, see above for more info
86 self.enum_val_dict = {}
87 self.enum_type_dict = {}
88 self.struct_dict = {}
89 self.typedef_fwd_dict = {}
90 self.typedef_rev_dict = {}
91 self.types_dict = {}
Tobin Ehlis5178bd72015-03-06 10:38:25 -070092 self.last_struct_count_name = ''
Tobin Ehlis6442dca2014-10-22 15:13:53 -060093
94 def setHeaderFile(self, header_file):
95 self.header_file = header_file
96
97 def get_enum_val_dict(self):
98 return self.enum_val_dict
99
100 def get_enum_type_dict(self):
101 return self.enum_type_dict
102
103 def get_struct_dict(self):
104 return self.struct_dict
105
106 def get_typedef_fwd_dict(self):
107 return self.typedef_fwd_dict
108
109 def get_typedef_rev_dict(self):
110 return self.typedef_rev_dict
111
112 def get_types_dict(self):
113 return self.types_dict
114
115 # Parse header file into data structures
116 def parse(self):
117 # parse through the file, identifying different sections
118 parse_enum = False
119 parse_struct = False
120 member_num = 0
121 # TODO : Comment parsing is very fragile but handles 2 known files
122 block_comment = False
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700123 prev_count_name = ''
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600124 with open(self.header_file) as f:
125 for line in f:
126 if block_comment:
127 if '*/' in line:
128 block_comment = False
129 continue
130 if '/*' in line:
131 block_comment = True
132 elif 0 == len(line.split()):
133 #print("Skipping empty line")
134 continue
135 elif line.split()[0].strip().startswith("//"):
Jon Ashburnfe6113c2015-01-09 09:11:44 -0700136 #print("Skipping commented line %s" % line)
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600137 continue
138 elif 'typedef enum' in line:
139 (ty_txt, en_txt, base_type) = line.strip().split(None, 2)
140 #print("Found ENUM type %s" % base_type)
141 parse_enum = True
Jon Ashburnfe6113c2015-01-09 09:11:44 -0700142 default_enum_val = 0
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600143 self.types_dict[base_type] = 'enum'
144 elif 'typedef struct' in line:
145 (ty_txt, st_txt, base_type) = line.strip().split(None, 2)
146 #print("Found STRUCT type: %s" % base_type)
147 parse_struct = True
148 self.types_dict[base_type] = 'struct'
Jon Ashburnfe6113c2015-01-09 09:11:44 -0700149 elif 'typedef union' in line:
150 (ty_txt, st_txt, base_type) = line.strip().split(None, 2)
151 #print("Found UNION type: %s" % base_type)
152 parse_struct = True
153 self.types_dict[base_type] = 'struct'
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600154 elif '}' in line and (parse_enum or parse_struct):
155 if len(line.split()) > 1: # deals with embedded union in one struct
156 parse_enum = False
157 parse_struct = False
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700158 self.last_struct_count_name = ''
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600159 member_num = 0
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600160 (cur_char, targ_type) = line.strip().split(None, 1)
161 self.typedef_fwd_dict[base_type] = targ_type.strip(';')
162 self.typedef_rev_dict[targ_type.strip(';')] = base_type
163 elif parse_enum:
Tobin Ehlis7e65d752015-01-15 17:51:52 -0700164 #if 'XGL_MAX_ENUM' not in line and '{' not in line:
165 if True not in [ens in line for ens in ['{', 'XGL_MAX_ENUM', '_RANGE']]:
Jon Ashburnfe6113c2015-01-09 09:11:44 -0700166 self._add_enum(line, base_type, default_enum_val)
167 default_enum_val += 1
Tobin Ehlis6442dca2014-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 Ehlis6442dca2014-10-22 15:13:53 -0600172
173 # populate enum dicts based on enum lines
Jon Ashburnfe6113c2015-01-09 09:11:44 -0700174 def _add_enum(self, line_txt, enum_type, def_enum_val):
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600175 #print("Parsing enum line %s" % line_txt)
Jon Ashburnfe6113c2015-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 Ehlis6442dca2014-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 Ehlis43ebcac2014-12-05 12:13:07 -0700186 # account for negative values surrounded by parens
187 self.enum_val_dict[enum_name]['val'] = self.enum_val_dict[enum_name]['val'].strip(')').replace('-(', '-')
188 # Try to cast to int to determine if enum value is unique
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600189 try:
190 #print("ENUM val:", self.enum_val_dict[enum_name]['val'])
191 int(self.enum_val_dict[enum_name]['val'], 0)
192 self.enum_val_dict[enum_name]['unique'] = True
193 #print("ENUM has num value")
194 except ValueError:
195 self.enum_val_dict[enum_name]['unique'] = False
196 #print("ENUM is not a number value")
197 # Update enum_type_dict as well
198 if not enum_type in self.enum_type_dict:
199 self.enum_type_dict[enum_type] = []
200 self.enum_type_dict[enum_type].append(enum_name)
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700201
202 # Return True of struct member is a dynamic array
203 # RULES : This is a bit quirky based on the API
204 # NOTE : Changes in API spec may cause these rules to change
205 # 1. There must be a previous uint var w/ 'count' in the name in the struct
206 # 2. Dynam array must have 'const' and '*' qualifiers
207 # 3a. Name of dynam array must end in 's' char OR
208 # 3b. Name of count var minus 'count' must be contained in name of dynamic array
209 def _is_dynamic_array(self, full_type, name):
210 if '' != self.last_struct_count_name:
211 if 'const' in full_type and '*' in full_type:
212 if name.endswith('s') or self.last_struct_count_name.lower().replace('count', '') in name.lower():
213 return True
214 return False
215
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600216 # populate struct dicts based on struct lines
217 # TODO : Handle ":" bitfield, "**" ptr->ptr and "const type*const*"
218 def _add_struct(self, line_txt, struct_type, num):
219 #print("Parsing struct line %s" % line_txt)
220 if not struct_type in self.struct_dict:
221 self.struct_dict[struct_type] = {}
222 members = line_txt.strip().split(';', 1)[0] # first strip semicolon & comments
223 # TODO : Handle bitfields more correctly
224 members = members.strip().split(':', 1)[0] # strip bitfield element
225 (member_type, member_name) = members.rsplit(None, 1)
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700226 # Store counts to help recognize and size dynamic arrays
227 if 'count' in member_name.lower() and 'uint' in member_type:
228 self.last_struct_count_name = member_name
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600229 self.struct_dict[struct_type][num] = {}
230 self.struct_dict[struct_type][num]['full_type'] = member_type
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700231 self.struct_dict[struct_type][num]['dyn_array'] = False
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600232 if '*' in member_type:
233 self.struct_dict[struct_type][num]['ptr'] = True
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700234 # TODO : Need more general purpose way here to reduce down to basic type
235 member_type = member_type.replace(' const*', '')
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600236 member_type = member_type.strip('*')
237 else:
238 self.struct_dict[struct_type][num]['ptr'] = False
239 if 'const' in member_type:
240 self.struct_dict[struct_type][num]['const'] = True
241 member_type = member_type.strip('const').strip()
242 else:
243 self.struct_dict[struct_type][num]['const'] = False
Tobin Ehlis5a487e52014-11-11 12:28:12 -0700244 # TODO : There is a bug here where it seems that at the time we do this check,
245 # the data is not in the types or typedef_rev_dict, so we never pass this if check
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600246 if is_type(member_type, 'struct'):
247 self.struct_dict[struct_type][num]['struct'] = True
248 else:
249 self.struct_dict[struct_type][num]['struct'] = False
250 self.struct_dict[struct_type][num]['type'] = member_type
251 if '[' in member_name:
252 (member_name, array_size) = member_name.split('[', 1)
253 self.struct_dict[struct_type][num]['array'] = True
254 self.struct_dict[struct_type][num]['array_size'] = array_size.strip(']')
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700255 elif self._is_dynamic_array(self.struct_dict[struct_type][num]['full_type'], member_name):
256 #print("Found dynamic array %s of size %s" % (member_name, self.last_struct_count_name))
257 self.struct_dict[struct_type][num]['array'] = True
258 self.struct_dict[struct_type][num]['dyn_array'] = True
259 self.struct_dict[struct_type][num]['array_size'] = self.last_struct_count_name
Tobin Ehlisb8013a22015-02-26 12:57:08 -0700260 elif not 'array' in self.struct_dict[struct_type][num]:
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600261 self.struct_dict[struct_type][num]['array'] = False
262 self.struct_dict[struct_type][num]['array_size'] = 0
263 self.struct_dict[struct_type][num]['name'] = member_name
264
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700265# check if given identifier is of specified type_to_check
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600266def is_type(identifier, type_to_check):
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600267 if identifier in types_dict and type_to_check == types_dict[identifier]:
268 return True
269 if identifier in typedef_rev_dict:
270 new_id = typedef_rev_dict[identifier]
271 if new_id in types_dict and type_to_check == types_dict[new_id]:
272 return True
273 return False
274
275# This is a validation function to verify that we can reproduce the original structs
276def recreate_structs():
277 for struct_name in struct_dict:
278 sys.stdout.write("typedef struct %s\n{\n" % struct_name)
279 for mem_num in sorted(struct_dict[struct_name]):
280 sys.stdout.write(" ")
281 if struct_dict[struct_name][mem_num]['const']:
282 sys.stdout.write("const ")
283 #if struct_dict[struct_name][mem_num]['struct']:
284 # sys.stdout.write("struct ")
285 sys.stdout.write (struct_dict[struct_name][mem_num]['type'])
286 if struct_dict[struct_name][mem_num]['ptr']:
287 sys.stdout.write("*")
288 sys.stdout.write(" ")
289 sys.stdout.write(struct_dict[struct_name][mem_num]['name'])
290 if struct_dict[struct_name][mem_num]['array']:
291 sys.stdout.write("[")
292 sys.stdout.write(struct_dict[struct_name][mem_num]['array_size'])
293 sys.stdout.write("]")
294 sys.stdout.write(";\n")
295 sys.stdout.write("} ")
296 sys.stdout.write(typedef_fwd_dict[struct_name])
297 sys.stdout.write(";\n\n")
298
299# class for writing common file elements
300# Here's how this class lays out a file:
301# COPYRIGHT
302# HEADER
303# BODY
304# FOOTER
305#
306# For each of these sections, there's a "set*" function
307# The class as a whole has a generate function which will write each section in order
308class CommonFileGen:
309 def __init__(self, filename=None, copyright_txt="", header_txt="", body_txt="", footer_txt=""):
310 self.filename = filename
311 self.contents = {'copyright': copyright_txt, 'header': header_txt, 'body': body_txt, 'footer': footer_txt}
312 # TODO : Set a default copyright & footer at least
313
314 def setFilename(self, filename):
315 self.filename = filename
316
317 def setCopyright(self, c):
318 self.contents['copyright'] = c
319
320 def setHeader(self, h):
321 self.contents['header'] = h
322
323 def setBody(self, b):
324 self.contents['body'] = b
325
326 def setFooter(self, f):
327 self.contents['footer'] = f
328
329 def generate(self):
330 #print("Generate to file %s" % self.filename)
331 with open(self.filename, "w") as f:
332 f.write(self.contents['copyright'])
333 f.write(self.contents['header'])
334 f.write(self.contents['body'])
335 f.write(self.contents['footer'])
336
337# class for writing a wrapper class for structures
338# The wrapper class wraps the structs and includes utility functions for
339# setting/getting member values and displaying the struct data in various formats
340class StructWrapperGen:
341 def __init__(self, in_struct_dict, prefix, out_dir):
342 self.struct_dict = in_struct_dict
343 self.include_headers = []
344 self.api = prefix
345 self.header_filename = os.path.join(out_dir, self.api+"_struct_wrappers.h")
346 self.class_filename = os.path.join(out_dir, self.api+"_struct_wrappers.cpp")
347 self.string_helper_filename = os.path.join(out_dir, self.api+"_struct_string_helper.h")
Tobin Ehlisd49efcb2014-11-25 17:43:26 -0700348 self.string_helper_no_addr_filename = os.path.join(out_dir, self.api+"_struct_string_helper_no_addr.h")
Tobin Ehlis99f88672015-01-10 12:42:41 -0700349 self.string_helper_cpp_filename = os.path.join(out_dir, self.api+"_struct_string_helper_cpp.h")
350 self.string_helper_no_addr_cpp_filename = os.path.join(out_dir, self.api+"_struct_string_helper_no_addr_cpp.h")
Tobin Ehlis14ff0852014-12-17 17:44:50 -0700351 self.validate_helper_filename = os.path.join(out_dir, self.api+"_struct_validate_helper.h")
Tobin Ehlisd49efcb2014-11-25 17:43:26 -0700352 self.no_addr = False
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600353 self.hfg = CommonFileGen(self.header_filename)
354 self.cfg = CommonFileGen(self.class_filename)
355 self.shg = CommonFileGen(self.string_helper_filename)
Tobin Ehlis99f88672015-01-10 12:42:41 -0700356 self.shcppg = CommonFileGen(self.string_helper_cpp_filename)
Tobin Ehlis14ff0852014-12-17 17:44:50 -0700357 self.vhg = CommonFileGen(self.validate_helper_filename)
Tobin Ehlis60354772015-03-12 14:50:40 -0600358 self.size_helper_filename = os.path.join(out_dir, self.api+"_struct_size_helper.h")
Peter Lohrmann4a8d8912015-04-03 11:43:06 -0700359 self.size_helper_c_filename = os.path.join(out_dir, self.api+"_struct_size_helper.c")
Tobin Ehlis60354772015-03-12 14:50:40 -0600360 self.size_helper_gen = CommonFileGen(self.size_helper_filename)
Peter Lohrmann4a8d8912015-04-03 11:43:06 -0700361 self.size_helper_c_gen = CommonFileGen(self.size_helper_c_filename)
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600362 #print(self.header_filename)
363 self.header_txt = ""
364 self.definition_txt = ""
365
366 def set_include_headers(self, include_headers):
367 self.include_headers = include_headers
368
Tobin Ehlisd49efcb2014-11-25 17:43:26 -0700369 def set_no_addr(self, no_addr):
370 self.no_addr = no_addr
371 if self.no_addr:
372 self.shg = CommonFileGen(self.string_helper_no_addr_filename)
Tobin Ehlis99f88672015-01-10 12:42:41 -0700373 self.shcppg = CommonFileGen(self.string_helper_no_addr_cpp_filename)
Tobin Ehlisd49efcb2014-11-25 17:43:26 -0700374 else:
375 self.shg = CommonFileGen(self.string_helper_filename)
Tobin Ehlis99f88672015-01-10 12:42:41 -0700376 self.shcppg = CommonFileGen(self.string_helper_cpp_filename)
Tobin Ehlisd49efcb2014-11-25 17:43:26 -0700377
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600378 # Return class name for given struct name
379 def get_class_name(self, struct_name):
380 class_name = struct_name.strip('_').lower() + "_struct_wrapper"
381 return class_name
382
383 def get_file_list(self):
384 return [os.path.basename(self.header_filename), os.path.basename(self.class_filename), os.path.basename(self.string_helper_filename)]
385
386 # Generate class header file
387 def generateHeader(self):
388 self.hfg.setCopyright(self._generateCopyright())
389 self.hfg.setHeader(self._generateHeader())
390 self.hfg.setBody(self._generateClassDeclaration())
391 self.hfg.setFooter(self._generateFooter())
392 self.hfg.generate()
393
394 # Generate class definition
395 def generateBody(self):
396 self.cfg.setCopyright(self._generateCopyright())
397 self.cfg.setHeader(self._generateCppHeader())
398 self.cfg.setBody(self._generateClassDefinition())
399 self.cfg.setFooter(self._generateFooter())
400 self.cfg.generate()
401
402 # Generate c-style .h file that contains functions for printing structs
403 def generateStringHelper(self):
404 print("Generating struct string helper")
405 self.shg.setCopyright(self._generateCopyright())
406 self.shg.setHeader(self._generateStringHelperHeader())
407 self.shg.setBody(self._generateStringHelperFunctions())
408 self.shg.generate()
409
Tobin Ehlis99f88672015-01-10 12:42:41 -0700410 # Generate cpp-style .h file that contains functions for printing structs
411 def generateStringHelperCpp(self):
412 print("Generating struct string helper cpp")
413 self.shcppg.setCopyright(self._generateCopyright())
414 self.shcppg.setHeader(self._generateStringHelperHeaderCpp())
415 self.shcppg.setBody(self._generateStringHelperFunctionsCpp())
416 self.shcppg.generate()
417
Tobin Ehlis14ff0852014-12-17 17:44:50 -0700418 # Generate c-style .h file that contains functions for printing structs
419 def generateValidateHelper(self):
420 print("Generating struct validate helper")
421 self.vhg.setCopyright(self._generateCopyright())
422 self.vhg.setHeader(self._generateValidateHelperHeader())
423 self.vhg.setBody(self._generateValidateHelperFunctions())
424 self.vhg.generate()
425
Tobin Ehlis60354772015-03-12 14:50:40 -0600426 def generateSizeHelper(self):
427 print("Generating struct size helper")
428 self.size_helper_gen.setCopyright(self._generateCopyright())
429 self.size_helper_gen.setHeader(self._generateSizeHelperHeader())
430 self.size_helper_gen.setBody(self._generateSizeHelperFunctions())
431 self.size_helper_gen.generate()
432
Peter Lohrmann4a8d8912015-04-03 11:43:06 -0700433 def generateSizeHelperC(self):
434 print("Generating struct size helper c")
435 self.size_helper_c_gen.setCopyright(self._generateCopyright())
436 self.size_helper_c_gen.setHeader(self._generateSizeHelperHeaderC())
437 self.size_helper_c_gen.setBody(self._generateSizeHelperFunctionsC())
438 self.size_helper_c_gen.generate()
439
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600440 def _generateCopyright(self):
Peter Lohrmann4a8d8912015-04-03 11:43:06 -0700441 copyright = []
442 copyright.append('/* THIS FILE IS GENERATED. DO NOT EDIT. */');
443 copyright.append('');
444 copyright.append('/*');
445 copyright.append(' * XGL');
446 copyright.append(' *');
447 copyright.append(' * Copyright (C) 2014 LunarG, Inc.');
448 copyright.append(' *');
449 copyright.append(' * Permission is hereby granted, free of charge, to any person obtaining a');
450 copyright.append(' * copy of this software and associated documentation files (the "Software"),');
451 copyright.append(' * to deal in the Software without restriction, including without limitation');
452 copyright.append(' * the rights to use, copy, modify, merge, publish, distribute, sublicense,');
453 copyright.append(' * and/or sell copies of the Software, and to permit persons to whom the');
454 copyright.append(' * Software is furnished to do so, subject to the following conditions:');
455 copyright.append(' *');
456 copyright.append(' * The above copyright notice and this permission notice shall be included');
457 copyright.append(' * in all copies or substantial portions of the Software.');
458 copyright.append(' *');
459 copyright.append(' * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR');
460 copyright.append(' * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,');
461 copyright.append(' * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL');
462 copyright.append(' * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER');
463 copyright.append(' * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING');
464 copyright.append(' * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER');
465 copyright.append(' * DEALINGS IN THE SOFTWARE.');
466 copyright.append(' */');
467 copyright.append('');
468 return "\n".join(copyright)
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600469
470 def _generateCppHeader(self):
471 header = []
472 header.append("//#includes, #defines, globals and such...\n")
Tobin Ehlis33267fd2014-11-10 16:03:19 -0700473 header.append("#include <stdio.h>\n#include <%s>\n#include <%s_enum_string_helper.h>\n" % (os.path.basename(self.header_filename), self.api))
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600474 return "".join(header)
475
476 def _generateClassDefinition(self):
477 class_def = []
478 if 'xgl' == self.api: # Mantle doesn't have pNext to worry about
479 class_def.append(self._generateDynamicPrintFunctions())
Peter Lohrmann49ea1842015-03-30 16:29:56 -0700480 for s in sorted(self.struct_dict):
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600481 class_def.append("\n// %s class definition" % self.get_class_name(s))
482 class_def.append(self._generateConstructorDefinitions(s))
483 class_def.append(self._generateDestructorDefinitions(s))
484 class_def.append(self._generateDisplayDefinitions(s))
485 return "\n".join(class_def)
486
487 def _generateConstructorDefinitions(self, s):
488 con_defs = []
489 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)))
490 # TODO : This is a shallow copy of ptrs
491 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]))
492 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]))
493 return "\n".join(con_defs)
494
495 def _generateDestructorDefinitions(self, s):
496 return "%s::~%s() {}" % (self.get_class_name(s), self.get_class_name(s))
497
498 def _generateDynamicPrintFunctions(self):
499 dp_funcs = []
Mark Lobodzinski17caf572015-01-29 08:55:56 -0600500 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")
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600501 dp_funcs.append(" XGL_STRUCTURE_TYPE sType = ((XGL_APPLICATION_INFO*)pStruct)->sType;\n")
502 dp_funcs.append(" switch (sType)\n {")
503 for e in enum_type_dict:
504 class_num = 0
505 if "_STRUCTURE_TYPE" in e:
506 for v in sorted(enum_type_dict[e]):
507 struct_name = v.replace("_STRUCTURE_TYPE", "")
508 class_name = self.get_class_name(struct_name)
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600509 instance_name = "swc%i" % class_num
510 dp_funcs.append(" case %s:\n {" % (v))
511 dp_funcs.append(" %s %s((%s*)pStruct);" % (class_name, instance_name, struct_name))
512 dp_funcs.append(" %s.set_indent(indent);" % (instance_name))
513 dp_funcs.append(" %s.display_full_txt();" % (instance_name))
514 dp_funcs.append(" }")
515 dp_funcs.append(" break;")
516 class_num += 1
517 dp_funcs.append(" }")
518 dp_funcs.append("}\n")
519 return "\n".join(dp_funcs)
520
Tobin Ehlis14ff0852014-12-17 17:44:50 -0700521 def _get_func_name(self, struct, mid_str):
522 return "%s_%s_%s" % (self.api, mid_str, struct.lower().strip("_"))
523
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600524 def _get_sh_func_name(self, struct):
Tobin Ehlis14ff0852014-12-17 17:44:50 -0700525 return self._get_func_name(struct, 'print')
526
527 def _get_vh_func_name(self, struct):
528 return self._get_func_name(struct, 'validate')
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600529
Tobin Ehlis60354772015-03-12 14:50:40 -0600530 def _get_size_helper_func_name(self, struct):
531 return self._get_func_name(struct, 'size')
532
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600533 # Return elements to create formatted string for given struct member
534 def _get_struct_print_formatted(self, struct_member, pre_var_name="prefix", postfix = "\\n", struct_var_name="pStruct", struct_ptr=True, print_array=False):
535 struct_op = "->"
536 if not struct_ptr:
537 struct_op = "."
538 member_name = struct_member['name']
539 print_type = "p"
540 cast_type = ""
541 member_post = ""
542 array_index = ""
543 member_print_post = ""
Tobin Ehlisb0497852015-02-11 14:24:02 -0700544 print_delimiter = "%"
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700545 if struct_member['array'] and 'char' in struct_member['type'].lower(): # just print char array as string
546 if member_name.startswith('pp'): # TODO : Only printing first element of dynam array of char* for now
547 member_post = "[0]"
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600548 print_type = "s"
549 print_array = False
550 elif struct_member['array'] and not print_array:
551 # Just print base address of array when not full print_array
552 cast_type = "(void*)"
553 elif is_type(struct_member['type'], 'enum'):
554 cast_type = "string_%s" % struct_member['type']
Jon Ashburnfe6113c2015-01-09 09:11:44 -0700555 if struct_member['ptr']:
556 struct_var_name = "*" + struct_var_name
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600557 print_type = "s"
558 elif is_type(struct_member['type'], 'struct'): # print struct address for now
559 cast_type = "(void*)"
560 if not struct_member['ptr']:
561 cast_type = "(void*)&"
Tobin Ehlis7e65d752015-01-15 17:51:52 -0700562 elif 'bool' in struct_member['type']:
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600563 print_type = "s"
564 member_post = ' ? "TRUE" : "FALSE"'
Tobin Ehlis7e65d752015-01-15 17:51:52 -0700565 elif 'float' in struct_member['type']:
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600566 print_type = "f"
Tobin Ehlis7e65d752015-01-15 17:51:52 -0700567 elif 'uint64' in struct_member['type']:
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600568 print_type = "lu"
Tobin Ehlis7e65d752015-01-15 17:51:52 -0700569 elif 'uint8' in struct_member['type']:
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600570 print_type = "hu"
Tobin Ehlis7e65d752015-01-15 17:51:52 -0700571 elif '_size' in struct_member['type']:
Tobin Ehlisb0497852015-02-11 14:24:02 -0700572 print_type = '" PRINTF_SIZE_T_SPECIFIER "'
573 print_delimiter = ""
Tobin Ehlis7e65d752015-01-15 17:51:52 -0700574 elif True in [ui_str.lower() in struct_member['type'].lower() for ui_str in ['uint', '_FLAGS', '_SAMPLE_MASK']]:
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600575 print_type = "u"
Tobin Ehlis7e65d752015-01-15 17:51:52 -0700576 elif 'int' in struct_member['type']:
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600577 print_type = "i"
578 elif struct_member['ptr']:
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600579 pass
580 else:
581 #print("Unhandled struct type: %s" % struct_member['type'])
582 cast_type = "(void*)"
583 if print_array and struct_member['array']:
584 member_print_post = "[%u]"
585 array_index = " i,"
586 member_post = "[i]"
Tobin Ehlisb0497852015-02-11 14:24:02 -0700587 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 Ehlis6442dca2014-10-22 15:13:53 -0600588 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 Ehlisd49efcb2014-11-25 17:43:26 -0700589 if self.no_addr and "p" == print_type:
590 print_out = "%%s%s%s = addr\\n" % (member_name, member_print_post) # section of print that goes inside of quotes
591 print_arg = ", %s" % (pre_var_name)
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600592 return (print_out, print_arg)
593
594 def _generateStringHelperFunctions(self):
595 sh_funcs = []
Tobin Ehlis5a487e52014-11-11 12:28:12 -0700596 # We do two passes, first pass just generates prototypes for all the functsions
Tobin Ehlis291cd702015-01-20 09:48:48 -0700597 for s in sorted(self.struct_dict):
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700598 sh_funcs.append('char* %s(const %s* pStruct, const char* prefix);' % (self._get_sh_func_name(s), typedef_fwd_dict[s]))
599 sh_funcs.append('')
600 sh_funcs.append('#if defined(_WIN32)')
601 sh_funcs.append('// Microsoft did not implement C99 in Visual Studio; but started adding it with')
602 sh_funcs.append('// VS2013. However, VS2013 still did not have snprintf(). The following is a')
603 sh_funcs.append('// work-around.')
604 sh_funcs.append('#define snprintf _snprintf')
605 sh_funcs.append('#endif // _WIN32\n')
Peter Lohrmann49ea1842015-03-30 16:29:56 -0700606 for s in sorted(self.struct_dict):
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600607 p_out = ""
608 p_args = ""
Tobin Ehlis5a487e52014-11-11 12:28:12 -0700609 stp_list = [] # stp == "struct to print" a list of structs for this API call that should be printed as structs
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700610 # This pre-pass flags embedded structs and pNext
Tobin Ehlis291cd702015-01-20 09:48:48 -0700611 for m in sorted(self.struct_dict[s]):
Tobin Ehlis5a487e52014-11-11 12:28:12 -0700612 if 'pNext' == self.struct_dict[s][m]['name'] or is_type(self.struct_dict[s][m]['type'], 'struct'):
613 stp_list.append(self.struct_dict[s][m])
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700614 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]))
615 sh_funcs.append(" size_t len;")
Tobin Ehlis5a487e52014-11-11 12:28:12 -0700616 num_stps = len(stp_list);
617 total_strlen_str = ''
618 if 0 != num_stps:
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700619 sh_funcs.append(" char* tmpStr;")
620 sh_funcs.append(' char* extra_indent = (char*)malloc(strlen(prefix) + 3);')
621 sh_funcs.append(' strcpy(extra_indent, " ");')
622 sh_funcs.append(' strncat(extra_indent, prefix, strlen(prefix));')
623 sh_funcs.append(' char* stp_strs[%i];' % num_stps)
Tobin Ehlis5a487e52014-11-11 12:28:12 -0700624 for index in range(num_stps):
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700625 # If it's an array, print all of the elements
626 # If it's a ptr, print thing it's pointing to
627 # Non-ptr struct case. Print the struct using its address
628 struct_deref = '&'
629 if 1 < stp_list[index]['full_type'].count('*'):
630 struct_deref = ''
Tobin Ehlis5a487e52014-11-11 12:28:12 -0700631 if (stp_list[index]['ptr']):
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700632 sh_funcs.append(' if (pStruct->%s) {' % stp_list[index]['name'])
Tobin Ehlis5a487e52014-11-11 12:28:12 -0700633 if 'pNext' == stp_list[index]['name']:
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700634 sh_funcs.append(' tmpStr = dynamic_display((void*)pStruct->pNext, prefix);')
635 sh_funcs.append(' len = 256+strlen(tmpStr);')
636 sh_funcs.append(' stp_strs[%i] = (char*)malloc(len);' % index)
Tobin Ehlisd49efcb2014-11-25 17:43:26 -0700637 if self.no_addr:
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700638 sh_funcs.append(' snprintf(stp_strs[%i], len, " %%spNext (addr)\\n%%s", prefix, tmpStr);' % index)
Tobin Ehlisd49efcb2014-11-25 17:43:26 -0700639 else:
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700640 sh_funcs.append(' snprintf(stp_strs[%i], len, " %%spNext (%%p)\\n%%s", prefix, (void*)pStruct->pNext, tmpStr);' % index)
641 sh_funcs.append(' free(tmpStr);')
Tobin Ehlis5a487e52014-11-11 12:28:12 -0700642 else:
Tobin Ehlisb8013a22015-02-26 12:57:08 -0700643 if stp_list[index]['name'] in ['pImageViews', 'pBufferViews']:
644 # TODO : This is a quick hack to handle these arrays of ptrs
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700645 sh_funcs.append(' tmpStr = %s(pStruct->%s[0], extra_indent);' % (self._get_sh_func_name(stp_list[index]['type']), stp_list[index]['name']))
Tobin Ehlisb8013a22015-02-26 12:57:08 -0700646 else:
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700647 sh_funcs.append(' tmpStr = %s(pStruct->%s, extra_indent);' % (self._get_sh_func_name(stp_list[index]['type']), stp_list[index]['name']))
648 sh_funcs.append(' len = 256+strlen(tmpStr)+strlen(prefix);')
649 sh_funcs.append(' stp_strs[%i] = (char*)malloc(len);' % (index))
Tobin Ehlisd49efcb2014-11-25 17:43:26 -0700650 if self.no_addr:
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700651 sh_funcs.append(' snprintf(stp_strs[%i], len, " %%s%s (addr)\\n%%s", prefix, tmpStr);' % (index, stp_list[index]['name']))
Tobin Ehlisd49efcb2014-11-25 17:43:26 -0700652 else:
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700653 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']))
654 sh_funcs.append(' }')
655 sh_funcs.append(" else\n stp_strs[%i] = \"\";" % (index))
656 elif stp_list[index]['array']:
657 sh_funcs.append(' tmpStr = %s(&pStruct->%s[0], extra_indent);' % (self._get_sh_func_name(stp_list[index]['type']), stp_list[index]['name']))
658 sh_funcs.append(' len = 256+strlen(tmpStr);')
659 sh_funcs.append(' stp_strs[%i] = (char*)malloc(len);' % (index))
Tobin Ehlisd49efcb2014-11-25 17:43:26 -0700660 if self.no_addr:
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700661 sh_funcs.append(' snprintf(stp_strs[%i], len, " %%s%s[0] (addr)\\n%%s", prefix, tmpStr);' % (index, stp_list[index]['name']))
Tobin Ehlisd49efcb2014-11-25 17:43:26 -0700662 else:
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700663 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 Ehlis5a487e52014-11-11 12:28:12 -0700664 else:
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700665 sh_funcs.append(' tmpStr = %s(&pStruct->%s, extra_indent);' % (self._get_sh_func_name(stp_list[index]['type']), stp_list[index]['name']))
666 sh_funcs.append(' len = 256+strlen(tmpStr);')
667 sh_funcs.append(' stp_strs[%i] = (char*)malloc(len);' % (index))
Tobin Ehlisd49efcb2014-11-25 17:43:26 -0700668 if self.no_addr:
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700669 sh_funcs.append(' snprintf(stp_strs[%i], len, " %%s%s (addr)\\n%%s", prefix, tmpStr);' % (index, stp_list[index]['name']))
Tobin Ehlisd49efcb2014-11-25 17:43:26 -0700670 else:
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700671 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 Ehlis5a487e52014-11-11 12:28:12 -0700672 total_strlen_str += 'strlen(stp_strs[%i]) + ' % index
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700673 sh_funcs.append(' len = %ssizeof(char)*1024;' % (total_strlen_str))
674 sh_funcs.append(' str = (char*)malloc(len);')
Courtney Goeltzenleuchterbbd0a362014-12-01 09:31:17 -0700675 sh_funcs.append(' snprintf(str, len, "')
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600676 for m in sorted(self.struct_dict[s]):
677 (p_out1, p_args1) = self._get_struct_print_formatted(self.struct_dict[s][m])
678 p_out += p_out1
679 p_args += p_args1
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600680 p_out += '"'
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700681 p_args += ");"
682 sh_funcs[-1] = '%s%s%s' % (sh_funcs[-1], p_out, p_args)
Tobin Ehlis5a487e52014-11-11 12:28:12 -0700683 if 0 != num_stps:
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700684 sh_funcs.append(' for (int32_t stp_index = %i; stp_index >= 0; stp_index--) {' % (num_stps-1))
685 sh_funcs.append(' if (0 < strlen(stp_strs[stp_index])) {')
686 sh_funcs.append(' strncat(str, stp_strs[stp_index], strlen(stp_strs[stp_index]));')
687 sh_funcs.append(' free(stp_strs[stp_index]);')
688 sh_funcs.append(' }')
689 sh_funcs.append(' }')
690 sh_funcs.append(' free(extra_indent);')
691 sh_funcs.append(" return str;\n}")
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600692 # Add function to dynamically print out unknown struct
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700693 sh_funcs.append("char* dynamic_display(const void* pStruct, const char* prefix)\n{")
694 sh_funcs.append(" // Cast to APP_INFO ptr initially just to pull sType off struct")
695 sh_funcs.append(" if (pStruct == NULL) {")
696 sh_funcs.append(" return NULL;")
697 sh_funcs.append(" }")
698 sh_funcs.append(" XGL_STRUCTURE_TYPE sType = ((XGL_APPLICATION_INFO*)pStruct)->sType;")
699 sh_funcs.append(' char indent[100];\n strcpy(indent, " ");\n strcat(indent, prefix);')
700 sh_funcs.append(" switch (sType)\n {")
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600701 for e in enum_type_dict:
702 if "_STRUCTURE_TYPE" in e:
703 for v in sorted(enum_type_dict[e]):
704 struct_name = v.replace("_STRUCTURE_TYPE", "")
705 print_func_name = self._get_sh_func_name(struct_name)
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700706 sh_funcs.append(' case %s:\n {' % (v))
707 sh_funcs.append(' return %s((%s*)pStruct, indent);' % (print_func_name, struct_name))
708 sh_funcs.append(' }')
709 sh_funcs.append(' break;')
710 sh_funcs.append(" default:")
711 sh_funcs.append(" return NULL;")
712 sh_funcs.append(" }")
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600713 sh_funcs.append("}")
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700714 return "\n".join(sh_funcs)
Tobin Ehlis99f88672015-01-10 12:42:41 -0700715
716 def _generateStringHelperFunctionsCpp(self):
717 # declare str & tmp str
718 # declare array of stringstreams for every struct ptr in current struct
719 # declare array of stringstreams for every non-string element in current struct
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700720 # For every struct ptr, if non-Null, then set its string, else set to NULL str
721 # For every non-string element, set its string stream
Tobin Ehlis99f88672015-01-10 12:42:41 -0700722 # create and return final string
723 sh_funcs = []
724 # First generate prototypes for every struct
Tobin Ehlis291cd702015-01-20 09:48:48 -0700725 for s in sorted(self.struct_dict):
Tobin Ehlis99f88672015-01-10 12:42:41 -0700726 sh_funcs.append('string %s(const %s* pStruct, const string prefix);' % (self._get_sh_func_name(s), typedef_fwd_dict[s]))
727 sh_funcs.append('\n')
Tobin Ehlis291cd702015-01-20 09:48:48 -0700728 for s in sorted(self.struct_dict):
Tobin Ehlis99f88672015-01-10 12:42:41 -0700729 num_non_enum_elems = [is_type(self.struct_dict[s][elem]['type'], 'enum') for elem in self.struct_dict[s]].count(False)
730 stp_list = [] # stp == "struct to print" a list of structs for this API call that should be printed as structs
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700731 # This pre-pass flags embedded structs and pNext
Tobin Ehlis291cd702015-01-20 09:48:48 -0700732 for m in sorted(self.struct_dict[s]):
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700733 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 Ehlis99f88672015-01-10 12:42:41 -0700734 stp_list.append(self.struct_dict[s][m])
735 sh_funcs.append('string %s(const %s* pStruct, const string prefix)\n{' % (self._get_sh_func_name(s), typedef_fwd_dict[s]))
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700736 indent = ' '
737 sh_funcs.append('%sstring final_str;' % (indent))
738 sh_funcs.append('%sstring tmp_str;' % (indent))
739 sh_funcs.append('%sstring extra_indent = " " + prefix;' % (indent))
Tobin Ehlis291cd702015-01-20 09:48:48 -0700740 if (0 != num_non_enum_elems):
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700741 sh_funcs.append('%sstringstream ss[%u];' % (indent, num_non_enum_elems))
Tobin Ehlis99f88672015-01-10 12:42:41 -0700742 num_stps = len(stp_list)
743 # First generate code for any embedded structs
744 if 0 < num_stps:
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700745 sh_funcs.append('%sstring stp_strs[%u];' % (indent, num_stps))
Tobin Ehlis99f88672015-01-10 12:42:41 -0700746 idx_ss_decl = False # Make sure to only decl this once
747 for index in range(num_stps):
748 addr_char = '&'
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700749 if 1 < stp_list[index]['full_type'].count('*'):
Tobin Ehlis99f88672015-01-10 12:42:41 -0700750 addr_char = ''
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700751 if (stp_list[index]['array']):
752 if stp_list[index]['dyn_array']:
753 array_count = 'pStruct->%s' % (stp_list[index]['array_size'])
754 else:
755 array_count = '%s' % (stp_list[index]['array_size'])
756 sh_funcs.append('%sstp_strs[%u] = "";' % (indent, index))
757 if not idx_ss_decl:
758 sh_funcs.append('%sstringstream index_ss;' % (indent))
759 idx_ss_decl = True
760 sh_funcs.append('%sfor (uint32_t i = 0; i < %s; i++) {' % (indent, array_count))
761 indent = ' '
762 sh_funcs.append('%sindex_ss.str("");' % (indent))
763 sh_funcs.append('%sindex_ss << i;' % (indent))
764 if not is_type(stp_list[index]['type'], 'struct'):
765 addr_char = ''
766 sh_funcs.append('%sss[%u] << %spStruct->%s[i];' % (indent, index, addr_char, stp_list[index]['name']))
767 sh_funcs.append('%sstp_strs[%u] += " " + prefix + "%s[" + index_ss.str() + "] = " + ss[%u].str() + "\\n";' % (indent, index, stp_list[index]['name'], index))
768 else:
769 sh_funcs.append('%sss[%u] << %spStruct->%s[i];' % (indent, index, addr_char, stp_list[index]['name']))
770 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']))
771 if self.no_addr:
772 sh_funcs.append('%sstp_strs[%u] += " " + prefix + "%s[" + index_ss.str() + "] (addr)\\n" + tmp_str;' % (indent, index, stp_list[index]['name']))
773 else:
774 sh_funcs.append('%sstp_strs[%u] += " " + prefix + "%s[" + index_ss.str() + "] (" + ss[%u].str() + ")\\n" + tmp_str;' % (indent, index, stp_list[index]['name'], index))
775 sh_funcs.append('%sss[%u].str("");' % (indent, index))
776 indent = ' '
777 sh_funcs.append('%s}' % (indent))
778 elif (stp_list[index]['ptr']):
Tobin Ehlis99f88672015-01-10 12:42:41 -0700779 sh_funcs.append(' if (pStruct->%s) {' % stp_list[index]['name'])
780 if 'pNext' == stp_list[index]['name']:
Mark Lobodzinski17caf572015-01-29 08:55:56 -0600781 sh_funcs.append(' tmp_str = dynamic_display((void*)pStruct->pNext, prefix);')
Tobin Ehlis99f88672015-01-10 12:42:41 -0700782 else:
Tobin Ehlisb8013a22015-02-26 12:57:08 -0700783 if stp_list[index]['name'] in ['pImageViews', 'pBufferViews']:
784 # TODO : This is a quick hack to handle these arrays of ptrs
785 sh_funcs.append(' tmp_str = %s(pStruct->%s[0], extra_indent);' % (self._get_sh_func_name(stp_list[index]['type']), stp_list[index]['name']))
786 else:
787 sh_funcs.append(' tmp_str = %s(pStruct->%s, extra_indent);' % (self._get_sh_func_name(stp_list[index]['type']), stp_list[index]['name']))
Tobin Ehlis99f88672015-01-10 12:42:41 -0700788 sh_funcs.append(' ss[%u] << %spStruct->%s;' % (index, addr_char, stp_list[index]['name']))
789 if self.no_addr:
790 sh_funcs.append(' stp_strs[%u] = " " + prefix + "%s (addr)\\n" + tmp_str;' % (index, stp_list[index]['name']))
791 else:
792 sh_funcs.append(' stp_strs[%u] = " " + prefix + "%s (" + ss[%u].str() + ")\\n" + tmp_str;' % (index, stp_list[index]['name'], index))
793 sh_funcs.append(' ss[%u].str("");' % (index))
794 sh_funcs.append(' }')
795 sh_funcs.append(' else')
796 sh_funcs.append(' stp_strs[%u] = "";' % index)
Tobin Ehlis99f88672015-01-10 12:42:41 -0700797 else:
798 sh_funcs.append(' tmp_str = %s(&pStruct->%s, extra_indent);' % (self._get_sh_func_name(stp_list[index]['type']), stp_list[index]['name']))
799 sh_funcs.append(' ss[%u] << %spStruct->%s;' % (index, addr_char, stp_list[index]['name']))
800 if self.no_addr:
801 sh_funcs.append(' stp_strs[%u] = " " + prefix + "%s (addr)\\n" + tmp_str;' % (index, stp_list[index]['name']))
802 else:
803 sh_funcs.append(' stp_strs[%u] = " " + prefix + "%s (" + ss[%u].str() + ")\\n" + tmp_str;' % (index, stp_list[index]['name'], index))
804 sh_funcs.append(' ss[%u].str("");' % index)
805 # Now print non-enum data members
806 index = 0
807 final_str = ''
808 for m in sorted(self.struct_dict[s]):
Tobin Ehlis7e65d752015-01-15 17:51:52 -0700809 deref = ''
Tobin Ehlis99f88672015-01-10 12:42:41 -0700810 if not is_type(self.struct_dict[s][m]['type'], 'enum'):
811 if is_type(self.struct_dict[s][m]['type'], 'struct') and not self.struct_dict[s][m]['ptr']:
812 if self.no_addr:
813 sh_funcs.append(' ss[%u].str("addr");' % (index))
814 else:
815 sh_funcs.append(' ss[%u] << &pStruct->%s;' % (index, self.struct_dict[s][m]['name']))
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700816 elif 'bool' in self.struct_dict[s][m]['type'].lower():
Tobin Ehlis99f88672015-01-10 12:42:41 -0700817 sh_funcs.append(' ss[%u].str(pStruct->%s ? "TRUE" : "FALSE");' % (index, self.struct_dict[s][m]['name']))
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700818 elif 'uint8' in self.struct_dict[s][m]['type'].lower():
Tobin Ehlis99f88672015-01-10 12:42:41 -0700819 sh_funcs.append(' ss[%u] << (uint32_t)pStruct->%s;' % (index, self.struct_dict[s][m]['name']))
820 else:
821 (po, pa) = self._get_struct_print_formatted(self.struct_dict[s][m])
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700822 if "addr" in po: # or self.struct_dict[s][m]['ptr']:
Tobin Ehlis99f88672015-01-10 12:42:41 -0700823 sh_funcs.append(' ss[%u].str("addr");' % (index))
824 else:
825 sh_funcs.append(' ss[%u] << pStruct->%s;' % (index, self.struct_dict[s][m]['name']))
826 value_print = 'ss[%u].str()' % index
827 index += 1
828 else:
Tobin Ehlis7e65d752015-01-15 17:51:52 -0700829 if self.struct_dict[s][m]['ptr']:
830 deref = '*'
831 value_print = 'string_%s(%spStruct->%s)' % (self.struct_dict[s][m]['type'], deref, self.struct_dict[s][m]['name'])
Tobin Ehlis99f88672015-01-10 12:42:41 -0700832 final_str += ' + prefix + "%s = " + %s + "\\n"' % (self.struct_dict[s][m]['name'], value_print)
833 final_str = final_str[3:] # strip off the initial ' + '
Tobin Ehlis5178bd72015-03-06 10:38:25 -0700834 if 0 != num_stps: # Append data for any embedded structs
Tobin Ehlis99f88672015-01-10 12:42:41 -0700835 final_str += " + %s" % " + ".join(['stp_strs[%u]' % n for n in reversed(range(num_stps))])
836 sh_funcs.append(' final_str = %s;' % final_str)
837 sh_funcs.append(' return final_str;\n}')
Tobin Ehlis291cd702015-01-20 09:48:48 -0700838 # Add function to return a string value for input void*
839 sh_funcs.append("string string_convert_helper(const void* toString, const string prefix)\n{")
840 sh_funcs.append(" stringstream ss;")
841 sh_funcs.append(' ss << toString;')
842 sh_funcs.append(' string final_str = prefix + ss.str();')
843 sh_funcs.append(" return final_str;")
844 sh_funcs.append("}")
Tobin Ehlis99f88672015-01-10 12:42:41 -0700845 # Add function to dynamically print out unknown struct
Mark Lobodzinski17caf572015-01-29 08:55:56 -0600846 sh_funcs.append("string dynamic_display(const void* pStruct, const string prefix)\n{")
Tobin Ehlis99f88672015-01-10 12:42:41 -0700847 sh_funcs.append(" // Cast to APP_INFO ptr initially just to pull sType off struct")
Ian Elliott82800022015-02-25 17:40:38 -0700848 sh_funcs.append(" if (pStruct == NULL) {\n")
Jon Ashburn62a327c2015-02-25 12:45:23 -0700849 sh_funcs.append(" return NULL;")
Ian Elliott82800022015-02-25 17:40:38 -0700850 sh_funcs.append(" }\n")
Tobin Ehlis99f88672015-01-10 12:42:41 -0700851 sh_funcs.append(" XGL_STRUCTURE_TYPE sType = ((XGL_APPLICATION_INFO*)pStruct)->sType;")
852 sh_funcs.append(' string indent = " ";')
853 sh_funcs.append(' indent += prefix;')
854 sh_funcs.append(" switch (sType)\n {")
855 for e in enum_type_dict:
856 if "_STRUCTURE_TYPE" in e:
857 for v in sorted(enum_type_dict[e]):
858 struct_name = v.replace("_STRUCTURE_TYPE", "")
859 print_func_name = self._get_sh_func_name(struct_name)
Tobin Ehlis99f88672015-01-10 12:42:41 -0700860 sh_funcs.append(' case %s:\n {' % (v))
861 sh_funcs.append(' return %s((%s*)pStruct, indent);' % (print_func_name, struct_name))
862 sh_funcs.append(' }')
863 sh_funcs.append(' break;')
864 sh_funcs.append(" default:")
865 sh_funcs.append(" return NULL;")
866 sh_funcs.append(" }")
867 sh_funcs.append("}")
868 return "\n".join(sh_funcs)
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600869
870 def _genStructMemberPrint(self, member, s, array, struct_array):
871 (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)
872 extra_indent = ""
873 if array:
874 extra_indent = " "
875 if is_type(self.struct_dict[s][member]['type'], 'struct'): # print struct address for now
876 struct_array.insert(0, self.struct_dict[s][member])
877 elif self.struct_dict[s][member]['ptr']:
Tobin Ehlis7e65d752015-01-15 17:51:52 -0700878 # Special case for void* named "pNext"
879 if "void" in self.struct_dict[s][member]['type'] and "pNext" == self.struct_dict[s][member]['name']:
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600880 struct_array.insert(0, self.struct_dict[s][member])
881 return (' %sprintf("%%*s %s", m_indent, ""%s);' % (extra_indent, p_out, p_arg), struct_array)
882
883 def _generateDisplayDefinitions(self, s):
884 disp_def = []
885 struct_array = []
886 # Single-line struct print function
887 disp_def.append("// Output 'structname = struct_address' on a single line")
888 disp_def.append("void %s::display_single_txt()\n{" % self.get_class_name(s))
889 disp_def.append(' printf(" %%*s%s = %%p", m_indent, "", (void*)m_origStructAddr);' % typedef_fwd_dict[s])
890 disp_def.append("}\n")
891 # Private helper function to print struct members
892 disp_def.append("// Private helper function that displays the members of the wrapped struct")
893 disp_def.append("void %s::display_struct_members()\n{" % self.get_class_name(s))
894 i_declared = False
895 for member in sorted(self.struct_dict[s]):
896 # TODO : Need to display each member based on its type
Mark Lobodzinski17caf572015-01-29 08:55:56 -0600897 # TODO : Need to handle pNext which are structs, but of void* type
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600898 # Can grab struct type off of header of struct pointed to
899 # TODO : Handle Arrays
900 if self.struct_dict[s][member]['array']:
901 # Create for loop to print each element of array
902 if not i_declared:
903 disp_def.append(' uint32_t i;')
904 i_declared = True
905 disp_def.append(' for (i = 0; i<%s; i++) {' % self.struct_dict[s][member]['array_size'])
906 (return_str, struct_array) = self._genStructMemberPrint(member, s, True, struct_array)
907 disp_def.append(return_str)
908 disp_def.append(' }')
909 else:
910 (return_str, struct_array) = self._genStructMemberPrint(member, s, False, struct_array)
911 disp_def.append(return_str)
912 disp_def.append("}\n")
913 i_declared = False
914 # Basic print function to display struct members
915 disp_def.append("// Output all struct elements, each on their own line")
916 disp_def.append("void %s::display_txt()\n{" % self.get_class_name(s))
917 disp_def.append(' printf("%%*s%s struct contents at %%p:\\n", m_indent, "", (void*)m_origStructAddr);' % typedef_fwd_dict[s])
918 disp_def.append(' this->display_struct_members();')
919 disp_def.append("}\n")
920 # Advanced print function to display current struct and contents of any pointed-to structs
921 disp_def.append("// Output all struct elements, and for any structs pointed to, print complete contents")
922 disp_def.append("void %s::display_full_txt()\n{" % self.get_class_name(s))
923 disp_def.append(' printf("%%*s%s struct contents at %%p:\\n", m_indent, "", (void*)m_origStructAddr);' % typedef_fwd_dict[s])
924 disp_def.append(' this->display_struct_members();')
925 class_num = 0
926 # TODO : Need to handle arrays of structs here
927 for ms in struct_array:
928 swc_name = "class%s" % str(class_num)
929 if ms['array']:
930 if not i_declared:
931 disp_def.append(' uint32_t i;')
932 i_declared = True
933 disp_def.append(' for (i = 0; i<%s; i++) {' % ms['array_size'])
934 #disp_def.append(" if (m_struct.%s[i]) {" % (ms['name']))
935 disp_def.append(" %s %s(&(m_struct.%s[i]));" % (self.get_class_name(ms['type']), swc_name, ms['name']))
936 disp_def.append(" %s.set_indent(m_indent + 4);" % (swc_name))
937 disp_def.append(" %s.display_full_txt();" % (swc_name))
938 #disp_def.append(' }')
939 disp_def.append(' }')
940 elif 'pNext' == ms['name']:
941 # Need some code trickery here
942 # I'm thinking have a generated function that takes pNext ptr value
943 # then it checks sType and in large switch statement creates appropriate
944 # wrapper class type and then prints contents
945 disp_def.append(" if (m_struct.%s) {" % (ms['name']))
946 #disp_def.append(' printf("%*s This is where we would call dynamic print function\\n", m_indent, "");')
947 disp_def.append(' dynamic_display_full_txt(m_struct.%s, m_indent);' % (ms['name']))
948 disp_def.append(" }")
949 else:
950 if ms['ptr']:
951 disp_def.append(" if (m_struct.%s) {" % (ms['name']))
952 disp_def.append(" %s %s(m_struct.%s);" % (self.get_class_name(ms['type']), swc_name, ms['name']))
953 else:
954 disp_def.append(" if (&m_struct.%s) {" % (ms['name']))
955 disp_def.append(" %s %s(&m_struct.%s);" % (self.get_class_name(ms['type']), swc_name, ms['name']))
956 disp_def.append(" %s.set_indent(m_indent + 4);" % (swc_name))
957 disp_def.append(" %s.display_full_txt();\n }" % (swc_name))
958 class_num += 1
959 disp_def.append("}\n")
960 return "\n".join(disp_def)
961
962 def _generateStringHelperHeader(self):
963 header = []
964 header.append("//#includes, #defines, globals and such...\n")
965 for f in self.include_headers:
Tobin Ehlis33267fd2014-11-10 16:03:19 -0700966 if 'xgl_enum_string_helper' not in f:
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600967 header.append("#include <%s>\n" % f)
Tobin Ehlis5a487e52014-11-11 12:28:12 -0700968 header.append('#include "xgl_enum_string_helper.h"\n\n// Function Prototypes\n')
Mark Lobodzinski17caf572015-01-29 08:55:56 -0600969 header.append("char* dynamic_display(const void* pStruct, const char* prefix);\n")
Tobin Ehlis6442dca2014-10-22 15:13:53 -0600970 return "".join(header)
Tobin Ehlis99f88672015-01-10 12:42:41 -0700971
972 def _generateStringHelperHeaderCpp(self):
973 header = []
974 header.append("//#includes, #defines, globals and such...\n")
975 for f in self.include_headers:
976 if 'xgl_enum_string_helper' not in f:
977 header.append("#include <%s>\n" % f)
978 header.append('#include "xgl_enum_string_helper.h"\n')
979 header.append('using namespace std;\n\n// Function Prototypes\n')
Mark Lobodzinski17caf572015-01-29 08:55:56 -0600980 header.append("string dynamic_display(const void* pStruct, const string prefix);\n")
Tobin Ehlis99f88672015-01-10 12:42:41 -0700981 return "".join(header)
982
Tobin Ehlis14ff0852014-12-17 17:44:50 -0700983 def _generateValidateHelperFunctions(self):
984 sh_funcs = []
985 # We do two passes, first pass just generates prototypes for all the functsions
Peter Lohrmann49ea1842015-03-30 16:29:56 -0700986 for s in sorted(self.struct_dict):
Tobin Ehlis14ff0852014-12-17 17:44:50 -0700987 sh_funcs.append('uint32_t %s(const %s* pStruct);' % (self._get_vh_func_name(s), typedef_fwd_dict[s]))
988 sh_funcs.append('\n')
Peter Lohrmann49ea1842015-03-30 16:29:56 -0700989 for s in sorted(self.struct_dict):
Tobin Ehlis14ff0852014-12-17 17:44:50 -0700990 sh_funcs.append('uint32_t %s(const %s* pStruct)\n{' % (self._get_vh_func_name(s), typedef_fwd_dict[s]))
991 for m in sorted(self.struct_dict[s]):
Tobin Ehlis7e65d752015-01-15 17:51:52 -0700992 # TODO : Need to handle arrays of enums like in XGL_RENDER_PASS_CREATE_INFO struct
993 if is_type(self.struct_dict[s][m]['type'], 'enum') and not self.struct_dict[s][m]['ptr']:
Tobin Ehlis14ff0852014-12-17 17:44:50 -0700994 sh_funcs.append(' if (!validate_%s(pStruct->%s))\n return 0;' % (self.struct_dict[s][m]['type'], self.struct_dict[s][m]['name']))
Jon Ashburn27e02a62015-01-12 15:46:51 -0700995 # TODO : Need a little refinement to this code to make sure type of struct matches expected input (ptr, const...)
Tobin Ehlisce12ad62014-12-18 09:29:58 -0700996 if is_type(self.struct_dict[s][m]['type'], 'struct'):
997 if (self.struct_dict[s][m]['ptr']):
Tobin Ehlisf4a3ac52015-02-24 15:39:04 -0700998 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 Ehlisce12ad62014-12-18 09:29:58 -0700999 else:
1000 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 Ehlis14ff0852014-12-17 17:44:50 -07001001 sh_funcs.append(" return 1;\n}")
1002
1003 return "\n".join(sh_funcs)
1004
1005 def _generateValidateHelperHeader(self):
1006 header = []
1007 header.append("//#includes, #defines, globals and such...\n")
1008 for f in self.include_headers:
1009 if 'xgl_enum_validate_helper' not in f:
1010 header.append("#include <%s>\n" % f)
1011 header.append('#include "xgl_enum_validate_helper.h"\n\n// Function Prototypes\n')
Mark Lobodzinski17caf572015-01-29 08:55:56 -06001012 #header.append("char* dynamic_display(const void* pStruct, const char* prefix);\n")
Tobin Ehlis14ff0852014-12-17 17:44:50 -07001013 return "".join(header)
1014
Tobin Ehlis60354772015-03-12 14:50:40 -06001015 def _generateSizeHelperFunctions(self):
1016 sh_funcs = []
Peter Lohrmann4a8d8912015-04-03 11:43:06 -07001017 # just generates prototypes for all the functions
Peter Lohrmann49ea1842015-03-30 16:29:56 -07001018 for s in sorted(self.struct_dict):
Tobin Ehlis60354772015-03-12 14:50:40 -06001019 sh_funcs.append('size_t %s(const %s* pStruct);' % (self._get_size_helper_func_name(s), typedef_fwd_dict[s]))
Peter Lohrmann4a8d8912015-04-03 11:43:06 -07001020 return "\n".join(sh_funcs)
1021
1022
1023 def _generateSizeHelperFunctionsC(self):
1024 sh_funcs = []
1025 # generate function definitions
Peter Lohrmann49ea1842015-03-30 16:29:56 -07001026 for s in sorted(self.struct_dict):
Peter Lohrmann4a8d8912015-04-03 11:43:06 -07001027 skip_list = [] # Used when struct elements need to be skipped b/c size already accounted for
Tobin Ehlis60354772015-03-12 14:50:40 -06001028 sh_funcs.append('size_t %s(const %s* pStruct)\n{' % (self._get_size_helper_func_name(s), typedef_fwd_dict[s]))
1029 indent = ' '
1030 sh_funcs.append('%ssize_t structSize = 0;' % (indent))
1031 sh_funcs.append('%sif (pStruct) {' % (indent))
1032 indent = ' '
1033 sh_funcs.append('%sstructSize = sizeof(%s);' % (indent, typedef_fwd_dict[s]))
1034 i_decl = False
1035 for m in sorted(self.struct_dict[s]):
1036 if m in skip_list:
1037 continue
1038 if self.struct_dict[s][m]['dyn_array']:
1039 if self.struct_dict[s][m]['full_type'].count('*') > 1:
1040 if not is_type(self.struct_dict[s][m]['type'], 'struct') and not 'char' in self.struct_dict[s][m]['type'].lower():
Tobin Ehlis04112922015-03-16 10:44:40 -06001041 if 'ppMemBarriers' == self.struct_dict[s][m]['name']:
1042 # TODO : For now be conservative and consider all memBarrier ptrs as largest possible struct
1043 sh_funcs.append('%sstructSize += pStruct->%s*(sizeof(%s*) + sizeof(XGL_IMAGE_MEMORY_BARRIER));' % (indent, self.struct_dict[s][m]['array_size'], self.struct_dict[s][m]['type']))
1044 else:
1045 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 Ehlis60354772015-03-12 14:50:40 -06001046 else: # This is an array of char* or array of struct ptrs
1047 if not i_decl:
1048 sh_funcs.append('%suint32_t i = 0;' % (indent))
1049 i_decl = True
1050 sh_funcs.append('%sfor (i = 0; i < pStruct->%s; i++) {' % (indent, self.struct_dict[s][m]['array_size']))
1051 indent = ' '
1052 if is_type(self.struct_dict[s][m]['type'], 'struct'):
1053 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']))
1054 else:
Tobin Ehlisbd6a9162015-03-13 07:18:05 -06001055 sh_funcs.append('%sstructSize += (sizeof(char*) + (sizeof(char) * (1 + strlen(pStruct->%s[i]))));' % (indent, self.struct_dict[s][m]['name']))
Tobin Ehlis60354772015-03-12 14:50:40 -06001056 indent = ' '
1057 sh_funcs.append('%s}' % (indent))
1058 else:
1059 if is_type(self.struct_dict[s][m]['type'], 'struct'):
1060 if not i_decl:
1061 sh_funcs.append('%suint32_t i = 0;' % (indent))
1062 i_decl = True
1063 sh_funcs.append('%sfor (i = 0; i < pStruct->%s; i++) {' % (indent, self.struct_dict[s][m]['array_size']))
1064 indent = ' '
1065 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']))
1066 indent = ' '
1067 sh_funcs.append('%s}' % (indent))
1068 else:
1069 sh_funcs.append('%sstructSize += pStruct->%s*sizeof(%s);' % (indent, self.struct_dict[s][m]['array_size'], self.struct_dict[s][m]['type']))
1070 elif self.struct_dict[s][m]['ptr'] and 'pNext' != self.struct_dict[s][m]['name']:
1071 if 'char' in self.struct_dict[s][m]['type'].lower():
Tobin Ehlisbd6a9162015-03-13 07:18:05 -06001072 sh_funcs.append('%sstructSize += sizeof(%s)*(1+strlen(pStruct->%s));' % (indent, self.struct_dict[s][m]['type'], self.struct_dict[s][m]['name']))
Tobin Ehlis60354772015-03-12 14:50:40 -06001073 elif is_type(self.struct_dict[s][m]['type'], 'struct'):
1074 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 Ehlis04112922015-03-16 10:44:40 -06001075 elif 'void' not in self.struct_dict[s][m]['type'].lower():
Tobin Ehlis60354772015-03-12 14:50:40 -06001076 sh_funcs.append('%sstructSize += sizeof(%s);' % (indent, self.struct_dict[s][m]['type']))
1077 elif 'size_t' == self.struct_dict[s][m]['type'].lower():
1078 sh_funcs.append('%sstructSize += pStruct->%s;' % (indent, self.struct_dict[s][m]['name']))
1079 skip_list.append(m+1)
1080 indent = ' '
1081 sh_funcs.append('%s}' % (indent))
1082 sh_funcs.append("%sreturn structSize;\n}" % (indent))
Tobin Ehlis04112922015-03-16 10:44:40 -06001083 # Now generate generic functions to loop over entire struct chain (or just handle single generic structs)
1084 for follow_chain in [True, False]:
1085 if follow_chain:
1086 sh_funcs.append('size_t get_struct_chain_size(const void* pStruct)\n{')
1087 else:
1088 sh_funcs.append('size_t get_dynamic_struct_size(const void* pStruct)\n{')
1089 indent = ' '
1090 sh_funcs.append('%s// Just use XGL_APPLICATION_INFO as struct until actual type is resolved' % (indent))
1091 sh_funcs.append('%sXGL_APPLICATION_INFO* pNext = (XGL_APPLICATION_INFO*)pStruct;' % (indent))
1092 sh_funcs.append('%ssize_t structSize = 0;' % (indent))
1093 if follow_chain:
1094 sh_funcs.append('%swhile (pNext) {' % (indent))
1095 indent = ' '
1096 sh_funcs.append('%sswitch (pNext->sType) {' % (indent))
1097 indent += ' '
1098 for e in enum_type_dict:
1099 if '_STRUCTURE_TYPE' in e:
1100 for v in sorted(enum_type_dict[e]):
1101 struct_name = v.replace("_STRUCTURE_TYPE", "")
1102 sh_funcs.append('%scase %s:' % (indent, v))
1103 sh_funcs.append('%s{' % (indent))
1104 indent += ' '
1105 sh_funcs.append('%sstructSize += %s((%s*)pNext);' % (indent, self._get_size_helper_func_name(struct_name), struct_name))
1106 sh_funcs.append('%sbreak;' % (indent))
1107 indent = indent[:-4]
1108 sh_funcs.append('%s}' % (indent))
1109 sh_funcs.append('%sdefault:' % (indent))
1110 indent += ' '
1111 sh_funcs.append('%sassert(0);' % (indent))
1112 sh_funcs.append('%sstructSize += 0;' % (indent))
1113 indent = indent[:-4]
1114 indent = indent[:-4]
1115 sh_funcs.append('%s}' % (indent))
1116 if follow_chain:
1117 sh_funcs.append('%spNext = (XGL_APPLICATION_INFO*)pNext->pNext;' % (indent))
1118 indent = indent[:-4]
1119 sh_funcs.append('%s}' % (indent))
1120 sh_funcs.append('%sreturn structSize;\n}' % indent)
Tobin Ehlis60354772015-03-12 14:50:40 -06001121 return "\n".join(sh_funcs)
1122
1123 def _generateSizeHelperHeader(self):
1124 header = []
1125 header.append("//#includes, #defines, globals and such...\n")
1126 for f in self.include_headers:
1127 header.append("#include <%s>\n" % f)
1128 header.append('\n// Function Prototypes\n')
1129 header.append("size_t get_struct_chain_size(const void* pStruct);\n")
Tobin Ehlis04112922015-03-16 10:44:40 -06001130 header.append("size_t get_dynamic_struct_size(const void* pStruct);\n")
Tobin Ehlis60354772015-03-12 14:50:40 -06001131 return "".join(header)
1132
Peter Lohrmann4a8d8912015-04-03 11:43:06 -07001133 def _generateSizeHelperHeaderC(self):
1134 header = []
1135 header.append('#include "xgl_struct_size_helper.h"')
1136 header.append('#include <string.h>')
1137 header.append('#include <assert.h>')
1138 header.append('\n// Function definitions\n')
1139 return "\n".join(header)
1140
1141
Tobin Ehlis6442dca2014-10-22 15:13:53 -06001142 def _generateHeader(self):
1143 header = []
1144 header.append("//#includes, #defines, globals and such...\n")
1145 for f in self.include_headers:
1146 header.append("#include <%s>\n" % f)
1147 return "".join(header)
1148
1149 # Declarations
1150 def _generateConstructorDeclarations(self, s):
1151 constructors = []
1152 constructors.append(" %s();\n" % self.get_class_name(s))
1153 constructors.append(" %s(%s* pInStruct);\n" % (self.get_class_name(s), typedef_fwd_dict[s]))
1154 constructors.append(" %s(const %s* pInStruct);\n" % (self.get_class_name(s), typedef_fwd_dict[s]))
1155 return "".join(constructors)
1156
1157 def _generateDestructorDeclarations(self, s):
1158 return " virtual ~%s();\n" % self.get_class_name(s)
1159
1160 def _generateDisplayDeclarations(self, s):
1161 return " void display_txt();\n void display_single_txt();\n void display_full_txt();\n"
1162
1163 def _generateGetSetDeclarations(self, s):
1164 get_set = []
1165 get_set.append(" void set_indent(uint32_t indent) { m_indent = indent; }\n")
1166 for member in sorted(self.struct_dict[s]):
1167 # TODO : Skipping array set/get funcs for now
1168 if self.struct_dict[s][member]['array']:
1169 continue
1170 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']))
1171 if not self.struct_dict[s][member]['const']:
1172 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']))
1173 return "".join(get_set)
1174
1175 def _generatePrivateMembers(self, s):
1176 priv = []
1177 priv.append("\nprivate:\n")
1178 priv.append(" %s m_struct;\n" % typedef_fwd_dict[s])
1179 priv.append(" const %s* m_origStructAddr;\n" % typedef_fwd_dict[s])
1180 priv.append(" uint32_t m_indent;\n")
1181 priv.append(" const char m_dummy_prefix;\n")
1182 priv.append(" void display_struct_members();\n")
1183 return "".join(priv)
1184
1185 def _generateClassDeclaration(self):
1186 class_decl = []
Peter Lohrmann49ea1842015-03-30 16:29:56 -07001187 for s in sorted(self.struct_dict):
Tobin Ehlis6442dca2014-10-22 15:13:53 -06001188 class_decl.append("\n//class declaration")
1189 class_decl.append("class %s\n{\npublic:" % self.get_class_name(s))
1190 class_decl.append(self._generateConstructorDeclarations(s))
1191 class_decl.append(self._generateDestructorDeclarations(s))
1192 class_decl.append(self._generateDisplayDeclarations(s))
1193 class_decl.append(self._generateGetSetDeclarations(s))
1194 class_decl.append(self._generatePrivateMembers(s))
1195 class_decl.append("};\n")
1196 return "\n".join(class_decl)
1197
1198 def _generateFooter(self):
1199 return "\n//any footer info for class\n"
1200
1201class EnumCodeGen:
Tobin Ehlis7c47fc42014-12-17 07:20:23 -07001202 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 Ehlis6442dca2014-10-22 15:13:53 -06001203 self.et_dict = enum_type_dict
1204 self.ev_dict = enum_val_dict
1205 self.tf_dict = typedef_fwd_dict
1206 self.in_file = in_file
Tobin Ehlis7c47fc42014-12-17 07:20:23 -07001207 self.out_sh_file = out_sh_file
1208 self.eshfg = CommonFileGen(self.out_sh_file)
1209 self.out_vh_file = out_vh_file
1210 self.evhfg = CommonFileGen(self.out_vh_file)
Tobin Ehlis6442dca2014-10-22 15:13:53 -06001211
1212 def generateStringHelper(self):
Tobin Ehlis7c47fc42014-12-17 07:20:23 -07001213 self.eshfg.setHeader(self._generateSHHeader())
1214 self.eshfg.setBody(self._generateSHBody())
1215 self.eshfg.generate()
1216
1217 def generateEnumValidate(self):
1218 self.evhfg.setHeader(self._generateSHHeader())
Tobin Ehlis14ff0852014-12-17 17:44:50 -07001219 self.evhfg.setBody(self._generateVHBody())
Tobin Ehlis7c47fc42014-12-17 07:20:23 -07001220 self.evhfg.generate()
1221
1222 def _generateVHBody(self):
1223 body = []
Peter Lohrmann49ea1842015-03-30 16:29:56 -07001224 for bet in sorted(self.et_dict):
Tobin Ehlis7c47fc42014-12-17 07:20:23 -07001225 fet = self.tf_dict[bet]
Ian Elliottfeae4052015-02-18 12:38:04 -07001226 body.append("static inline uint32_t validate_%s(%s input_value)\n{\n switch ((%s)input_value)\n {" % (fet, fet, fet))
Tobin Ehlis7c47fc42014-12-17 07:20:23 -07001227 for e in sorted(self.et_dict[bet]):
1228 if (self.ev_dict[e]['unique']):
Tobin Ehlis10777032015-01-16 15:13:34 -07001229 body.append(' case %s:' % (e))
1230 body.append(' return 1;\n default:\n return 0;\n }\n}\n\n')
Tobin Ehlis7c47fc42014-12-17 07:20:23 -07001231 return "\n".join(body)
1232
Tobin Ehlis6442dca2014-10-22 15:13:53 -06001233 def _generateSHBody(self):
1234 body = []
1235# with open(self.out_file, "a") as hf:
1236 # bet == base_enum_type, fet == final_enum_type
Peter Lohrmann49ea1842015-03-30 16:29:56 -07001237 for bet in sorted(self.et_dict):
Tobin Ehlis6442dca2014-10-22 15:13:53 -06001238 fet = self.tf_dict[bet]
Ian Elliottfeae4052015-02-18 12:38:04 -07001239 body.append("static inline const char* string_%s(%s input_value)\n{\n switch ((%s)input_value)\n {" % (fet, fet, fet))
Tobin Ehlis6442dca2014-10-22 15:13:53 -06001240 for e in sorted(self.et_dict[bet]):
1241 if (self.ev_dict[e]['unique']):
Tobin Ehlis10777032015-01-16 15:13:34 -07001242 body.append(' case %s:\n return "%s";' % (e, e))
1243 body.append(' default:\n return "Unhandled %s";\n }\n}\n\n' % (fet))
Tobin Ehlis6442dca2014-10-22 15:13:53 -06001244 return "\n".join(body)
1245
1246 def _generateSHHeader(self):
Ian Elliott2d4ab1e2015-01-13 17:52:38 -07001247 header = []
1248 header.append('#pragma once\n')
Ian Elliottfeae4052015-02-18 12:38:04 -07001249 header.append('#include <%s>\n\n\n' % self.in_file)
Ian Elliott2d4ab1e2015-01-13 17:52:38 -07001250 return "\n".join(header)
Tobin Ehlis6442dca2014-10-22 15:13:53 -06001251
1252
1253class CMakeGen:
1254 def __init__(self, struct_wrapper=None, out_dir=None):
1255 self.sw = struct_wrapper
Tobin Ehlis83562882014-11-27 15:43:39 -07001256 self.include_headers = []
Tobin Ehlis6442dca2014-10-22 15:13:53 -06001257 self.add_lib_file_list = self.sw.get_file_list()
1258 self.out_dir = out_dir
1259 self.out_file = os.path.join(self.out_dir, "CMakeLists.txt")
1260 self.cmg = CommonFileGen(self.out_file)
1261
1262 def generate(self):
1263 self.cmg.setBody(self._generateBody())
1264 self.cmg.generate()
1265
1266 def _generateBody(self):
1267 body = []
1268 body.append("project(%s)" % os.path.basename(self.out_dir))
1269 body.append("cmake_minimum_required(VERSION 2.8)\n")
1270 body.append("add_library(${PROJECT_NAME} %s)\n" % " ".join(self.add_lib_file_list))
1271 body.append('set(COMPILE_FLAGS "-fpermissive")')
1272 body.append('set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} ${COMPILE_FLAGS}")\n')
1273 body.append("include_directories(${SRC_DIR}/thirdparty/${GEN_API}/inc/)\n")
1274 body.append("target_include_directories (%s PUBLIC ${CMAKE_CURRENT_SOURCE_DIR})\n" % os.path.basename(self.out_dir))
1275 return "\n".join(body)
1276
1277class GraphVizGen:
Tobin Ehlis83562882014-11-27 15:43:39 -07001278 def __init__(self, struct_dict, prefix, out_dir):
1279 self.struct_dict = struct_dict
1280 self.api = prefix
1281 self.out_file = os.path.join(out_dir, self.api+"_struct_graphviz_helper.h")
Tobin Ehlis6442dca2014-10-22 15:13:53 -06001282 self.gvg = CommonFileGen(self.out_file)
Tobin Ehlis83562882014-11-27 15:43:39 -07001283
Tobin Ehlis6442dca2014-10-22 15:13:53 -06001284 def generate(self):
Tobin Ehlis83562882014-11-27 15:43:39 -07001285 self.gvg.setCopyright("//This is the copyright\n")
Tobin Ehlis6442dca2014-10-22 15:13:53 -06001286 self.gvg.setHeader(self._generateHeader())
1287 self.gvg.setBody(self._generateBody())
Tobin Ehlis83562882014-11-27 15:43:39 -07001288 #self.gvg.setFooter('}')
Tobin Ehlis6442dca2014-10-22 15:13:53 -06001289 self.gvg.generate()
Tobin Ehlis83562882014-11-27 15:43:39 -07001290
1291 def set_include_headers(self, include_headers):
1292 self.include_headers = include_headers
1293
Tobin Ehlis6442dca2014-10-22 15:13:53 -06001294 def _generateHeader(self):
Tobin Ehlis83562882014-11-27 15:43:39 -07001295 header = []
1296 header.append("//#includes, #defines, globals and such...\n")
1297 for f in self.include_headers:
1298 if 'xgl_enum_string_helper' not in f:
1299 header.append("#include <%s>\n" % f)
1300 #header.append('#include "xgl_enum_string_helper.h"\n\n// Function Prototypes\n')
Mark Lobodzinski17caf572015-01-29 08:55:56 -06001301 header.append("\nchar* dynamic_gv_display(const void* pStruct, const char* prefix);\n")
Tobin Ehlis83562882014-11-27 15:43:39 -07001302 return "".join(header)
1303
1304 def _get_gv_func_name(self, struct):
1305 return "%s_gv_print_%s" % (self.api, struct.lower().strip("_"))
1306
1307 # Return elements to create formatted string for given struct member
1308 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=""):
1309 struct_op = "->"
1310 pre_var_name = '"%s "' % struct_member['full_type']
1311 if not struct_ptr:
1312 struct_op = "."
1313 member_name = struct_member['name']
1314 print_type = "p"
1315 cast_type = ""
1316 member_post = ""
1317 array_index = ""
1318 member_print_post = ""
Tobin Ehlisb0497852015-02-11 14:24:02 -07001319 print_delimiter = "%"
Tobin Ehlis83562882014-11-27 15:43:39 -07001320 if struct_member['array'] and 'CHAR' in struct_member['type']: # just print char array as string
1321 print_type = "s"
1322 print_array = False
1323 elif struct_member['array'] and not print_array:
1324 # Just print base address of array when not full print_array
1325 cast_type = "(void*)"
1326 elif is_type(struct_member['type'], 'enum'):
Jon Ashburnfe6113c2015-01-09 09:11:44 -07001327 if struct_member['ptr']:
1328 struct_var_name = "*" + struct_var_name
Tobin Ehlis83562882014-11-27 15:43:39 -07001329 cast_type = "string_%s" % struct_member['type']
1330 print_type = "s"
1331 elif is_type(struct_member['type'], 'struct'): # print struct address for now
1332 cast_type = "(void*)"
1333 if not struct_member['ptr']:
1334 cast_type = "(void*)&"
Tobin Ehlis7e65d752015-01-15 17:51:52 -07001335 elif 'bool' in struct_member['type']:
Tobin Ehlis83562882014-11-27 15:43:39 -07001336 print_type = "s"
1337 member_post = ' ? "TRUE" : "FALSE"'
Tobin Ehlis7e65d752015-01-15 17:51:52 -07001338 elif 'float' in struct_member['type']:
Tobin Ehlis83562882014-11-27 15:43:39 -07001339 print_type = "f"
Tobin Ehlis7e65d752015-01-15 17:51:52 -07001340 elif 'uint64' in struct_member['type']:
Tobin Ehlis83562882014-11-27 15:43:39 -07001341 print_type = "lu"
Tobin Ehlis7e65d752015-01-15 17:51:52 -07001342 elif 'uint8' in struct_member['type']:
Tobin Ehlis83562882014-11-27 15:43:39 -07001343 print_type = "hu"
Chia-I Wu99ff89d2014-12-27 14:14:50 +08001344 elif '_SIZE' in struct_member['type']:
Tobin Ehlisb0497852015-02-11 14:24:02 -07001345 print_type = '" PRINTF_SIZE_T_SPECIFIER "'
1346 print_delimiter = ""
Tobin Ehlis7e65d752015-01-15 17:51:52 -07001347 elif True in [ui_str in struct_member['type'] for ui_str in ['uint', '_FLAGS', '_SAMPLE_MASK']]:
Tobin Ehlis83562882014-11-27 15:43:39 -07001348 print_type = "u"
Tobin Ehlis7e65d752015-01-15 17:51:52 -07001349 elif 'int' in struct_member['type']:
Tobin Ehlis83562882014-11-27 15:43:39 -07001350 print_type = "i"
1351 elif struct_member['ptr']:
1352 pass
1353 else:
1354 #print("Unhandled struct type: %s" % struct_member['type'])
1355 cast_type = "(void*)"
1356 if print_array and struct_member['array']:
1357 member_print_post = "[%u]"
1358 array_index = " i,"
1359 member_post = "[i]"
Tobin Ehlisb0497852015-02-11 14:24:02 -07001360 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
Tobin Ehlis83562882014-11-27 15:43:39 -07001361 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
1362 return (print_out, print_arg)
1363
Tobin Ehlis6442dca2014-10-22 15:13:53 -06001364 def _generateBody(self):
Tobin Ehlis83562882014-11-27 15:43:39 -07001365 gv_funcs = []
1366 array_func_list = [] # structs for which we'll generate an array version of their print function
Tobin Ehlisb8013a22015-02-26 12:57:08 -07001367 array_func_list.append('xgl_buffer_view_attach_info')
1368 array_func_list.append('xgl_image_view_attach_info')
1369 array_func_list.append('xgl_sampler_image_view_info')
1370 array_func_list.append('xgl_descriptor_type_count')
Tobin Ehlis83562882014-11-27 15:43:39 -07001371 # For first pass, generate prototype
Peter Lohrmann49ea1842015-03-30 16:29:56 -07001372 for s in sorted(self.struct_dict):
Tobin Ehlis83562882014-11-27 15:43:39 -07001373 gv_funcs.append('char* %s(const %s* pStruct, const char* myNodeName);\n' % (self._get_gv_func_name(s), typedef_fwd_dict[s]))
1374 if s.lower().strip("_") in array_func_list:
Tobin Ehlisb8013a22015-02-26 12:57:08 -07001375 if s.lower().strip("_") in ['xgl_buffer_view_attach_info', 'xgl_image_view_attach_info']:
1376 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]))
1377 else:
1378 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 Ehlis83562882014-11-27 15:43:39 -07001379 gv_funcs.append('\n')
Peter Lohrmann49ea1842015-03-30 16:29:56 -07001380 for s in sorted(self.struct_dict):
Tobin Ehlis83562882014-11-27 15:43:39 -07001381 p_out = ""
1382 p_args = ""
1383 stp_list = [] # stp == "struct to print" a list of structs for this API call that should be printed as structs
1384 # the fields below are a super-hacky way for now to get port labels into GV output, TODO : Clean this up!
1385 pl_dict = {}
1386 struct_num = 0
Tobin Ehlisb8013a22015-02-26 12:57:08 -07001387 # This isn't great but this pre-pass flags structs w/ pNext and other struct ptrs
Tobin Ehlis83562882014-11-27 15:43:39 -07001388 for m in sorted(self.struct_dict[s]):
1389 if 'pNext' == self.struct_dict[s][m]['name'] or is_type(self.struct_dict[s][m]['type'], 'struct'):
1390 stp_list.append(self.struct_dict[s][m])
1391 if 'pNext' == self.struct_dict[s][m]['name']:
1392 pl_dict[m] = ' PORT=\\"pNext\\"'
1393 else:
1394 pl_dict[m] = ' PORT=\\"struct%i\\"' % struct_num
1395 struct_num += 1
1396 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]))
1397 num_stps = len(stp_list);
1398 total_strlen_str = ''
1399 if 0 != num_stps:
1400 gv_funcs.append(" char* tmpStr;\n")
1401 gv_funcs.append(" char nodeName[100];\n")
Tobin Ehlis83562882014-11-27 15:43:39 -07001402 gv_funcs.append(' char* stp_strs[%i];\n' % num_stps)
1403 for index in range(num_stps):
1404 if (stp_list[index]['ptr']):
1405 if 'pDescriptorInfo' == stp_list[index]['name']:
1406 gv_funcs.append(' if (pStruct->pDescriptorInfo && (0 != pStruct->descriptorCount)) {\n')
1407 else:
1408 gv_funcs.append(' if (pStruct->%s) {\n' % stp_list[index]['name'])
1409 if 'pNext' == stp_list[index]['name']:
1410 gv_funcs.append(' sprintf(nodeName, "pNext_%p", (void*)pStruct->pNext);\n')
Mark Lobodzinski17caf572015-01-29 08:55:56 -06001411 gv_funcs.append(' tmpStr = dynamic_gv_display((void*)pStruct->pNext, nodeName);\n')
Tobin Ehlis83562882014-11-27 15:43:39 -07001412 gv_funcs.append(' stp_strs[%i] = (char*)malloc(256+strlen(tmpStr)+strlen(nodeName)+strlen(myNodeName));\n' % index)
1413 gv_funcs.append(' sprintf(stp_strs[%i], "%%s\\n\\"%%s\\":pNext -> \\"%%s\\" [];\\n", tmpStr, myNodeName, nodeName);\n' % index)
1414 gv_funcs.append(' free(tmpStr);\n')
1415 else:
1416 gv_funcs.append(' sprintf(nodeName, "%s_%%p", (void*)pStruct->%s);\n' % (stp_list[index]['name'], stp_list[index]['name']))
Tobin Ehlisb8013a22015-02-26 12:57:08 -07001417 if stp_list[index]['name'] in ['pTypeCount', 'pBufferViews', 'pImageViews', 'pSamplerImageViews']:
1418 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 Ehlis83562882014-11-27 15:43:39 -07001419 else:
1420 gv_funcs.append(' tmpStr = %s(pStruct->%s, nodeName);\n' % (self._get_gv_func_name(stp_list[index]['type']), stp_list[index]['name']))
1421 gv_funcs.append(' stp_strs[%i] = (char*)malloc(256+strlen(tmpStr)+strlen(nodeName)+strlen(myNodeName));\n' % (index))
1422 gv_funcs.append(' sprintf(stp_strs[%i], "%%s\\n\\"%%s\\":struct%i -> \\"%%s\\" [];\\n", tmpStr, myNodeName, nodeName);\n' % (index, index))
1423 gv_funcs.append(' }\n')
Chia-I Wu3bf80a62014-12-16 00:36:58 +08001424 gv_funcs.append(" else\n stp_strs[%i] = \"\";\n" % (index))
Tobin Ehlis83562882014-11-27 15:43:39 -07001425 elif stp_list[index]['array']: # TODO : For now just printing first element of array
1426 gv_funcs.append(' sprintf(nodeName, "%s_%%p", (void*)&pStruct->%s[0]);\n' % (stp_list[index]['name'], stp_list[index]['name']))
1427 gv_funcs.append(' tmpStr = %s(&pStruct->%s[0], nodeName);\n' % (self._get_gv_func_name(stp_list[index]['type']), stp_list[index]['name']))
1428 gv_funcs.append(' stp_strs[%i] = (char*)malloc(256+strlen(tmpStr)+strlen(nodeName)+strlen(myNodeName));\n' % (index))
1429 gv_funcs.append(' sprintf(stp_strs[%i], "%%s\\n\\"%%s\\":struct%i -> \\"%%s\\" [];\\n", tmpStr, myNodeName, nodeName);\n' % (index, index))
1430 else:
1431 gv_funcs.append(' sprintf(nodeName, "%s_%%p", (void*)&pStruct->%s);\n' % (stp_list[index]['name'], stp_list[index]['name']))
1432 gv_funcs.append(' tmpStr = %s(&pStruct->%s, nodeName);\n' % (self._get_gv_func_name(stp_list[index]['type']), stp_list[index]['name']))
1433 gv_funcs.append(' stp_strs[%i] = (char*)malloc(256+strlen(tmpStr)+strlen(nodeName)+strlen(myNodeName));\n' % (index))
1434 gv_funcs.append(' sprintf(stp_strs[%i], "%%s\\n\\"%%s\\":struct%i -> \\"%%s\\" [];\\n", tmpStr, myNodeName, nodeName);\n' % (index, index))
1435 total_strlen_str += 'strlen(stp_strs[%i]) + ' % index
1436 gv_funcs.append(' str = (char*)malloc(%ssizeof(char)*2048);\n' % (total_strlen_str))
1437 gv_funcs.append(' sprintf(str, "\\"%s\\" [\\nlabel = <<TABLE BORDER=\\"0\\" CELLBORDER=\\"1\\" CELLSPACING=\\"0\\"><TR><TD COLSPAN=\\"2\\">%s (%p)</TD></TR>')
1438 p_args = ", myNodeName, myNodeName, pStruct"
1439 for m in sorted(self.struct_dict[s]):
1440 plabel = ""
1441 if m in pl_dict:
1442 plabel = pl_dict[m]
1443 (p_out1, p_args1) = self._get_struct_gv_print_formatted(self.struct_dict[s][m], port_label=plabel)
1444 p_out += p_out1
1445 p_args += p_args1
1446 p_out += '</TABLE>>\\n];\\n\\n"'
1447 p_args += ");\n"
1448 gv_funcs.append(p_out)
1449 gv_funcs.append(p_args)
1450 if 0 != num_stps:
1451 gv_funcs.append(' for (int32_t stp_index = %i; stp_index >= 0; stp_index--) {\n' % (num_stps-1))
1452 gv_funcs.append(' if (0 < strlen(stp_strs[stp_index])) {\n')
1453 gv_funcs.append(' strncat(str, stp_strs[stp_index], strlen(stp_strs[stp_index]));\n')
1454 gv_funcs.append(' free(stp_strs[stp_index]);\n')
1455 gv_funcs.append(' }\n')
1456 gv_funcs.append(' }\n')
1457 gv_funcs.append(" return str;\n}\n")
1458 if s.lower().strip("_") in array_func_list:
Tobin Ehlisb8013a22015-02-26 12:57:08 -07001459 ptr_array = False
1460 if s.lower().strip("_") in ['xgl_buffer_view_attach_info', 'xgl_image_view_attach_info']:
1461 ptr_array = True
1462 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]))
1463 else:
1464 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 Ehlis83562882014-11-27 15:43:39 -07001465 gv_funcs.append(' str = (char*)malloc(sizeof(char)*1024*count);\n')
1466 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')
1467 gv_funcs.append(' for (uint32_t i=0; i < count; i++) {\n')
1468 gv_funcs.append(' sprintf(tmpStr, "');
1469 p_args = ""
1470 p_out = ""
1471 for m in sorted(self.struct_dict[s]):
Tobin Ehlis83562882014-11-27 15:43:39 -07001472 plabel = ""
1473 (p_out1, p_args1) = self._get_struct_gv_print_formatted(self.struct_dict[s][m], port_label=plabel)
Tobin Ehlisb8013a22015-02-26 12:57:08 -07001474 if 0 == m: # Add array index notation at end of first row
1475 p_out1 = '%s<TD ROWSPAN=\\"%i\\" PORT=\\"slot%%u\\">%%u</TD></TR>' % (p_out1[:-5], len(self.struct_dict[s]))
Tobin Ehlis83562882014-11-27 15:43:39 -07001476 p_args1 += ', i, i'
1477 p_out += p_out1
1478 p_args += p_args1
1479 p_out += '"'
1480 p_args += ");\n"
Tobin Ehlisb8013a22015-02-26 12:57:08 -07001481 if ptr_array:
1482 p_args = p_args.replace('->', '[i]->')
1483 else:
1484 p_args = p_args.replace('->', '[i].')
Tobin Ehlis83562882014-11-27 15:43:39 -07001485 gv_funcs.append(p_out);
1486 gv_funcs.append(p_args);
1487 gv_funcs.append(' strncat(str, tmpStr, strlen(tmpStr));\n')
1488 gv_funcs.append(' }\n')
1489 gv_funcs.append(' strncat(str, "</TABLE>>\\n];\\n\\n", 20);\n')
Tobin Ehlis83562882014-11-27 15:43:39 -07001490 gv_funcs.append(' return str;\n}\n')
1491 # Add function to dynamically print out unknown struct
Mark Lobodzinski17caf572015-01-29 08:55:56 -06001492 gv_funcs.append("char* dynamic_gv_display(const void* pStruct, const char* nodeName)\n{\n")
Tobin Ehlis83562882014-11-27 15:43:39 -07001493 gv_funcs.append(" // Cast to APP_INFO ptr initially just to pull sType off struct\n")
1494 gv_funcs.append(" XGL_STRUCTURE_TYPE sType = ((XGL_APPLICATION_INFO*)pStruct)->sType;\n")
1495 gv_funcs.append(" switch (sType)\n {\n")
1496 for e in enum_type_dict:
1497 if "_STRUCTURE_TYPE" in e:
1498 for v in sorted(enum_type_dict[e]):
1499 struct_name = v.replace("_STRUCTURE_TYPE", "")
1500 print_func_name = self._get_gv_func_name(struct_name)
1501 # TODO : Hand-coded fixes for some exceptions
Tobin Ehlis7e65d752015-01-15 17:51:52 -07001502 #if 'XGL_PIPELINE_CB_STATE_CREATE_INFO' in struct_name:
1503 # struct_name = 'XGL_PIPELINE_CB_STATE'
1504 if 'XGL_SEMAPHORE_CREATE_INFO' in struct_name:
Courtney Goeltzenleuchterebb95842015-03-25 17:14:29 -06001505 struct_name = 'XGL_SEMAPHORE_CREATE_INFO'
Tobin Ehlis83562882014-11-27 15:43:39 -07001506 print_func_name = self._get_gv_func_name(struct_name)
1507 elif 'XGL_SEMAPHORE_OPEN_INFO' in struct_name:
Courtney Goeltzenleuchterebb95842015-03-25 17:14:29 -06001508 struct_name = 'XGL_SEMAPHORE_OPEN_INFO'
Tobin Ehlis83562882014-11-27 15:43:39 -07001509 print_func_name = self._get_gv_func_name(struct_name)
1510 gv_funcs.append(' case %s:\n' % (v))
1511 gv_funcs.append(' return %s((%s*)pStruct, nodeName);\n' % (print_func_name, struct_name))
1512 #gv_funcs.append(' }\n')
1513 #gv_funcs.append(' break;\n')
Chia-I Wubfa3fea2014-12-16 00:43:20 +08001514 gv_funcs.append(" default:\n")
1515 gv_funcs.append(" return NULL;\n")
Tobin Ehlis83562882014-11-27 15:43:39 -07001516 gv_funcs.append(" }\n")
1517 gv_funcs.append("}")
1518 return "".join(gv_funcs)
1519
1520
1521
1522
1523
1524# def _generateHeader(self):
1525# hdr = []
1526# hdr.append('digraph g {\ngraph [\nrankdir = "LR"\n];')
1527# hdr.append('node [\nfontsize = "16"\nshape = "plaintext"\n];')
1528# hdr.append('edge [\n];\n')
1529# return "\n".join(hdr)
1530#
1531# def _generateBody(self):
1532# body = []
Peter Lohrmann49ea1842015-03-30 16:29:56 -07001533# for s in sorted(self.struc_dict):
Tobin Ehlis83562882014-11-27 15:43:39 -07001534# field_num = 1
1535# 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]))
1536# for m in sorted(self.struc_dict[s]):
1537# 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']))
1538# field_num += 2
1539# body.append('</TABLE>>\n];\n')
1540# return "".join(body)
Tobin Ehlis6442dca2014-10-22 15:13:53 -06001541
1542def main(argv=None):
1543 opts = handle_args()
1544 # Parse input file and fill out global dicts
1545 hfp = HeaderFileParser(opts.input_file)
1546 hfp.parse()
1547 # TODO : Don't want these to be global, see note at top about wrapper classes
1548 global enum_val_dict
1549 global enum_type_dict
1550 global struct_dict
1551 global typedef_fwd_dict
1552 global typedef_rev_dict
1553 global types_dict
1554 enum_val_dict = hfp.get_enum_val_dict()
1555 enum_type_dict = hfp.get_enum_type_dict()
1556 struct_dict = hfp.get_struct_dict()
Tobin Ehlis5a487e52014-11-11 12:28:12 -07001557 # TODO : Would like to validate struct data here to verify that all of the bools for struct members are correct at this point
Tobin Ehlis6442dca2014-10-22 15:13:53 -06001558 typedef_fwd_dict = hfp.get_typedef_fwd_dict()
1559 typedef_rev_dict = hfp.get_typedef_rev_dict()
1560 types_dict = hfp.get_types_dict()
1561 #print(enum_val_dict)
1562 #print(typedef_dict)
1563 #print(struct_dict)
1564 if (opts.abs_out_dir is not None):
Tobin Ehlis7c47fc42014-12-17 07:20:23 -07001565 enum_sh_filename = os.path.join(opts.abs_out_dir, os.path.basename(opts.input_file).strip(".h")+"_enum_string_helper.h")
Tobin Ehlis6442dca2014-10-22 15:13:53 -06001566 else:
Tobin Ehlis7c47fc42014-12-17 07:20:23 -07001567 enum_sh_filename = os.path.join(os.getcwd(), opts.rel_out_dir, os.path.basename(opts.input_file).strip(".h")+"_enum_string_helper.h")
1568 enum_sh_filename = os.path.abspath(enum_sh_filename)
1569 if not os.path.exists(os.path.dirname(enum_sh_filename)):
1570 print("Creating output dir %s" % os.path.dirname(enum_sh_filename))
1571 os.mkdir(os.path.dirname(enum_sh_filename))
Tobin Ehlis6442dca2014-10-22 15:13:53 -06001572 if opts.gen_enum_string_helper:
Tobin Ehlis7c47fc42014-12-17 07:20:23 -07001573 print("Generating enum string helper to %s" % enum_sh_filename)
1574 enum_vh_filename = os.path.join(os.path.dirname(enum_sh_filename), os.path.basename(opts.input_file).strip(".h")+"_enum_validate_helper.h")
1575 print("Generating enum validate helper to %s" % enum_vh_filename)
1576 eg = EnumCodeGen(enum_type_dict, enum_val_dict, typedef_fwd_dict, os.path.basename(opts.input_file), enum_sh_filename, enum_vh_filename)
Tobin Ehlis6442dca2014-10-22 15:13:53 -06001577 eg.generateStringHelper()
Tobin Ehlis7c47fc42014-12-17 07:20:23 -07001578 eg.generateEnumValidate()
Tobin Ehlis6442dca2014-10-22 15:13:53 -06001579 #for struct in struct_dict:
1580 #print(struct)
1581 if opts.gen_struct_wrappers:
Tobin Ehlis7c47fc42014-12-17 07:20:23 -07001582 sw = StructWrapperGen(struct_dict, os.path.basename(opts.input_file).strip(".h"), os.path.dirname(enum_sh_filename))
Tobin Ehlis6442dca2014-10-22 15:13:53 -06001583 #print(sw.get_class_name(struct))
Tobin Ehlis7c47fc42014-12-17 07:20:23 -07001584 sw.set_include_headers([os.path.basename(opts.input_file),os.path.basename(enum_sh_filename),"stdint.h","stdio.h","stdlib.h"])
Tobin Ehlis6442dca2014-10-22 15:13:53 -06001585 print("Generating struct wrapper header to %s" % sw.header_filename)
1586 sw.generateHeader()
1587 print("Generating struct wrapper class to %s" % sw.class_filename)
1588 sw.generateBody()
1589 sw.generateStringHelper()
Tobin Ehlis14ff0852014-12-17 17:44:50 -07001590 sw.generateValidateHelper()
Tobin Ehlisd49efcb2014-11-25 17:43:26 -07001591 # Generate a 2nd helper file that excludes addrs
1592 sw.set_no_addr(True)
1593 sw.generateStringHelper()
Tobin Ehlis99f88672015-01-10 12:42:41 -07001594 sw.set_no_addr(False)
1595 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 Ehlis99f88672015-01-10 12:42:41 -07001596 sw.set_no_addr(True)
1597 sw.generateStringHelperCpp()
Tobin Ehlis5178bd72015-03-06 10:38:25 -07001598 sw.set_no_addr(False)
1599 sw.generateStringHelperCpp()
Peter Lohrmann4a8d8912015-04-03 11:43:06 -07001600 sw.set_include_headers(["stdio.h", "stdlib.h", "xgl.h"])
Tobin Ehlis60354772015-03-12 14:50:40 -06001601 sw.generateSizeHelper()
Peter Lohrmann4a8d8912015-04-03 11:43:06 -07001602 sw.generateSizeHelperC()
Tobin Ehlis6442dca2014-10-22 15:13:53 -06001603 if opts.gen_cmake:
Tobin Ehlis7c47fc42014-12-17 07:20:23 -07001604 cmg = CMakeGen(sw, os.path.dirname(enum_sh_filename))
Tobin Ehlis6442dca2014-10-22 15:13:53 -06001605 cmg.generate()
1606 if opts.gen_graphviz:
Tobin Ehlis7c47fc42014-12-17 07:20:23 -07001607 gv = GraphVizGen(struct_dict, os.path.basename(opts.input_file).strip(".h"), os.path.dirname(enum_sh_filename))
1608 gv.set_include_headers([os.path.basename(opts.input_file),os.path.basename(enum_sh_filename),"stdint.h","stdio.h","stdlib.h"])
Tobin Ehlis6442dca2014-10-22 15:13:53 -06001609 gv.generate()
1610 print("DONE!")
1611 #print(typedef_rev_dict)
1612 #print(types_dict)
1613 #recreate_structs()
1614
1615if __name__ == "__main__":
1616 sys.exit(main())