121 lines
7.6 KiB
Python
121 lines
7.6 KiB
Python
#!/usr/bin/env python3
|
|
"""Prepare local scene/audio assets without modifying the original installation."""
|
|
import argparse
|
|
import json
|
|
from pathlib import Path
|
|
|
|
from omt import Database, export_scene, extract
|
|
from ase import export_ase
|
|
from png import read_png
|
|
from entities import prepare_entities
|
|
from models import prepare_models
|
|
from ui import export_ui
|
|
from gadget_resources import export_gadget_resources
|
|
from sound_bank import export_sound_bank
|
|
|
|
|
|
def find_archive(original: Path, name: str) -> Path:
|
|
matches = [p for p in (original / 'omt').iterdir()
|
|
if p.name.casefold() == (name if name.casefold().endswith('.omt') else name + '.omt').casefold()]
|
|
if len(matches) != 1:
|
|
raise ValueError(f'Expected exactly one archive for {name}, found {len(matches)}')
|
|
return matches[0]
|
|
|
|
|
|
def prepare_actor(original: Path, output: Path, name: str, texture_name: str, actions: dict, base_name: str | None = None,
|
|
ignored_animations: tuple[str, ...] = ()):
|
|
"""Explicit EXE registration mappings; no texture guessed from ASE adjacency."""
|
|
target = output / 'actors' / name
|
|
target.mkdir(parents=True, exist_ok=True)
|
|
texture_source = next(p for p in (original/'png').iterdir() if p.name.casefold() == texture_name.casefold())
|
|
texture = read_png(texture_source)
|
|
(target/'texture.rgba').write_bytes(texture.pop('rgba'))
|
|
base_name = base_name or next(iter(actions.values()))
|
|
base = next(p for p in (original/'ASE').iterdir() if p.stem.casefold() == base_name.casefold())
|
|
for stem in dict.fromkeys(actions.values()):
|
|
source = next(p for p in (original/'ASE').iterdir() if p.stem.casefold() == stem.casefold())
|
|
manifest = export_ase(source, target/stem, base)
|
|
manifest['texture'] = {'path': '../texture.rgba', **texture}
|
|
(target/stem/'animation.json').write_text(json.dumps(manifest, indent=2)+'\n')
|
|
(target/'family.json').write_text(json.dumps({'default': next(iter(actions)),
|
|
'actions': {key: value+'/animation.json' for key, value in actions.items()},
|
|
'ignoredAnimations': list(ignored_animations)}, indent=2)+'\n')
|
|
|
|
|
|
def main():
|
|
parser = argparse.ArgumentParser(description=__doc__)
|
|
parser.add_argument('--original', type=Path, default=Path('../Original'))
|
|
parser.add_argument('--output', type=Path, default=Path('artifacts/extracted'))
|
|
parser.add_argument('--scenes', nargs='+', default=['level1b', 'VR01'])
|
|
parser.add_argument('--all-scenes', action='store_true', help='Prepare every supplied GAM/OMT scene pair')
|
|
parser.add_argument('--audio', nargs='*', default=['sounds', 'musicjimmyshouse', 'musicneighborhood'])
|
|
parser.add_argument('--animations', nargs='*', default=['jimstop', 'jimrun', 'jimjump', 'jimscratch', 'jimbackpedal', 'jimfall', 'jimtalk', 'jimfly', 'jimshoot'])
|
|
args = parser.parse_args()
|
|
if args.output.resolve().is_relative_to(args.original.resolve()):
|
|
parser.error('Output must be outside the original installation')
|
|
if args.all_scenes:
|
|
args.scenes = sorted((p.stem for p in (args.original/'gam').iterdir() if p.suffix.casefold()=='.gam'), key=str.casefold)
|
|
catalog = {'prepared': [], 'unavailable': []}
|
|
for name in args.scenes:
|
|
try:
|
|
source = find_archive(args.original, name)
|
|
except ValueError:
|
|
if not args.all_scenes:
|
|
raise
|
|
# GAM entities and OMT geometry are distinct. The executable registers
|
|
# level3b/3e, but their use in normal progression is not established.
|
|
# Report the absent geometry without calling it required game content.
|
|
catalog['unavailable'].append({'level': name+'.gam', 'archive': name+'.omt',
|
|
'reason': 'GAM supplied; matching geometry archive absent; gameplay use unverified'})
|
|
print(f'{name}.gam is supplied; no matching {name}.omt geometry archive '
|
|
'(gameplay use unverified; no substitution)')
|
|
continue
|
|
scene = export_scene(Database(source), args.output / source.stem)
|
|
print(f"{source.name}: {len(scene['indices'])//3} triangles, {len(scene['textures'])} textures")
|
|
report = prepare_entities(args.original, source.stem + '.gam', args.output / source.stem / 'entities', True)
|
|
print(f"{report['level']}: {len(report['resources'])} explicit entity resources")
|
|
models = prepare_models(args.original, source.stem + '.gam', args.output / source.stem / 'models')
|
|
print(f"{models['level']}: {len(models['actors'])} model actors; {len(models['unresolved'])} unresolved bindings")
|
|
catalog['prepared'].append({'level': name+'.gam', 'archive': source.name, 'scene': source.stem+'/scene.json'})
|
|
(args.output/'scene-catalog.json').write_text(json.dumps(catalog, indent=2)+'\n')
|
|
export_ui(Database(find_archive(args.original, 'screens')), args.output / 'ui', Database(args.original / 'alpha.omt'))
|
|
export_gadget_resources(Database(find_archive(args.original, 'screens')), args.output / 'gadgets')
|
|
effects = export_sound_bank(args.original, args.output / 'effects')
|
|
print(f"SoundEffects.omt: {len(effects['resources'])} original sound identities")
|
|
for name in args.audio:
|
|
source = find_archive(args.original, name)
|
|
report = extract(Database(source), args.output / source.stem)
|
|
count = sum(1 for e in report['entries'] if 'audio' in e)
|
|
print(f'{source.name}: {count} audio resources')
|
|
if args.animations:
|
|
texture_source = next(p for p in (args.original/'png').iterdir() if p.name.casefold()=='jimycarl.png')
|
|
texture = read_png(texture_source)
|
|
target = args.output/'animations'
|
|
target.mkdir(parents=True,exist_ok=True)
|
|
(target/'jimycarl.rgba').write_bytes(texture.pop('rgba'))
|
|
base = next(p for p in (args.original/'ASE').iterdir() if p.name.casefold()=='jimstop.ase')
|
|
for name in args.animations:
|
|
matches = [p for p in (args.original/'ASE').iterdir() if p.stem.casefold()==name.casefold() and p.suffix.casefold()=='.ase']
|
|
if len(matches)!=1: raise ValueError(f'Expected one ASE for {name}')
|
|
manifest = export_ase(matches[0],target/name,base)
|
|
manifest['texture'] = {'path':'../jimycarl.rgba', **texture}
|
|
(target/name/'animation.json').write_text(json.dumps(manifest,indent=2)+'\n',encoding='utf-8')
|
|
print(f"{matches[0].name}: {len(manifest['frames'])} animation samples")
|
|
# EXE413D8C..413DF9 (Carl);41CDA0..41CE5F (Goddard high-detail clips).
|
|
prepare_actor(args.original, args.output, 'carl', 'carl.png', {
|
|
'STOP': 'carlstop', 'WALK': 'carlwalk', 'TALK': 'carltalk', 'INHALE': 'carlinhale',
|
|
'CHEER': 'carlcheer', 'TELE': 'carlteleport'})
|
|
prepare_actor(args.original, args.output, 'goddard', 'goddard02.png', {
|
|
'SIT': 'godsit', 'RUN': 'godrun', 'GROWL': 'godgrowl', 'WAG': 'godwag',
|
|
'EAT': 'godeat', 'FLY': 'godfly', 'POINT': 'godpoint'}, 'godpoint', ('STOP', 'WALK', 'TALK'))
|
|
prepare_actor(args.original, args.output, 'trophy', 'trophy.png', {'STOP': 'trophy'})
|
|
# C3DJetpackFire421F30..96: DEFAULT fire.ase, HINONE fire2.ase, fire.png.
|
|
prepare_actor(args.original, args.output, 'jetpack', 'fire.png', {'DEFAULT': 'fire', 'NONE': 'fire2'}, 'fire')
|
|
#Recovered C3DShrinkRay440000 and3SOL44C0B0 bindings; see docs/gameplay/.
|
|
prepare_actor(args.original, args.output, 'shrink-ray', 'ray0000.png', {'RAY': 'ray'})
|
|
prepare_actor(args.original, args.output, 'soldier', 'yoksold.png', {'WALK': 'soldwalk', 'SHRINK': 'soldshrink'}, 'soldatak')
|
|
prepare_actor(args.original, args.output, 'soldier-vr', 'vryoksoldier.png', {'WALK': 'soldwalk', 'SHRINK': 'soldshrink'}, 'soldatak')
|
|
|
|
|
|
if __name__ == '__main__': main()
|