fxsdk/fxconv/fxconv-main.py

#! /usr/bin/env python3

import getopt
import sys
import os
import fxconv
import importlib.util

help_string = f"""
usage: fxconv [<TYPE>] <INPUT> -o <OUTPUT> [--fx|--cg] [<PARAMETERS>...]

fxconv converts resources such as images and fonts into binary formats for
fxSDK applications, using gint and custom conversion formats.

When no TYPE is specified (automated mode), fxconv looks for type and
parameters in an fxconv-metadata.txt file in the same folder as the input. This
is normally the default for add-ins.

When TYPE is specified (one-shot conversion), it should be one of:
  -b, --binary    Turn data into an object file without conversion
  -f, --font      Convert to gint's topti font format
  --bopti-image   Convert to gint's bopti image format
  --libimg-image  Convert to the libimg image format
  --custom        Use a custom converter; you might want to specify an explicit
                  type by adding "custom-type:your_custom_type" (see below)
Custom converters can be specified by:
  --converters    Semicolon-separated list of custom converters (converters.py
                  in the current directory is detected as one per legacy)

During one-shot conversions, parameters can be specified with a "NAME:VALUE"
syntax (names can contain dots). For example:
  fxconv -f myfont.png -o myfont.o charset:ascii grid.padding:1 height:7

Some formats differ between platforms so you should specify it when possible:
  --fx            CASIO fx-9860G family (black-and-white calculators)
  --cg, --cp      CASIO fx-CG 50 / fx-CP 400 family (16-bit color calcs)

Finally, there is some support (non-final) for PythonExtra, in which case the
output file is as Python file instead of an object file.
  --py            Convert for PythonExtra (some types supported)
  --py-compact    Use compact bytes notation (shorter, but non-printable)
""".strip()

# Simple error-warnings system
FxconvError = fxconv.FxconvError

def err(msg):
	print("\x1b[31;1merror:\x1b[0m", msg, file=sys.stderr)
	return 1
def warn(msg):
	print("\x1b[33;1mwarning:\x1b[0m", msg, file=sys.stderr)

# "converters" module from the user project... if it exists. This
# auto-detection is legacy, you should use --converters instead.
try:
	import converters as conv
	converters = [conv.convert]
except ImportError:
	converters = []

def main():
	types = "binary image font bopti-image libimg-image custom"
	mode = ""
	output = None
	model = None
	target = { 'toolchain': None, 'arch': None, 'section': None }
	use_custom = False
	converter_paths = []
	py = { 'enabled': False, 'compact': False }

	# Parse command-line arguments

	if len(sys.argv) == 1:
		print(help_string, file=sys.stderr)
		sys.exit(1)

	try:
		longs = ["help", "output=", "toolchain=", "arch=", "section=", "fx",
			     "cg", "cp", "converters=", "py", "py-compact"] + types.split()
		opts, args = getopt.gnu_getopt(sys.argv[1:], "hsbifo:", longs)
	except getopt.GetoptError as error:
		return err(error)

	for name, value in opts:
		# Print usage
		if name == "--help":
			print(help_string, file=sys.stderr)
			return 0
		elif name in [ "-o", "--output" ]:
			output = value
		elif name in [ "--fx", "--cg" ]:
			model = name[2:]
		elif name == "--cp":
			model = "cg"
		elif name == "--toolchain":
			target['toolchain'] = value
		elif name == "--arch":
			target['arch'] = value
		elif name == "--section":
			target['section'] = value
		elif name == "--custom":
			use_custom = True
			mode = "custom"
		elif name == "--converters":
			converter_paths = [path for path in value.split(";") if path]
		elif name == "--py":
			py['enabled'] = True
		elif name == "--py-compact":
			py['compact'] = True
		# Other names are modes
		else:
			mode = name[1] if len(name)==2 else name[2:]

	# Remaining arguments
	if args == []:
		err(f"no input file")
		sys.exit(1)
	input = args.pop(0)

	# In automatic mode, look for information in fxconv-metadata.txt
	if mode == "":
		metadata_file = os.path.join(os.path.dirname(input),
			"fxconv-metadata.txt")

		if not os.path.exists(metadata_file):
			return err(f"using auto mode but {metadata_file} does not exist")

		metadata = fxconv.Metadata(path=metadata_file)
		params = metadata.rules_for(input)

		if params is None:
			return err(f"no metadata specified for {input}")

		if "section" in params:
			target["section"] = params["section"]

	# In manual conversion modes, read parameters from the command-line
	else:
		params = fxconv.parse_parameters(args)

		if "type" in params or "custom-type" in params:
			pass
		elif len(mode) == 1:
			params["type"] = { "b": "binary", "i": "image", "f": "font" }[mode]
		else:
			params["type"] = mode

		# Will be deprecated in the future
		if params.get("type") == "image":
			warn("type 'image' is deprecated, use 'bopti-image' instead")
			params["type"] = "bopti-image"

	# Load custom converters:
	for path in converter_paths:
		spec = importlib.util.spec_from_file_location("converters", path)
		module = importlib.util.module_from_spec(spec)
		spec.loader.exec_module(module)
		converters.append(module.convert)

	params["py"] = py
	fxconv.convert(input, params, target, output, model, converters)

if __name__ == "__main__":
	try:
		sys.exit(main())
	except fxconv.FxconvError as e:
		sys.exit(err(e))