2. Usage

2.1 Command line option overview

The sp65 utility accepts the following options:

---------------------------------------------------------------------------
Usage: sp65 [options] file [options] [file]
Short options:
  -V                            Print the version number and exit
  -c fmt[,attrlist]             Convert into target format
  -h                            Help (this text)
  -lc                           List all possible conversions
  -r file[,attrlist]            Read an input file
  -v                            Increase verbosity
  -w file[,attrlist]            Write the output to a file

Long options:
  --convert-to fmt[,attrlist]   Convert into target format
  --help                        Help (this text)
  --list-conversions            List all possible conversions
  --pop                         Restore the original loaded image
  --read file[,attrlist]        Read an input file
  --slice x,y,w,h               Generate a slice from the loaded bitmap
  --verbose                     Increase verbosity
  --version                     Print the version number and exit
  --write file[,attrlist]       Write the output to a file
---------------------------------------------------------------------------

2.2 Command line options in detail

Below is a description of all the command line options. For the concept of attribute lists see below.

-c, --convert-to format[,attrlist]

Convert a bitmap into one of the supported target formats. The option argument must at least contain the "format" attribute. For more attributes, see section Conversions.

-h, --help

Print the short option summary shown above.

-lc, --list-conversions

Print a list of possible conversions.

--pop

Restore the working copy of the bitmap from the one originally loaded from the file. This may for example be used when creating several output files from one input file.

-r, --read filename[,attrlist]

Read an input file. The option argument must at least contain the "name" attribute. See input formats for more information.

-v, --verbose

Increase verbosity. Usually only needed for debugging purposes. You may use this option more than one time for even more verbose output.

-V, --version

Print the version number of the assembler. If you send any suggestions or bugfixes, please include the version number.

-w, --write filename[,attrlist]

Write an output file. The option argument must at least contain the "name" attribute. See output formats for more information.