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.
|