CultLib/packages/cultmath/tools/glsl/wrappers.py
Meta Vens 51f284ac6c wrappers.py: array arguments by declarator name, a capacity column, a refusal for CULTMATH_MAX_SITES outside its guard
Does not build alone: spvedit.py still reads four columns until the next commit.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-17 21:36:31 +02:00

51 lines
2.8 KiB
Python

#!/usr/bin/env python3
"""Build-only export wrappers: one exported, uniquely named wrapper per top-level cultmath_ definition, so dxc keeps
every overload as its own function. The shaders are copied unchanged; the unique names exist only in <outdir>.
usage: wrappers.py <shaders> <outdir>
Writes <outdir>/cm_wrappers.hlsl and <outdir>/wrappers.tsv (wrapper, name, file, params, capacity). An argument is the
parameter's declarator name with any [..] suffix removed; capacity lists the indices of the parameters declared
[CULTMATH_MAX_SITES]. Definitions with a Texture or Sampler parameter get no wrapper. Refuses a file where the
definition-looking lines differ from the parsed ones, and a file that names CULTMATH_MAX_SITES anywhere but its
#ifndef/#define/#endif guard and array declarators."""
import os, re, shutil, sys
FILES = ['CultMath.hlsl', 'CultMath.Interval.hlsl', 'CultMath.Affine.hlsl', 'CultMath.Cycles.hlsl', 'CultMath.Phacelle.hlsl']
SIG = re.compile(r'(?m)^(\w+)[ \t]+(cultmath_\w+)[ \t]*\(([^)]*)\)')
LOOKS = re.compile(r'(?m)^\w+ cultmath_\w+\(')
GUARD = re.compile(r'#ifndef CULTMATH_MAX_SITES\n#define CULTMATH_MAX_SITES \d+\n#endif\n')
COMMENT = re.compile(r'//[^\n]*|/\*.*?\*/', re.S)
CAP = '[CULTMATH_MAX_SITES]'
def main(shaders, out):
shutil.copytree(shaders, out, dirs_exist_ok=True)
wrappers = ['#include "CultMath.hlsl"']
rows = []
for fn in FILES:
text = open(os.path.join(shaders, fn)).read().replace('\r\n', '\n')
stray = GUARD.sub('', COMMENT.sub('', text)).replace(CAP, '')
if 'CULTMATH_MAX_SITES' in stray:
sys.exit('refuse: %s names CULTMATH_MAX_SITES outside its guard and array declarators' % fn)
parsed = list(SIG.finditer(text))
looks = len(LOOKS.findall(text))
if looks != len(parsed):
sys.exit('refuse: %s has %d definition-looking lines but %d parsed' % (fn, looks, len(parsed)))
for m in parsed:
ret, name, ps = m.groups()
if re.search(r'Texture|Sampler', ps):
continue
params = [p.strip() for p in ps.split(',') if p.strip()]
args = [re.split(r'\s+', p)[-1].split('[')[0] for p in params]
cap = ','.join(str(i) for i, p in enumerate(params) if p.endswith(CAP))
wn = 'cmw%03d_%s' % (len(rows), name)
call = '%s(%s)' % (name, ', '.join(args))
wrappers.append('export %s %s(%s) { %s%s; }' % (ret, wn, ', '.join(params), '' if ret == 'void' else 'return ', call))
rows.append('\t'.join([wn, name, fn, ', '.join(params), cap]))
open(os.path.join(out, 'cm_wrappers.hlsl'), 'w').write('\n'.join(wrappers) + '\n')
open(os.path.join(out, 'wrappers.tsv'), 'w').write('\n'.join(rows) + '\n')
print('wrappers', len(rows))
if __name__ == '__main__':
main(*sys.argv[1:3])