| jzIntv v1.0
Copyright 2010, Joseph Zbiciak
Portions copyright:  Tim Lindner, John Tanner, Rick Reynolds,
                     Pedro Giffuni, Joe Fisher, Frank Palazzolo,
                     Kjell Breding, Daniele Moglia
Usage:
    jzintv [flags] gamefile
Specifying a game image:
    jzIntv supports most, if not all, known formats for Intellivision
    game ROM images.  When invoking jzIntv, provide the full path to
    the game-image file.  If you omit the file extension, jzIntv will
    search for an appropriate file by trying the following extensions:
    .rom, .bin, .int, and .itv.  The overall ROM search process is
    somewhat involved.  See the jzIntv documentation for details.
    If the filename ends in .bin, .int, or .itv, or if jzIntv does not
    recognize the file's extension, it will assume the file is in BIN+CFG
    format.  In that case, jzIntv will look for a matching .cfg file.
    Systems with case-sensitive file names (Linux, UNIX, etc.) need to
    ensure the filename extensions are in lower-case.  On all systems,
    jzIntv expects to receive file names with lower-case extensions.
ROM Image Flags:
    -e /path/to/exec.bin          Specifies path to the EXEC ROM image.
    --execimg=/path/to/exec.bin   By default, jzIntv looks in current dir.  
    -g /path/to/grom.bin          Specifies path to the GROM ROM image.
    --gromimg=/path/to/grom.bin   By default, jzIntv looks in current dir.  
    -E /path/to/ecs.bin           Specifies path to the ECS ROM image
    --ecsimg=/path/to/ecs.bin     By default, jzIntv looks in current dir.  
                                  Only needed when ECS is enabled.
Intellivision Hardware Flags:
    -s#     --ecs=#               ECS.           0: Disable, 1: Enable
    -v#     --voice=#             Intellivoice.  0: Disable, 1: Enable
    -W#     --voicewindow=#       Sets averaging window for voice filter.
    -Vname  --voicefiles=name     Saves voice WAV files to name####.wav.
Video and Sound Flags:
    -z#     --displaysize=#       Desired display mode:
                                      0:  320x200x8bpp
                                      1:  640x480x8bpp
                                      2:  320x240x16bpp
    -f# -x# --fullscreen=#        Full screen display:
                                      0:  Windowed
                                      1:  Full screen
    -a#     --audiorate=#         Audio sampling rate.  0 disables audio.
            --audio=#             Synonym for --audiorate.
    -Fname  --audiofile=name      Records all audio to specified file.
    -w#     --audiowindow=#       Sets averaging window for audio filter.
    -B#     --audiobufsize=#      Internal audio buffer size.
    -C#     --audiobufcnt=#       Internal audio buffer count.
    -M#     --audiomintick=#      Minimum Intellivision cycles between
                                  explicit calls to snd_tick().
Input Configuration Flags:
    Currently, jzIntv does not offer a flexible method to re-bind keys.
    The kbdhackfile does allow you to crudely specify key bindings.
    --kbdhackfile=/path/to/file   Configure key bindings.
    -m#     --kbdmap=#            Specify initial keyboard map (0-3)
    Analog and USB joysticks have a rich set of configuration parameters.
    Run jzIntv with an empty configuration string to find out defaults
    are for your joystick and operating system.  For more information on
    configuring joysticks, see the file jzintv/doc/jzintv/joystick.txt
    --js0="config string"         Configures Joystick #0
    --js1="config string"         Configures Joystick #1
    --js2="config string"         Configures Joystick #2
    --js3="config string"         Configures Joystick #3
Intellicart .ROM emulation specific flags:
    -c#     --icartcache=#        Change caching policy for Intellicart
                                  .ROM programs:
                                  0:  Cache bankswitched memory (default)
                                  1:  Don't cache bankswitched memory
                                  2:  Only cache read-only, non-banksw.
                                  3:  Do not cache anything.
Debugger flags:
    -d      --debugger            Enable jzIntv's debugger.
            --sym-file=path       Load symbol table from 'path'.
            --src-map=path        Load source/listing map from 'path'.
            --script=path         Execute debug commands from 'path'.
            --rand-mem            Randomize memories on startup
Misc Flags:
    -r#     --ratecontrol=#       \_ Speed up by factor #.  Setting #
            --macho=#             /  to 0 disables rate control.
    -p path --rom-path=path       Append path to the ROM search path.
    -q      --quiet               Hide jzIntv's non-error output.
            --gui-mode            Tells jzIntv to listen for commands from
                                  a GUI over stdin.
    -J path --jlp-savegame=path   Enable JLP-style save-game support with
                                  'path' as the save-game file.
            --file-io             Enable Emu-Link File-IO support
                                  (See examples/fileio/fileio.asm)
    -l      --license             License information
 -h -?      --help                This usage info
Environment:
    JZINTV_ROM_PATH               Controls ROM search path.  Components of
                                  the ROM search path should be separated
                                  by ":" characters.  jzIntv examines
                                  dirs specified by --rom-path before
                                  dirs specified by JZINTV_ROM_PATH.
Legal note:
    Intellivision(TM) is a trademark of Intellivision Productions.  Joe
    Zbiciak and jzIntv are not affiliated with Intellivision Productions.
 |