#!/usr/bin/python2
# coding=utf-8
# -*- Mode: Python; py-indent-offset: 4 -*-
#
# Copyright © 2012 Intel Corporation
#
# Based on code by Kristian Høgsberg <krh@bitplanet.net>,
# extracted from mesa/main/get.c
#
# Permission is hereby granted, free of charge, to any person obtaining a
# copy of this software and associated documentation files (the "Software"),
# to deal in the Software without restriction, including without limitation
# on the rights to use, copy, modify, merge, publish, distribute, sub
# license, and/or sell copies of the Software, and to permit persons to whom
# the Software is furnished to do so, subject to the following conditions:
#
# The above copyright notice and this permission notice (including the next
# paragraph) shall be included in all copies or substantial portions of the
# Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
# FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL
# IBM AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
# IN THE SOFTWARE.
# Generate a C header file containing hash tables of glGet parameter
# names for each GL API. The generated file is to be included by glGet.c
import os, sys, imp, getopt
from collections import defaultdict
import get_hash_params
cur_dir = os.path.dirname(sys.argv[0])
param_desc_file = "%s/get_hash_params.py" % cur_dir
GLAPI = "%s/../../mapi/glapi/gen" % cur_dir
sys.path.append(GLAPI)
import gl_XML
prime_factor = 89
prime_step = 281
hash_table_size = 1024
gl_apis=set(["GL", "GL_CORE", "GLES", "GLES2", "GLES3", "GLES31", "GLES32"])
def print_header():
print "typedef const unsigned short table_t[%d];\n" % (hash_table_size)
print "static const int prime_factor = %d, prime_step = %d;\n" % \
(prime_factor, prime_step)
def print_params(params):
print "static const struct value_desc values[] = {"
for p in params:
print " { %s, %s }," % (p[0], p[1])
print "};\n"
def api_name(api):
return "API_OPEN%s" % api
# This must match gl_api enum in src/mesa/main/mtypes.h
api_enum = [
'GL',
'GLES',
'GLES2',
'GL_CORE',
'GLES3', # Not in gl_api enum in mtypes.h
'GLES31', # Not in gl_api enum in mtypes.h
'GLES32', # Not in gl_api enum in mtypes.h
]
def api_index(api):
return api_enum.index(api)
def table_name(api):
return "table_" + api_name(api)
def print_table(api, table):
print "static table_t %s = {" % (table_name(api))
# convert sparse (index, value) table into a dense table
dense_table = [0] * hash_table_size
for i, v in table:
dense_table[i] = v
row_size = 4
for i in range(0, hash_table_size, row_size):
row = dense_table[i : i + row_size]
idx_val = ["%4d" % v for v in row]
print " " * 4 + ", ".join(idx_val) + ","
print "};\n"
def print_tables(tables):
for table in tables:
print_table(table["apis"][0], table["indices"])
dense_tables = ['NULL'] * len(api_enum)
for table in tables:
tname = table_name(table["apis"][0])
for api in table["apis"]:
i = api_index(api)
dense_tables[i] = "&%s" % (tname)
print "static table_t *table_set[] = {"
for expr in dense_tables:
print " %s," % expr
print "};\n"
print "#define table(api) (*table_set[api])"
# Merge tables with matching parameter lists (i.e. GL and GL_CORE)
def merge_tables(tables):
merged_tables = []
for api, indices in sorted(tables.items()):
matching_table = filter(lambda mt:mt["indices"] == indices,
merged_tables)
if matching_table:
matching_table[0]["apis"].append(api)
else:
merged_tables.append({"apis": [api], "indices": indices})
return merged_tables
def add_to_hash_table(table, hash_val, value):
while True:
index = hash_val & (hash_table_size - 1)
if index not in table:
table[index] = value
break
hash_val += prime_step
def die(msg):
sys.stderr.write("%s: %s\n" % (program, msg))
exit(1)
program = os.path.basename(sys.argv[0])
def generate_hash_tables(enum_list, enabled_apis, param_descriptors):
tables = defaultdict(lambda:{})
# the first entry should be invalid, so that get.c:find_value can use
# its index for the 'enum not found' condition.
params = [[0, ""]]
for param_block in param_descriptors:
if set(["apis", "params"]) != set(param_block):
die("missing fields (%s) in param descriptor file (%s)" %
(", ".join(set(["apis", "params"]) - set(param_block)),
param_desc_file))
valid_apis = set(param_block["apis"])
if valid_apis - gl_apis:
die("unknown API(s) in param descriptor file (%s): %s\n" %
(param_desc_file, ",".join(valid_apis - gl_apis)))
if not (valid_apis & enabled_apis):
continue
valid_apis &= enabled_apis
for param in param_block["params"]:
enum_name = param[0]
enum_val = enum_list[enum_name].value
hash_val = enum_val * prime_factor
for api in valid_apis:
add_to_hash_table(tables[api], hash_val, len(params))
# Also add GLES2 items to the GLES3+ hash tables
if api == "GLES2":
add_to_hash_table(tables["GLES3"], hash_val, len(params))
add_to_hash_table(tables["GLES31"], hash_val, len(params))
add_to_hash_table(tables["GLES32"], hash_val, len(params))
# Also add GLES3 items to the GLES31+ hash tables
if api == "GLES3":
add_to_hash_table(tables["GLES31"], hash_val, len(params))
add_to_hash_table(tables["GLES32"], hash_val, len(params))
# Also add GLES31 items to the GLES32+ hash tables
if api == "GLES31":
add_to_hash_table(tables["GLES32"], hash_val, len(params))
params.append(["GL_" + enum_name, param[1]])
sorted_tables={}
for api, indices in tables.items():
sorted_tables[api] = sorted(indices.items())
return params, merge_tables(sorted_tables)
def show_usage():
sys.stderr.write(
"""Usage: %s [OPTIONS]
-f <file> specify GL API XML file
""" % (program))
exit(1)
if __name__ == '__main__':
try:
(opts, args) = getopt.getopt(sys.argv[1:], "f:")
except Exception,e:
show_usage()
if len(args) != 0:
show_usage()
api_desc_file = ""
for opt_name, opt_val in opts:
if opt_name == "-f":
api_desc_file = opt_val
if not api_desc_file:
die("missing descriptor file (-f)\n")
# generate the code for all APIs
enabled_apis = set(["GLES", "GLES2", "GLES3", "GLES31", "GLES32",
"GL", "GL_CORE"])
try:
api_desc = gl_XML.parse_GL_API(api_desc_file)
except Exception:
die("couldn't parse API specification file %s\n" % api_desc_file)
(params, hash_tables) = generate_hash_tables(api_desc.enums_by_name,
enabled_apis, get_hash_params.descriptor)
print_header()
print_params(params)
print_tables(hash_tables)