convert-screens

Convert text to screens.

Synopsis

convert-screens [-M file] [-o file] [-I directory] [-s section] [-D defines] file

Description

Convert text into screens. It allows arbitrary mapping of Unicode characters to screen codes and word wrapping.

It generates an assembler source file containing all the created objects.

Supported Options

-h, --help

Show help message and exit.

-I directory

Search for included files in directory. Can be given multiple times.

-M file

Write gcc-style dependency information to file.

-o file

Write generated assembly code to file.

-s section, --section section

Put generated objects in section section.

-D defines>

Specify defines.

Text File

The text file starts with a preamble, specifying how the conversion should be done, followed by pages of text to be converted.

Preamble

image_padding_left string

(default: empty)

image_padding_right string

(default: empty)

line_length number

(default: 40)

line_skip number

(default: 0)

lines number

(default: 25)

map from[-to] target :

name string

(required)

page_mode mode

(default: pages)

objects

Create a separate named object for each page.

pages

Create an index object containing pointers to each page.

single

Create a single page object.

prefix string

(default: empty)

postfix string

(default: empty)

runlength_encode {yes|no}

Runlength encode screen objects. (default: yes)

title_length number

(default: 0)

title_xor number

(default: 0)

word_wrap {yes|no}

Automatically word wrap lines to fit into line_length. (default: no)