ndstextgen 1.7.5

Command line tool to render text from NDS .NFTR fonts.

NDS Text Generator

Command line tool to render text from NDS .NFTR fonts.

Run from pip

pip install ndstextgen
ndstextgen --help

Run from source

Install pipenv.
pipenv sync
pipenv run python ndstextgen --help

Command line usage

ndstextgen <options> FONT "TEXT"
Example: ndstextgen --color red font.NFTR "Print multiline\nred text."
FONT: (Required) Filename of the font, .NFTR extension can be omitted.
TEXT: (Required) Text to write. "\n" can be used for a line break. Can be the name of a UTF-8 file to read the text from.
--out <file>: Output file, set empty to just return the image. Default: text.png
--vert <int>: Vertical spacing between lines. Default: 2
--fw <int>: Use a fixed width instead of the VWF values in the font.
--spacing <int>: Additional horizontal spacing between characters.
--color <text>: Color to apply to the font. Default: black
--bg <text>: Background color. Default: transparent
--width <int>: Set width for the generated image. Default: 256
--height <int>: Set height for the generated image. Default: 256
--center: Center each line.
--wwrap: Automatic wordwrap.
--no-crop: Don't crop the image before saving it.
--encoding <str>: Encoding the font uses. See Python documentation.

Script usage

import ndstextgen
image = ndstextgen.gen("font.NFTR", "Print multiline\nred text.", color="red")