#! /usr/bin/env python3
import argparse
import io
import json
import math
import os
import os.path
import sys
import textwrap
from PIL import Image, ImageDraw # type: ignore
from typing import Any, Dict, List, Optional, Tuple, TypeVar
from bemani.format.afp import TXP2File, Shape, SWF, Frame, Tag, AP2DoActionTag, AP2PlaceObjectTag, AP2DefineSpriteTag, AFPRenderer, Color, Matrix
from bemani.format import IFS
def write_bytecode(swf: SWF, directory: str, *, verbose: bool) -> None:
# Actually place the files down.
os.makedirs(directory, exist_ok=True)
# Buffer for where the decompiled data goes.
buff: List[str] = []
lut: Dict[str, int] = {}
def bytecode_from_frames(frames: List[Frame]) -> None:
for frame in frames:
for tag in frame.imported_tags:
if tag.init_bytecode:
buff.append(tag.init_bytecode.decompile(verbose=verbose))
def bytecode_from_tags(tags: List[Tag]) -> None:
for tag in tags:
if isinstance(tag, AP2DoActionTag):
buff.append(tag.bytecode.decompile(verbose=verbose))
elif isinstance(tag, AP2PlaceObjectTag):
for _, triggers in tag.triggers.items():
for trigger in triggers:
buff.append(trigger.decompile(verbose=verbose))
elif isinstance(tag, AP2DefineSpriteTag):
lut.update(tag.labels)
bytecode_from_frames(tag.frames)
bytecode_from_tags(tag.tags)
lut.update(swf.labels)
bytecode_from_frames(swf.frames)
bytecode_from_tags(swf.tags)
# If we have frame labels, put them at the top as global defines.
if lut:
buff = [
os.linesep.join([
'// Defined frame labels from animation container, as used for frame lookups.',
'FRAME_LUT = {',
*[f" {name!r}: {frame}," for name, frame in lut.items()],
'};',
]),
*buff,
]
# Now, write it out.
filename = os.path.join(directory, swf.exported_name) + ".code"
print(f"Writing code to {filename}...")
with open(filename, "wb") as bfp:
bfp.write(f"{os.linesep}{os.linesep}".join(buff).encode('utf-8'))
def parse_intlist(data: str) -> List[int]:
ints: List[int] = []
for chunk in data.split(","):
chunk = chunk.strip()
if '-' in chunk:
start, end = chunk.split('-', 1)
start_int = int(start.strip())
end_int = int(end.strip())
ints.extend(range(start_int, end_int + 1))
else:
ints.append(int(chunk))
return sorted(set(ints))
def extract_txp2(
fname: str,
output_dir: str,
*,
split_textures: bool=False,
generate_mapping_overlays: bool=False,
write_mappings: bool=False,
write_raw: bool=False,
write_binaries: bool=False,
pretend: bool=False,
verbose: bool=False,
) -> int:
if split_textures:
if write_raw:
raise Exception("Cannot write raw textures when splitting sprites!")
if generate_mapping_overlays:
raise Exception("Cannot generate mapping overlays when splitting sprites!")
with open(fname, "rb") as bfp:
afpfile = TXP2File(bfp.read(), verbose=verbose)
# Actually place the files down.
os.makedirs(output_dir, exist_ok=True)
if not split_textures:
for texture in afpfile.textures:
filename = os.path.join(output_dir, texture.name)
if texture.img:
if pretend:
print(f"Would write {filename}.png texture...")
else:
print(f"Writing {filename}.png texture...")
with open(f"{filename}.png", "wb") as bfp:
texture.img.save(bfp, format='PNG')
if not texture.img or write_raw:
if pretend:
print(f"Would write {filename}.raw texture...")
else:
print(f"Writing {filename}.raw texture...")
with open(f"{filename}.raw", "wb") as bfp:
bfp.write(texture.raw)
if pretend:
print(f"Would write {filename}.xml texture info...")
else:
print(f"Writing {filename}.xml texture info...")
with open(f"{filename}.xml", "w") as sfp:
sfp.write(textwrap.dedent(f"""
{texture.width}
{texture.height}
{hex(texture.fmt)}
{filename}.raw
""").strip())
if write_mappings:
if not split_textures:
for i, name in enumerate(afpfile.regionmap.entries):
if i < 0 or i >= len(afpfile.texture_to_region):
raise Exception(f"Out of bounds region {i}")
region = afpfile.texture_to_region[i]
texturename = afpfile.texturemap.entries[region.textureno]
filename = os.path.join(output_dir, name)
if pretend:
print(f"Would write {filename}.xml region information...")
else:
print(f"Writing {filename}.xml region information...")
with open(f"{filename}.xml", "w") as sfp:
sfp.write(textwrap.dedent(f"""
{region.left}
{region.top}
{region.right}
{region.bottom}
{texturename}
""").strip())
if afpfile.fontdata is not None:
filename = os.path.join(output_dir, "fontinfo.xml")
if pretend:
print(f"Would write {filename} font information...")
else:
print(f"Writing {filename} font information...")
with open(filename, "w") as sfp:
sfp.write(str(afpfile.fontdata))
if write_binaries:
for i, name in enumerate(afpfile.swfmap.entries):
swf = afpfile.swfdata[i]
filename = os.path.join(output_dir, name)
if pretend:
print(f"Would write {filename}.afp animation data...")
print(f"Would write {filename}.bsi animation descramble data...")
else:
print(f"Writing {filename}.afp animation data...")
with open(f"{filename}.afp", "wb") as bfp:
bfp.write(swf.data)
print(f"Writing {filename}.bsi animation descramble data...")
with open(f"{filename}.bsi", "wb") as bfp:
bfp.write(swf.descramble_info)
for i, name in enumerate(afpfile.shapemap.entries):
shape = afpfile.shapes[i]
filename = os.path.join(output_dir, f"{name}.geo")
if pretend:
print(f"Would write {filename} shape data...")
else:
print(f"Writing {filename} shape data...")
with open(filename, "wb") as bfp:
bfp.write(shape.data)
if generate_mapping_overlays:
overlays: Dict[str, Any] = {}
for i, name in enumerate(afpfile.regionmap.entries):
if i < 0 or i >= len(afpfile.texture_to_region):
raise Exception(f"Out of bounds region {i}")
region = afpfile.texture_to_region[i]
texturename = afpfile.texturemap.entries[region.textureno]
if texturename not in overlays:
for texture in afpfile.textures:
if texture.name == texturename:
overlays[texturename] = Image.new(
'RGBA',
(texture.width, texture.height),
(0, 0, 0, 0),
)
break
else:
raise Exception(f"Couldn't find texture {texturename}")
draw = ImageDraw.Draw(overlays[texturename])
draw.rectangle(
((region.left // 2, region.top // 2), (region.right // 2, region.bottom // 2)),
fill=(0, 0, 0, 0),
outline=(255, 0, 0, 255),
width=1,
)
draw.text(
(region.left // 2, region.top // 2),
name,
fill=(255, 0, 255, 255),
)
for name, img in overlays.items():
filename = os.path.join(output_dir, name) + "_overlay.png"
if pretend:
print(f"Would write {filename} overlay...")
else:
print(f"Writing {filename} overlay...")
with open(filename, "wb") as bfp:
img.save(bfp, format='PNG')
if split_textures:
textures: Dict[str, Any] = {}
announced: Dict[str, bool] = {}
for i, name in enumerate(afpfile.regionmap.entries):
if i < 0 or i >= len(afpfile.texture_to_region):
raise Exception(f"Out of bounds region {i}")
region = afpfile.texture_to_region[i]
texturename = afpfile.texturemap.entries[region.textureno]
if texturename not in textures:
for tex in afpfile.textures:
if tex.name == texturename:
textures[texturename] = tex
break
else:
raise Exception("Could not find texture {texturename} to split!")
if textures[texturename].img:
# Grab the location in the image, save it out to a new file.
filename = f"{texturename}_{name}.png"
filename = os.path.join(output_dir, filename)
if pretend:
print(f"Would write {filename} sprite...")
else:
print(f"Writing {filename} sprite...")
sprite = textures[texturename].img.crop(
(region.left // 2, region.top // 2, region.right // 2, region.bottom // 2),
)
with open(filename, "wb") as bfp:
sprite.save(bfp, format='PNG')
else:
if not announced.get(texturename, False):
print(f"Cannot extract sprites from {texturename} because it is not a supported format!")
announced[texturename] = True
if write_bytecode:
for swf in afpfile.swfdata:
write_bytecode(swf, output_dir, verbose=verbose)
return 0
def update_txp2(fname: str, update_dir: str, *, pretend: bool=False, verbose: bool=False) -> int:
# First, parse the file out
with open(fname, "rb") as bfp:
afpfile = TXP2File(bfp.read(), verbose=verbose)
# Now, find any PNG files that match texture names.
for texture in afpfile.textures:
filename = os.path.join(update_dir, texture.name) + ".png"
if os.path.isfile(filename):
print(f"Updating {texture.name} from {filename}...")
with open(filename, "rb") as bfp:
afpfile.update_texture(texture.name, bfp.read())
# Now, find any PNG files that match a specific sprite.
for i, spritename in enumerate(afpfile.regionmap.entries):
if i < 0 or i >= len(afpfile.texture_to_region):
raise Exception(f"Out of bounds region {i}")
region = afpfile.texture_to_region[i]
texturename = afpfile.texturemap.entries[region.textureno]
# Grab the location in the image to see if it exists.
filename = f"{texturename}_{spritename}.png"
filename = os.path.join(update_dir, filename)
if os.path.isfile(filename):
print(f"Updating {texturename} sprite piece {spritename} from {filename}...")
with open(filename, "rb") as bfp:
afpfile.update_sprite(texturename, spritename, bfp.read())
# Now, write out the updated file
if pretend:
print(f"Would write {fname}...")
afpfile.unparse()
else:
print(f"Writing {fname}...")
data = afpfile.unparse()
with open(fname, "wb") as bfp:
bfp.write(data)
return 0
def print_txp2(fname: str, *, decompile_bytecode: bool=False, verbose: bool=False) -> int:
# First, parse the file out
with open(fname, "rb") as bfp:
afpfile = TXP2File(bfp.read(), verbose=verbose)
# Now, print it
print(json.dumps(afpfile.as_dict(decompile_bytecode=decompile_bytecode, verbose=verbose), sort_keys=True, indent=4))
return 0
def parse_afp(afp: str, bsi: str, *, decompile_bytecode: bool=False, verbose: bool=False) -> int:
# First, load the AFP and BSI files
with open(afp, "rb") as bafp:
with open(bsi, "rb") as bbsi:
swf = SWF("", bafp.read(), bbsi.read())
# Now, print it
swf.parse(verbose=verbose)
print(json.dumps(swf.as_dict(decompile_bytecode=decompile_bytecode, verbose=verbose), sort_keys=True, indent=4))
return 0
def decompile_afp(afp: str, bsi: str, output_dir: str, *, decompile_bytecode: bool=False, verbose: bool=False) -> int:
# First, load the AFP and BSI files
with open(afp, "rb") as bafp:
with open(bsi, "rb") as bbsi:
swf = SWF("", bafp.read(), bbsi.read())
# Now, decompile it
swf.parse(verbose=verbose)
write_bytecode(swf, output_dir, verbose=verbose)
return 0
def parse_geo(geo: str, *, verbose: bool=False) -> int:
# First, load the AFP and BSI files
with open(geo, "rb") as bfp:
shape = Shape("", bfp.read())
# Now, print it
shape.parse()
if verbose:
print(shape, file=sys.stderr)
print(json.dumps(shape.as_dict(), sort_keys=True, indent=4))
return 0
def load_containers(renderer: AFPRenderer, containers: List[str], *, need_extras: bool, verbose: bool) -> None:
# This is a complicated one, as we need to be able to specify multiple
# directories of files as well as support IFS files and TXP2 files.
for container in containers:
with open(container, "rb") as bfp:
data = bfp.read()
afpfile = None
try:
afpfile = TXP2File(data, verbose=verbose)
except Exception:
pass
if afpfile is not None:
if verbose:
print(f"Loading files out of TXP2 container {container}...", file=sys.stderr)
if need_extras:
# First, load GE2D structures into the renderer.
for i, name in enumerate(afpfile.shapemap.entries):
shape = afpfile.shapes[i]
renderer.add_shape(name, shape)
if verbose:
print(f"Added {name} to animation shape library.", file=sys.stderr)
# Now, split and load textures into the renderer.
sheets: Dict[str, Any] = {}
for i, name in enumerate(afpfile.regionmap.entries):
if i < 0 or i >= len(afpfile.texture_to_region):
raise Exception(f"Out of bounds region {i}")
region = afpfile.texture_to_region[i]
texturename = afpfile.texturemap.entries[region.textureno]
if texturename not in sheets:
for tex in afpfile.textures:
if tex.name == texturename:
sheets[texturename] = tex
break
else:
raise Exception("Could not find texture {texturename} to split!")
if sheets[texturename].img:
sprite = sheets[texturename].img.crop(
(region.left // 2, region.top // 2, region.right // 2, region.bottom // 2),
)
renderer.add_texture(name, sprite)
if verbose:
print(f"Added {name} to animation texture library.", file=sys.stderr)
else:
print(f"Cannot load {name} from {texturename} because it is not a supported format!")
# Finally, load the animation data itself into the renderer.
for i, name in enumerate(afpfile.swfmap.entries):
swf = afpfile.swfdata[i]
renderer.add_swf(name, swf)
if verbose:
print(f"Added {name} to animation library.", file=sys.stderr)
continue
ifsfile = None
try:
ifsfile = IFS(data, decode_textures=True)
except Exception:
pass
if ifsfile is not None:
if verbose:
print(f"Loading files out of IFS container {container}...", file=sys.stderr)
for fname in ifsfile.filenames:
if fname.startswith(f"geo{os.sep}"):
if not need_extras:
continue
# Trim off directory.
shapename = fname[(3 + len(os.sep)):]
# Load file, register it.
fdata = ifsfile.read_file(fname)
shape = Shape(shapename, fdata)
renderer.add_shape(shapename, shape)
if verbose:
print(f"Added {shapename} to animation shape library.", file=sys.stderr)
elif fname.startswith(f"tex{os.sep}") and fname.endswith(".png"):
if not need_extras:
continue
# Trim off directory, png extension.
texname = fname[(3 + len(os.sep)):][:-4]
# Load file, register it.
fdata = ifsfile.read_file(fname)
tex = Image.open(io.BytesIO(fdata))
renderer.add_texture(texname, tex)
if verbose:
print(f"Added {texname} to animation texture library.", file=sys.stderr)
elif fname.startswith(f"afp{os.sep}"):
# Trim off directory, see if it has a corresponding bsi.
afpname = fname[(3 + len(os.sep)):]
bsipath = f"afp{os.sep}bsi{os.sep}{afpname}"
if bsipath in ifsfile.filenames:
afpdata = ifsfile.read_file(fname)
bsidata = ifsfile.read_file(bsipath)
flash = SWF(afpname, afpdata, bsidata)
renderer.add_swf(afpname, flash)
if verbose:
print(f"Added {afpname} to animation library.", file=sys.stderr)
continue
def list_paths(containers: List[str], *, include_frames: bool=False, include_size: bool=False, verbose: bool=False) -> int:
renderer = AFPRenderer()
load_containers(renderer, containers, need_extras=False, verbose=verbose)
for path in renderer.list_paths(verbose=verbose):
display = path
if include_size:
location = renderer.compute_path_size(path)
display = f"{display} - {int(location.width)}x{int(location.height)}"
if include_frames:
frames = renderer.compute_path_frames(path)
display = f"{display} - {frames} frames"
print(display)
return 0
BackgroundT = TypeVar("BackgroundT")
def adjust_background_loop(
background: List[BackgroundT],
background_loop_start: Optional[int] = None,
background_loop_end: Optional[int] = None,
background_loop_offset: Optional[int] = None,
) -> List[BackgroundT]:
# Make sure background frames are 1-indexed here as well.
if background_loop_start is None:
background_loop_start = 0
else:
background_loop_start -= 1
if background_loop_offset is None:
background_loop_offset = 0
else:
background_loop_offset -= (background_loop_start + 1)
# Don't one-index the end because we want it to be inclusive.
if background_loop_end is None:
background_loop_end = len(background)
if background_loop_start >= background_loop_end:
raise Exception("Cannot start background loop after the end of the background loop!")
if background_loop_start < 0 or background_loop_end < 0:
raise Exception("Cannot start or end background loop on a negative frame!")
if background_loop_start >= len(background) or background_loop_end > len(background):
raise Exception("Cannot start or end background loop larger than the number of background animation frames!")
background = background[background_loop_start:background_loop_end]
if background_loop_offset < 0 or background_loop_offset >= len(background):
raise Exception("Cannot start first iteration of background loop outside the loop bounds!")
return background[background_loop_offset:] + background[:background_loop_offset]
def render_path(
containers: List[str],
path: str,
output: str,
*,
disable_threads: bool = False,
enable_anti_aliasing: bool = False,
background_color: Optional[str] = None,
background_image: Optional[str] = None,
background_loop_start: Optional[int] = None,
background_loop_end: Optional[int] = None,
background_loop_offset: Optional[int] = None,
force_width: Optional[int] = None,
force_height: Optional[int] = None,
force_aspect_ratio: Optional[str] = None,
scale_width: float = 1.0,
scale_height: float = 1.0,
only_depths: Optional[str] = None,
only_frames: Optional[str] = None,
verbose: bool = False,
show_progress: bool = False,
) -> int:
if show_progress:
print("Loading textures, shapes and animation instructions...")
renderer = AFPRenderer(single_threaded=disable_threads, enable_aa=enable_anti_aliasing)
load_containers(renderer, containers, need_extras=True, verbose=verbose)
if show_progress:
print("Calculating render parameters...")
# Verify the correct params.
if output.lower().endswith(".gif"):
fmt = "GIF"
elif output.lower().endswith(".webp"):
fmt = "WEBP"
elif output.lower().endswith(".png"):
fmt = "PNG"
else:
raise Exception("Unrecognized file extension for output!")
# Allow overriding background color.
if background_color:
colorvals = background_color.split(",")
if len(colorvals) not in [3, 4]:
raise Exception("Invalid color, specify a color as a comma-separated RGB or RGBA value!")
if len(colorvals) == 3:
colorvals.append("255")
colorints = [int(c.strip()) for c in colorvals]
for c in colorints:
if c < 0 or c > 255:
raise Exception("Color values should be between 0 and 255!")
color = Color(*[c / 255.0 for c in colorints])
else:
color = None
# Allow inserting a background image, series of images or animation.
if background_image:
background_image = os.path.abspath(background_image)
background: List[Image.Image] = []
if os.path.isfile(background_image):
# This is a direct reference, open it.
with open(background_image, "rb") as bfp:
# Work around the fact that PIL does not read the image until first use,
# meaning a long background image sequence can blow past max open files.
bgimg = Image.open(io.BytesIO(bfp.read()))
frames = getattr(bgimg, "n_frames", 1)
if frames == 1:
background.append(bgimg)
elif frames > 1:
for frame in range(frames):
bgimg.seek(frame)
background.append(bgimg.copy())
else:
raise Exception("Invalid image specified as background!")
else:
# This is probably a reference to a list of images.
dirof, fileof = os.path.split(background_image)
startof, endof = os.path.splitext(fileof)
if len(startof) == 0 or len(endof) == 0:
raise Exception("Invalid image specified as background!")
startof = startof + '-'
# Gather up the sequence of files so we can make frames out of them.
seqdict: Dict[int, str] = {}
for filename in os.listdir(dirof):
if filename.startswith(startof) and filename.endswith(endof):
seqno = filename[len(startof):(-len(endof))]
if seqno.isdigit():
seqint = int(seqno)
if seqint in seqdict:
raise Exception(f"{filename} specifies the same background frame number as {seqdict[seqint]}!")
seqdict[seqint] = filename
# Now, order the sequence by the integer of the sequence number so we can load the images.
seqtuple: List[Tuple[int, str]] = sorted(
[(s, p) for (s, p) in seqdict.items()],
key=lambda e: e[0],
)
# Finally, get the filenames from this sequence.
filenames: List[str] = [os.path.join(dirof, filename) for (_, filename) in seqtuple]
# Now that we have the list, lets load the images!
for filename in filenames:
with open(filename, "rb") as bfp:
# Work around the fact that PIL does not read the image until first use,
# meaning a long background image sequence can blow past max open files.
bgimg = Image.open(io.BytesIO(bfp.read()))
frames = getattr(bgimg, "n_frames", 1)
if frames == 1:
background.append(bgimg)
elif frames > 1:
for frame in range(frames):
bgimg.seek(frame)
background.append(bgimg.copy())
else:
raise Exception("Invalid image specified as background!")
background = adjust_background_loop(background, background_loop_start, background_loop_end, background_loop_offset)
else:
background = None
# Calculate the size of the animation so we can apply scaling options.
swf_location = renderer.compute_path_location(path)
requested_width = force_width if force_width is not None else swf_location.width
requested_height = force_height if force_height is not None else swf_location.height
# Allow overriding the aspect ratio.
if force_aspect_ratio:
ratio = force_aspect_ratio.split(":")
if len(ratio) != 2:
raise Exception("Invalid aspect ratio, specify a ratio such as 16:9 or 4:3!")
rx, ry = [float(r.strip()) for r in ratio]
if rx <= 0 or ry <= 0:
raise Exception("Ratio must only include positive numbers!")
actual_ratio = rx / ry
swf_ratio = swf_location.width / swf_location.height
if abs(swf_ratio - actual_ratio) > 0.0001:
new_width = actual_ratio * swf_location.height
new_height = swf_location.width / actual_ratio
if new_width < swf_location.width and new_height < swf_location.height:
raise Exception("Impossible aspect ratio!")
if new_width > swf_location.width and new_height > swf_location.height:
raise Exception("Impossible aspect ratio!")
# We know that one is larger and one is smaller, pick the larger.
# This way we always stretch instead of shrinking.
if new_width > swf_location.width:
requested_width = new_width
else:
requested_height = new_height
# Finally, apply requested final scaling.
requested_width *= scale_width
requested_height *= scale_height
# Calculate the overall view matrix based on the requested width/height.
transform = Matrix.affine(
a=requested_width / swf_location.width,
b=0.0,
c=0.0,
d=requested_height / swf_location.height,
tx=0.0,
ty=0.0,
)
# Support rendering only certain depth planes.
if only_depths is not None:
requested_depths = parse_intlist(only_depths)
else:
requested_depths = None
# Support rendering only certain frames.
if only_frames is not None:
requested_frames = parse_intlist(only_frames)
else:
requested_frames = None
if fmt in ["GIF", "WEBP"]:
# Write all the frames out in one file.
duration = renderer.compute_path_frame_duration(path)
frames = renderer.compute_path_frames(path)
images: List[Image] = []
for i, img in enumerate(
renderer.render_path(
path,
verbose=verbose,
background_color=color,
background_image=background,
only_depths=requested_depths,
only_frames=requested_frames,
movie_transform=transform,
)
):
if show_progress:
frameno = requested_frames[i] if requested_frames is not None else (i + 1)
print(f"Rendered animation frame {frameno}/{frames}.")
images.append(img)
if len(images) > 0:
try:
dirof = os.path.dirname(os.path.abspath(output))
os.makedirs(dirof, exist_ok=True)
except FileNotFoundError:
# Apparently on OSX this is possible?
pass
with open(output, "wb") as bfp:
images[0].save(bfp, format=fmt, save_all=True, append_images=images[1:], duration=duration, optimize=True)
print(f"Wrote animation to {output}")
else:
# Write all the frames out in individual_files.
filename = output[:-4]
ext = output[-4:]
# Figure out padding for the images.
frames = renderer.compute_path_frames(path)
if frames > 0:
digits = f"0{int(math.log10(frames)) + 1}"
for i, img in enumerate(
renderer.render_path(
path,
verbose=verbose,
background_color=color,
background_image=background,
only_depths=requested_depths,
only_frames=requested_frames,
movie_transform=transform,
)
):
frameno = requested_frames[i] if requested_frames is not None else (i + 1)
fullname = f"{filename}-{frameno:{digits}}{ext}"
try:
dirof = os.path.dirname(os.path.abspath(fullname))
os.makedirs(dirof, exist_ok=True)
except FileNotFoundError:
# Apparently on OSX this is possible?
pass
with open(fullname, "wb") as bfp:
img.save(bfp, format=fmt)
print(f"Wrote animation frame to {fullname}")
return 0
def main() -> int:
parser = argparse.ArgumentParser(description="Konami AFP graphic file unpacker/repacker.")
subparsers = parser.add_subparsers(help='Action to take', dest='action')
extract_parser = subparsers.add_parser(
'extract',
help='Extract relevant file data and textures from a TXP2 container',
description="Extract textures, sprites, decompiled bytecode, AFP, BSI and GEO files from a TXP2 container.",
)
extract_parser.add_argument(
"file",
metavar="FILE",
help="The TXP2 container to extract",
)
extract_parser.add_argument(
"dir",
metavar="DIR",
help="The directory to extract all contents to",
)
extract_parser.add_argument(
"-p",
"--pretend",
action="store_true",
help="Pretend to extract instead of extracting, printing what would have been extracted",
)
extract_parser.add_argument(
"-v",
"--verbose",
action="store_true",
help="Display verbose debugging output",
)
extract_parser.add_argument(
"-r",
"--write-raw",
action="store_true",
help="Always write raw texture data instead of only writing raw texture data for unrecognized texture formats",
)
extract_parser.add_argument(
"-m",
"--write-mappings",
action="store_true",
help="Write mapping files to disk as XML files",
)
extract_parser.add_argument(
"-g",
"--generate-mapping-overlays",
action="store_true",
help="Generate overlay images showing mappings between textures and individual sprites",
)
extract_parser.add_argument(
"-s",
"--split-textures",
action="store_true",
help="Split textures into individual sprite image files",
)
extract_parser.add_argument(
"-b",
"--write-binaries",
action="store_true",
help="Write raw AFP/BSI/GEO files to disk",
)
extract_parser.add_argument(
"-y",
"--write-bytecode",
action="store_true",
help="Write decompiled bytecode files found in AFP files to disk",
)
update_parser = subparsers.add_parser(
'update',
help='Update relevant textures in a TXP2 container from a directory',
description="Update textures and sprites in a TXP2 container based on images in a directory.",
)
update_parser.add_argument(
"file",
metavar="FILE",
help="The TXP2 container to update",
)
update_parser.add_argument(
"dir",
metavar="DIR",
help="Directory to update all contents from",
)
update_parser.add_argument(
"-p",
"--pretend",
action="store_true",
help="Pretend to update instead of updating, printing what would have been updated",
)
update_parser.add_argument(
"-v",
"--verbose",
action="store_true",
help="Display verbose debugging output",
)
print_parser = subparsers.add_parser(
'print',
help='Print a TXP2 container\'s contents as a JSON dictionary',
description='Print a TXP2 container\'s contents as a JSON dictionary.',
)
print_parser.add_argument(
"file",
metavar="FILE",
help="The TXP2 container to print",
)
print_parser.add_argument(
"-v",
"--verbose",
action="store_true",
help="Display verbose debugging output",
)
print_parser.add_argument(
"-d",
"--decompile-bytecode",
action="store_true",
help="Attempt to decompile and print pseudocode instead of printing the raw bytecode.",
)
parseafp_parser = subparsers.add_parser(
'parseafp',
help='Parse a raw AFP/BSI file pair previously extracted from an IFS or TXP2 container',
description='Parse a raw AFP/BSI file pair previously extracted from an IFS or TXP2 container.',
)
parseafp_parser.add_argument(
"afp",
metavar="AFPFILE",
help="The AFP file to parse",
)
parseafp_parser.add_argument(
"bsi",
metavar="BSIFILE",
help="The BSI file to parse",
)
parseafp_parser.add_argument(
"-v",
"--verbose",
action="store_true",
help="Display verbose debugging output",
)
parseafp_parser.add_argument(
"-d",
"--decompile-bytecode",
action="store_true",
help="Attempt to decompile and print pseudocode instead of printing the raw bytecode.",
)
decompile_parser = subparsers.add_parser(
'decompile',
help='Decompile bytecode in a raw AFP/BSI file pair previously extracted from an IFS or TXP2 container',
description='Decompile bytecode in a raw AFP/BSI file pair previously extracted from an IFS or TXP2 container.',
)
decompile_parser.add_argument(
"afp",
metavar="AFPFILE",
help="The AFP file to parse",
)
decompile_parser.add_argument(
"bsi",
metavar="BSIFILE",
help="The BSI file to parse",
)
decompile_parser.add_argument(
"-v",
"--verbose",
action="store_true",
help="Display verbose debugging output",
)
decompile_parser.add_argument(
"-d",
"--directory",
metavar="DIR",
default='.',
type=str,
help="Directory to write decompiled pseudocode files. Defaults to current directory.",
)
parsegeo_parser = subparsers.add_parser(
'parsegeo',
help='Parse a raw GEO file previously extracted from an IFS or TXP2 container',
description='Parse a raw GEO file previously extracted from an IFS or TXP2 container.',
)
parsegeo_parser.add_argument(
"geo",
metavar="GEOFILE",
help="The GEO file to parse",
)
parsegeo_parser.add_argument(
"-v",
"--verbose",
action="store_true",
help="Display verbose debugging output",
)
render_parser = subparsers.add_parser(
'render',
help='Render a particular animation out of a collection of TXP2 or IFS containers',
description='Render a particular animation out of a collection of TXP2 or IFS containers.',
)
render_parser.add_argument(
"container",
metavar="CONTAINER",
type=str,
nargs='+',
help="A container to use for loading animation data. Can be either a TXP2 or IFS container.",
)
render_parser.add_argument(
"-v",
"--verbose",
action="store_true",
help="Display verbose debugging output",
)
render_parser.add_argument(
"-s",
"--show-progress",
action="store_true",
help="Display per-frame rendering progress",
)
render_parser.add_argument(
"--disable-threads",
action="store_true",
help="Disable multi-threaded rendering. The animation will be rendered on a single core and threads will not be spawned.",
)
render_parser.add_argument(
"--path",
metavar="PATH",
type=str,
required=True,
help='The path of the animation to render. Use the "list" command to discover paths in a container.',
)
render_parser.add_argument(
"--output",
metavar="IMAGE",
type=str,
default="out.gif",
help=(
'The output file (ending either in .gif, .webp or .png) where the render should be saved. If .png is chosen then the '
'output will be a series of png files for each rendered frame. If .gif or .webp is chosen the output will be an '
'animated image. Note that the .gif file format has several severe limitations which result in sub-optimal animations '
'so it is recommended to use .webp or .png instead.'
),
)
render_parser.add_argument(
"--background-color",
type=str,
default=None,
help=(
"Set the background color of the animation as a comma-separated RGB or RGBA color (such as 255,0,0 for red or "
"0,255,0,128 for translucent green), overriding any default in the animation."
),
)
render_parser.add_argument(
"--background-image",
type=str,
default=None,
help=(
"Set a background image or animation to be placed behind the animation but in front of the background color. "
"Note that the background will be stretched to fit the animation. If a .png is specified and multiple rendered "
"frames are present it will use that series as an animation. If a static image is specified and mulitple frames "
"are not present it will use that as a static background. If an animated image is specified it will use that "
"as an animated background."
),
)
render_parser.add_argument(
"--background-loop-start",
type=int,
default=None,
help=(
"The starting frame of the background animation loop. Specify this to loop to a background animation frame other "
"than the first. For example, if your background animation has 10 frames and you specify a loop start of 6, the "
"resulting background animation loop will contain frames 6, 7, 8, 9 and 10 played in that order."
),
)
render_parser.add_argument(
"--background-loop-end",
type=int,
default=None,
help=(
"The ending frame of the background animation loop. Specify this to loop from a background animation frame other "
"than the last. For example, if your background animation has 10 frames and you specify a loop end of 8, the "
"resulting background animation loop will contain frames 1, 2, 3, 4, 5, 6, 7 and 8 played in that order."
),
)
render_parser.add_argument(
"--background-loop-offset",
type=int,
default=None,
help=(
"The very first frame of the background animation. Specify this to start the first loop anywhere other than the "
"loop start frame. For example, if your background animation has 10 frames and you specify a loop offset of 7, the "
"resulting background animation loop will contain frames 7, 8, 9 10, 1, 2, 3, 4, 5 and 6 played in that order. Note "
"that this can work in conjunction with the --background-loop-start and --background-loop-end parameters. For "
"example, if your background animation has 10 frames and you specify a loop start of 3, a loop end of 7 and a loop "
"offset of 5, the resulting background animation loop will contain frames 5, 6, 7, 3 and 4 played in that order."
),
)
render_parser.add_argument(
"--only-depths",
type=str,
default=None,
help="Only render objects on these depth planes. Specify a number, a comma-separated list of numbers or a range such as 3-5.",
)
render_parser.add_argument(
"--only-frames",
type=str,
default=None,
help=(
"Only render these frames. Specify a number, a comma-separated list of numbers or a range such as 10-20. Note that the "
"first frame is frame 1, not frame 0."
),
)
render_parser.add_argument(
"--force-width",
type=int,
default=None,
help=(
"Force the width of the rendered animation to a specific pixel value, such as 640 or 800. If the forced width does not match "
"the animation's original width it will be stretched horizontally."
),
)
render_parser.add_argument(
"--force-height",
type=int,
default=None,
help=(
"Force the height of the rendered animation to a specific pixel value, such as 480 or 600. If the forced height does not match "
"the animation's original height it will be stretched vertically."
),
)
render_parser.add_argument(
"--force-aspect-ratio",
type=str,
default=None,
help=(
"Force the aspect ratio of the rendered animation, as a colon-separated aspect ratio such as 16:9 or 4:3, after applying "
"any forced width and height. The resulting animation will be stretched to meet the requested aspect ratio."
),
)
render_parser.add_argument(
"--scale-width",
type=float,
default=1.0,
help=(
"Scale the final width of the animation by some factor, such as 2.0 or 0.5, after applying any forced width, height and "
"aspect ratio. The resulting animation will be stretched horizontally by the scaling factor."
),
)
render_parser.add_argument(
"--scale-height",
type=float,
default=1.0,
help=(
"Scale the final height of the animation by some factor, such as 2.0 or 0.5, after applying any forced width, height and "
"aspect ratio. The resulting animation will be stretched vertically by the scaling factor."
),
)
render_parser.add_argument(
"--enable-anti-aliasing",
action="store_true",
help="Enable anti-aliased rendering, using bilinear interpolation and super-sampling where appropriate to produce the best resulting animation.",
)
list_parser = subparsers.add_parser(
'list',
help='List out the possible paths to render from a collection of TXP2 or IFS containers',
description='List out the possible paths to render from a collection of TXP2 or IFS containers.',
)
list_parser.add_argument(
"container",
metavar="CONTAINER",
type=str,
nargs='+',
help="A container to use for loading animation data. Can be either a TXP2 or IFS container.",
)
list_parser.add_argument(
"-v",
"--verbose",
action="store_true",
help="Display verbose debugging output",
)
list_parser.add_argument(
"--include-frames",
action="store_true",
help="Include number of frames per animation in the output list.",
)
list_parser.add_argument(
"--include-size",
action="store_true",
help="Include width/height per animation in the output list.",
)
args = parser.parse_args()
if args.action == "extract":
return extract_txp2(
args.file,
args.dir,
split_textures=args.split_textures,
generate_mapping_overlays=args.generate_mapping_overlays,
write_mappings=args.write_mappings,
write_raw=args.write_raw,
write_binaries=args.write_binaries,
pretend=args.pretend,
verbose=args.verbose,
)
elif args.action == "update":
return update_txp2(args.file, args.dir, pretend=args.pretend, verbose=args.verbose)
elif args.action == "print":
return print_txp2(args.file, decompile_bytecode=args.decompile_bytecode, verbose=args.verbose)
elif args.action == "parseafp":
return parse_afp(args.afp, args.bsi, decompile_bytecode=args.decompile_bytecode, verbose=args.verbose)
elif args.action == "decompile":
return decompile_afp(args.afp, args.bsi, args.directory, decompile_bytecode=args.decompile_bytecode, verbose=args.verbose)
elif args.action == "parsegeo":
return parse_geo(args.geo, verbose=args.verbose)
elif args.action == "list":
return list_paths(args.container, include_size=args.include_size, include_frames=args.include_frames, verbose=args.verbose)
elif args.action == "render":
return render_path(
args.container,
args.path,
args.output,
disable_threads=args.disable_threads,
enable_anti_aliasing=args.enable_anti_aliasing,
background_color=args.background_color,
background_image=args.background_image,
background_loop_start=args.background_loop_start,
background_loop_end=args.background_loop_end,
background_loop_offset=args.background_loop_offset,
force_width=args.force_width,
force_height=args.force_height,
force_aspect_ratio=args.force_aspect_ratio,
scale_width=args.scale_width,
scale_height=args.scale_height,
only_depths=args.only_depths,
only_frames=args.only_frames,
show_progress=args.show_progress,
verbose=args.verbose,
)
else:
raise Exception(f"Invalid action {args.action}!")
if __name__ == "__main__":
sys.exit(main())