Skip to content

Latest commit

 

History

History
81 lines (68 loc) · 3.87 KB

README.md

File metadata and controls

81 lines (68 loc) · 3.87 KB
Raw

convbin Build Status Coverity Scan

This program is used to convert files to other formats. It primarily is used for the TI-84+CE and related calculator series, however can be used as a standalone program.

Command Line Help

Usage:
    convbin [options] -j <mode> -k <mode> -i <file> -o <file>

Required parameters:
    -i, --input <file>         Input file. Can be specified multiple times,
                               input files are appended in order.
    -o, --output <file>        Output file after converting.
    -j, --iformat <mode>       Set per-input file format to <mode>.
                               See 'Input formats' below.
                               This should be placed before the input file.
                               The default input format is 'bin'.
    -p, --icompress <mode>     Set per-input file compression to <mode>.
                               See 'Compression formats' below.
                               This should be placed before the input file.
    -k, --oformat <mode>       Set output file format to <mode>.
                               See 'Output formats' below.
    -n, --name <name>          If converting to a TI file type, sets
                               the on-calc name. For C, Assembly, and ICE
                               outputs, sets the array or label name.

Optional parameters:
    -r, --archive              If using the TI 8x* format, mark as archived.
    -c, --compress <mode>      Compress output using <mode>.
                               See 'Compression formats' below.
    -e, --8xp-compress <mode>  Sets the compression mode for compressed 8xp.
                               Default is 'zx7'.
    -m, --maxvarsize <size>    Sets maximum size for the TI 8x* variables.
    -u, --uppercase            If a program, capitalizes the on-calc name.
    -a, --append               Append to output file rather than overwrite.
    -h, --help                 Show this screen.
    -v, --version              Show the program version.
    -b, --comment              Custom comment for TI 8x* outputs.
    -l, --log-level <level>    Set program logging level.
                               0=none, 1=error, 2=warning, 3=normal

Input formats:
    Below is a list of available input formats, listed as
    <mode>: <description>

    bin: Interprets as raw binary.
    csv: Interprets as csv (comma separated values).
    8x: Interprets the TI 8x* data section.

Output formats:
    Below is a list of available output formats, listed as
    <mode>: <description>

    c: C source.
    asm: Assembly source.
    ice: ICE source.
    bin: raw binary.
    8xp: TI Program.
    8xv: TI AppVar.
    8xp-compressed: Compressed TI Program.
    8xg: TI Group. Input format must be 8x.
    8xg-auto-extract: TI Auto-Extracting Group. Input format must be 8x.
    b83: Pack input files into TI-83 Premium CE bundle.
    b84: Pack input files into TI-84 Plus CE bundle.
    zip: Pack input files into zip archive.

Compression formats:
    Below is a list of available compression formats, listed as
    <mode>: <description>

    zx0: ZX0 Compression.
    zx7: ZX7 Compression.
    auto: Tries all compression modes to find the best one.

Credits:
    (c) 2017-2024 by Matt "MateoConLechuga" Waltz.

    This program utilizes the following neat libraries:
        zx0,zx7: (c) 2012-2022 by Einar Saukas.
        miniz: (c) 2010-2014 by Rich Geldreich.