Short:        Tool for relocating SID tunes
Author:       linus@linusakesson.net (Linus Åkesson)
Uploader:     polluks+aminet sdf lonestar org (Stefan Haubenthal)
Type:         mus/misc
Version:      1.0
Architecture: ppc-morphos
URL:          http://www.linusakesson.net/software/sidreloc/

sidreloc 1.0 by Linus Akesson

Usage: sidreloc [OPTIONS] input.sid output.sid

Options:
Short name  Long name      Default     Description

  -p        --page         10          First memory page (in hex) to be occupied by
                                       the relocated SID.
  -z        --zp-reloc     80-ff       Range of free zero-page addresses that the
                                       relocated SID can use.
  -k        --no-zp-reloc              Keep all zero-page addresses as they appear
                                       in the original SID.
  -r        --reloc        (from SID)  Range to relocate, e.g. "50-5f" for a 4 kB
                                       SID originally located at $5000. Must include
                                       the entire loading range of the SID.

  -t        --tolerance    2           Tolerance (in percent) for wrong pitches.
  -s        --strict                   Verify pulse widths.
  -f        --force                    Write output file even if verification fails.

  -v        --verbose                  Output some statistics and a nice map of all
                                       the relocations.
  -q        --quiet                    Don't whine about writing out of bounds.

            --frames       100000      Number of times to call the playroutine of
                                       each subtune. The default corresponds to
                                       approximately 33 minutes of a PAL tune.
            --nmi-calls    200         Number of times to call the NMI routine per
                                       frame (the CIA2 timer setting is ignored).
            --init-cycles  1000000     Max number of clock cycles for init routine.
            --play-cycles  20000       Max number of clock cycles for playroutine.
            --nmi-cycles   1000        Max number of clock cycles for NMI routine.

  -h        --help                     Display this information.
  -V        --version                  Display brief version information and credits.

Project homepage: http://www.linusakesson.net/software/sidreloc/