fxconv

fxconv is a tool from the fxSDK that converts images and fonts for use with gint and PythonExtra.

It outputs .py files that can be directly imported into your programs.

📥 Download & Run

You need two files:

Save them into a folder and run the tool like this:

python fxconv-main.py ...

On the template, that would be

python fxconv/fxconv-main.py ...

You should create an alias for fxconv that’s your python fxconv/fxconv-main.py. That would later be used on this reference as fxconv.

Use the --font type to create a gint.font() object.

fxconv --font font_shmup.png -o shmup.py \
  --py name:font_shmup charset:print grid.size:10x13 grid.padding:0 grid.border:0 proportional:true

Option	Description
`--font`	Convert an image to a bitmap font
`--py`	Output PythonExtra format (`.py`)
`--py-compact`	Minimize output with raw bytes (non-editable)
`name:NAME`	Name of the variable in the `.py` file
`charset:print`	Use printable characters (ASCII 32–126)
`grid.size:WxH`	Size of one glyph (in pixels)
`grid.padding:0`	Spacing between glyphs
`grid.border:0`	Border around the grid
`proportional:true/false`	Use variable widths or monospaced

fxconv --font font_shmup.png -o shmup.py \
  --py name:font_shmup charset:print grid.size:10x13 proportional:true

fxconv --font numworks.png -o numworks.py \
  --py name:font_numworks charset:print grid.size:10x16 proportional:false

fxconv --bopti-image myimage.png -o image.py \
  --cg profile:p4_rgb565 name:image --py

fxconv --bopti-image myimage.png -o image.py \
  --fx profile:mono name:image --py

fxconv --bopti-image myimage.png -o image.py \
  --cg profile:p4_rgb565 name:image --py --py-compact

fxconv [TYPE] input.png -o output.py [--fx|--cg] [--py] [parameters...]

Type	Description
`--font`	Bitmap font
`--bopti-image`	Image for drawing (monochrome/color)

Use --fx for black-and-white, --cg for fx-CG/fx-CP models.

If TYPE is omitted, fxconv will look for a fxconv-metadata.txt file. That’s mostly for C add-ins and not needed with PythonExtra.