prg2wav(1)

NAME
prg2wav - convert PC emulator files to a Commodore 64 tape

SYNOPSIS
prg2wav -h|-v

prg2wav -l file [file...]

prg2wav [-i] [-s] [-o output_file_name] file [file...]

DESCRIPTION
If the -l option is not specified, prg2wav scans each file given on the command line and, if it is a .PRG, a .P00 or a .T64 with a single used entry, converts it to a sound (by default) or a .WAV file (if the -o option is used). If it is a .T64 with more than one used entry, prg2wav interactively asks which entries should be converted, and converts them. The entries must be given as a comma-separated list of ranges, where a range can be:

*   a number

*   lower_bound-upper_bound, where lower_bound and upper_bound can be either empty or numbers. If lower_bound is empty, it is assumed to be 1. If upper_bound is empty, it is assumed to be the total number of entries in the .T64 file.

If the -l option is used, prg2wav will list the contents of each file in the command line. For .PRG, it will display the start and end addresses. For .P00, it will display the start and end addresses and the C64 name. For .T64, it will display the number of total and used entries, the tape image name and, for each entry, the entry number, the name and the start and end addresses.

prg2wav will only recognize standard entries in .T64 files (not memory snapshots).

OPTIONS

-h  Show a help message and exit successfully.

-i  Generate an inverted waveform. Some soundcards invert the signal when playing back, i.e. they turn positive impulses into negative ones and vice versa. If a normal waveform is played back with such a soundcard, a C64 will not be able to recognize it. If an inverted waveform is played back with such a soundcard, the soundcard will invert it again, turning it into a normal waveform, so a C64 will recognize it. If you get no results without the -i option, try enabling it.

-k  Create a file which does not use any turbo loader. Such files are recognized by the kernel loader, that is the built-in loader in VIC20 and C64 kernel ROM. Since such files tend to be VERY long, it is only advised to use this option for very short programs, or for VIC20 programs.

-l  Do not create a .WAV file, but show the contents of the input files.

-o output_file_name
    Use output_file_name as output. If output_file_name does not end with .WAV or .wav, .wav will be appended at the end.

-s  Create stand-alone files, each made of a Turbo Tape loader and the actual file in Turbo Tape format. To reload stand-alone files, no special programs are needed to reload the file on the C64. By default, only the Turbo Tape 64 part will be written, which needs Turbo Tape 64 or a compatible loader to be reloaded.

-v  Show version and copyright info and exit successfully

AUTHOR
Fabrizio Gennari (fabrizio.ge@tiscalinet.it)

REFERENCES
http://www.fairlight.to/docs/text/formats.zip

    Peter Schepers' guide to Commodore 64 file formats

http://cia.c64.org/tools/64util05.zip

    The file 64loader.txt provided info on the kernel ROM ("slow") loader

SEE ALSO
wav2prg (1)