.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.29) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{ . if \nF \{ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "STELLA 6" .TH STELLA 6 "2017-08-21" "5.0.2" "SlackBuilds.org" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" stella \- an Atari 2600 emulator .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBstella\fR \fIoptions\fR \fI\s-1ROM\s0 file\fR .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBstella\fR is a comprehensive emulator of the old Atari 2600 video-game console. It support most Atari 2600 games and many peripherals. .PP If you start Stella and do not specify a \s-1ROM\s0 image, it will start in \&'\s-1ROM\s0 Launcher' mode. If this is your first time starting Stella, you will be asked to select the default \s-1ROM\s0 directory to use. .PP This man page only documents the command-line options and default keybindings. The complete documentation is in \fIindex.html\fR and \&\fIdebugger.html\fR, usually installed in \fI/usr/share/doc/stella/\fR or \&\fI/usr/doc/stella\-4.7.2/\fR. .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fB\-video\fR " 4 .IX Item "-video " Use the given rendering backend (where applicable); default is the best available mode detected. .IP "\fB\-vsync\fR <1|0>" 4 .IX Item "-vsync <1|0>" Synchronize screen updates to the vertical blank period. This can result in smoother updates, and eliminate tearing. .IP "\fB\-fullscreen\fR <1|0>" 4 .IX Item "-fullscreen <1|0>" Enable fullscreen mode. .IP "\fB\-center\fR <1|0>" 4 .IX Item "-center <1|0>" Centers game window (if possible). .IP "\fB\-palette\fR " 4 .IX Item "-palette " Set the palette to either normal Stella, the one used in the z26 emulator, or a user-defined palette. .IP "\fB\-colorloss\fR <1|0>" 4 .IX Item "-colorloss <1|0>" Enable/disable the \s-1PAL\s0 color-loss effect. .IP "\fB\-framerate\fR " 4 .IX Item "-framerate " Display the given number of frames per second. Normally, Stella will determine framerate based on number of scanlines. Setting this to 0 automatically enables auto-frame calculation (ie, framerate based on scanlines). .IP "\fB\-timing\fR " 4 .IX Item "-timing " Determines type of wait to perform between processing frames. Sleep will release the \s-1CPU\s0 as much as possible, and is the preferred method on laptops (and other low-powered devices) and when using VSync. Busy will emulate z26 busy-wait behaviour, and use all possible \s-1CPU\s0 time, but may eliminate graphical 'tearing' in software mode. .IP "\fB\-uimessages\fR <1|0>" 4 .IX Item "-uimessages <1|0>" Enable or disable display of message in the \s-1UI.\s0 Note that messages indicating serious errors override this setting, and are always shown. .IP "\fB\-sound\fR <1|0>" 4 .IX Item "-sound <1|0>" Enable or disable sound generation. .IP "\fB\-fragsize\fR " 4 .IX Item "-fragsize " Specify the sound fragment size to use. Linux/Mac seems to work with 512, Windows usually needs 1024. .IP "\fB\-freq\fR " 4 .IX Item "-freq " Set sound sample output frequency (11025,22050,31400,44100,48000) Default is 31400. Do not change unless you experience sound issues. .IP "\fB\-volume\fR " 4 .IX Item "-volume " Set the volume (0 \- 100). .IP "\fB\-tia.zoom\fR " 4 .IX Item "-tia.zoom " Use the specified zoom level (integer) while in TIA/emulation mode. .IP "\fB\-tia.inter\fR <1|0>" 4 .IX Item "-tia.inter <1|0>" Use interpolation for the \s-1TIA\s0 image (results in blending/smoothing of the image). .IP "\fB\-tia.aspectn\fR " 4 .IX Item "-tia.aspectn " .PD 0 .IP "\fB\-tia.aspectp\fR " 4 .IX Item "-tia.aspectp " .PD Specify the amount (as a percentage) to scale the \s-1TIA\s0 image width in \&\s-1NTSC\s0 and \s-1PAL\s0 mode. Since many video modes do not use square pixels, you can reduce width until the pixels appear square. Allowable values are 80 \- 120; I find 85 \- 90 gives the most authentic look for \s-1NTSC,\s0 and 105 \- 110 for \s-1PAL.\s0 .IP "\fB\-tia.fsfill\fR <1|0>" 4 .IX Item "-tia.fsfill <1|0>" Stretch \s-1TIA\s0 image completely while in fullscreen mode (vs. an integral stretch which won't necessarily completely fill the screen). .IP "\fB\-tia.dbgcolors\fR " 4 .IX Item "-tia.dbgcolors " Assigns the colours (R)ed, (O)range, (Y)ellow, (G)reen, (B)lue and (P)urple to each graphical register P0/M0/P1/M1/PF/BL, respectively. Currently, these can be changed around to apply different colours to the respective register. .IP "\fB\-tv.phosphor\fR " 4 .IX Item "-tv.phosphor " When to use phosphor mode. .IP "\fB\-tv.phosblend\fR <0 \- 100>" 4 .IX Item "-tv.phosblend <0 - 100>" Set default blend level in phosphor mode. .IP "\fB\-tv.filter\fR <1 \- 6>" 4 .IX Item "-tv.filter <1 - 6>" Blargg \s-1TV\s0 effects, 0 is disabled, next numbers in sequence represent presets for 'Composite', 'S\-Video', '\s-1RGB\s0', 'Bad Adjust', and 'Custom' modes. .IP "\fB\-tv.scanlines\fR <0 \- 100>" 4 .IX Item "-tv.scanlines <0 - 100>" Blargg \s-1TV\s0 effects scanline intensity, where 0 means completely off. .IP "\fB\-tv.scaninter\fR <1|0>" 4 .IX Item "-tv.scaninter <1|0>" Blargg \s-1TV\s0 effects scanline interpolation, resulting in blending/smoothing of the scanlines. .IP "\fB\-tv.jitter\fR <1|0>" 4 .IX Item "-tv.jitter <1|0>" Enable \s-1TV\s0 jitter effect. .IP "\fB\-tv.jitter_recovery\fR <1 \- 20>" 4 .IX Item "-tv.jitter_recovery <1 - 20>" Set recovery time for \s-1TV\s0 jitter effect. .IP "\fB\-tv.contrast\fR " 4 .IX Item "-tv.contrast " Blargg \s-1TV\s0 effects 'contrast' (only available in custom mode, range \-1.0 to 1.0). .IP "\fB\-tv.brightness\fR " 4 .IX Item "-tv.brightness " Blargg \s-1TV\s0 effects 'brightness' (only available in custom mode, range \&\-1.0 to 1.0). .IP "\fB\-tv.hue\fR " 4 .IX Item "-tv.hue " Blargg \s-1TV\s0 effects 'hue' (only available in custom mode, range \-1.0 to 1.0). .IP "\fB\-tv.saturation\fR " 4 .IX Item "-tv.saturation " Blargg \s-1TV\s0 effects 'saturation' (only available in custom mode, range \&\-1.0 to 1.0). .IP "\fB\-tv.gamma\fR " 4 .IX Item "-tv.gamma " Blargg \s-1TV\s0 effects 'gamma' (only available in custom mode, range \-1.0 to 1.0). .IP "\fB\-tv.sharpness\fR " 4 .IX Item "-tv.sharpness " Blargg \s-1TV\s0 effects 'sharpness' (only available in custom mode, range \&\-1.0 to 1.0). .IP "\fB\-tv.resolution\fR " 4 .IX Item "-tv.resolution " Blargg \s-1TV\s0 effects 'resolution' (only available in custom mode, range \&\-1.0 to 1.0). .IP "\fB\-tv.artifacts\fR " 4 .IX Item "-tv.artifacts " Blargg \s-1TV\s0 effects 'artifacts' (only available in custom mode, range \&\-1.0 to 1.0). .IP "\fB\-tv.fringing\fR " 4 .IX Item "-tv.fringing " Blargg \s-1TV\s0 effects 'fringing' (only available in custom mode, range \-1.0 to 1.0). .IP "\fB\-tv.bleed\fR " 4 .IX Item "-tv.bleed " Blargg \s-1TV\s0 effects 'bleed' (only available in custom mode, range \-1.0 to 1.0). .IP "\fB\-cheat\fR " 4 .IX Item "-cheat " Use the specified cheatcode (see Cheat section for description). .IP "\fB\-loglevel\fR <0|1|2>" 4 .IX Item "-loglevel <0|1|2>" Indicates level of logging to perform while the application is running. Zero completely disables logging (except for serious errors), while the remaining numbers show increasingly more detail. .IP "\fB\-logtoconsole\fR <1|0>" 4 .IX Item "-logtoconsole <1|0>" Indicates that logged output should be printed to the console/commandline as it's being collected. An internal log will still be kept, and the amount of logging is still controlled by 'loglevel'. .IP "\fB\-joydeadzone\fR " 4 .IX Item "-joydeadzone " Sets the joystick axis deadzone area for joysticks/gamepads. All values within the deadzone are treated as zero-axis values, while only those values outside are registered as valid input. Accepts a number from 0 \- 29, and uses the formula 3200 + number * 1000. So the possible deadzone values range from 3200 to 32200. .IP "\fB\-joyallow4\fR <1|0>" 4 .IX Item "-joyallow4 <1|0>" Allow all 4 directions on a joystick to be pressed simultaneously. Bumper Bash ignores this setting, and always allows all 4 directions. .IP "\fB\-usemouse\fR " 4 .IX Item "-usemouse " Use mouse as a controller as specified by \s-1ROM\s0 properties in specific case. Always and never are self-explanatory, analog means only for analog-type devices (paddles, trackball, etc). .IP "\fB\-grabmouse\fR <1|0>" 4 .IX Item "-grabmouse <1|0>" Locks the mouse cursor in the game window in emulation mode. .IP "\fB\-cursor\fR <0,1,2,3>" 4 .IX Item "-cursor <0,1,2,3>" Set cursor state in UI/emulation modes. .IP "\fB\-dsense\fR " 4 .IX Item "-dsense " Sensitivity for emulation of paddles when using a digital device (ie, joystick digital axis or button, keyboard key, etc). Valid range of values is from 1 to 20, with larger numbers causing faster movement. .IP "\fB\-msense\fR " 4 .IX Item "-msense " Sensitivity for emulation of paddles when using a mouse. Valid range of values is from 1 to 20, with larger numbers causing faster movement. .IP "\fB\-tsense\fR " 4 .IX Item "-tsense " Sensitivity of mouse emulated trackball movement (1\-20). .IP "\fB\-saport\fR " 4 .IX Item "-saport " Determines how to enumerate the Stelladaptor/2600\-daptor devices in the order they are found: 'lr' means first is left port, second is right port, 'rl' means the opposite. .IP "\fB\-ctrlcombo\fR <1|0>" 4 .IX Item "-ctrlcombo <1|0>" Use control-x key combos. This is normally enabled, since the Quit command is tied to 'Control\-q'. However, there are times when a 2\-player game is using either the 'f' or 'r' keys for movement, and pressing Control (for Fire) will perform an unwanted action associated with Control-r or Control-f. .IP "\fB\-autoslot\fR <1|0>" 4 .IX Item "-autoslot <1|0>" Automatically switch to the next available save state slot after saving a \s-1ROM\s0 state file. .IP "\fB\-stats\fR <1|0>" 4 .IX Item "-stats <1|0>" Overlay console info on the \s-1TIA\s0 image during emulation. .IP "\fB\-fastscbios\fR <1|0>" 4 .IX Item "-fastscbios <1|0>" Disable Supercharger \s-1BIOS\s0 progress loading bars. .IP "\fB\-snapsavedir\fR " 4 .IX Item "-snapsavedir " The directory to save snapshot files to. .IP "\fB\-snaploaddir\fR " 4 .IX Item "-snaploaddir " The directory to load snapshot files from. .IP "\fB\-snapname\fR " 4 .IX Item "-snapname " When saving snapshots, use either the internal database name or the actual \s-1ROM\s0 filename. .IP "\fB\-sssingle\fR <1|0>" 4 .IX Item "-sssingle <1|0>" Generate single snapshot instead of many, overwriting any previous snapshots. .IP "\fB\-ss1x\fR <1|0>" 4 .IX Item "-ss1x <1|0>" Ignore any scaling applied to the \s-1TIA\s0 image, and save snapshot in unscaled (1x) mode. .IP "\fB\-ssinterval\fR " 4 .IX Item "-ssinterval " Set the interval in seconds between taking snapshots in continuous snapshot mode (currently, 1 \- 10). .IP "\fB\-rominfo\fR " 4 .IX Item "-rominfo " Display detailed information about the given \s-1ROM,\s0 and then exit Stella. .IP "\fB\-listrominfo\fR" 4 .IX Item "-listrominfo" Prints relevant contents of the Stella \s-1ROM\s0 database, one \s-1ROM\s0 per line, and then exit Stella. This can be used for external frontends. .IP "\fB\-exitlauncher\fR <1|0>" 4 .IX Item "-exitlauncher <1|0>" Always exit to \s-1ROM\s0 launcher when exiting a \s-1ROM \s0(normally, an exit to launcher only happens when started with the launcher). .IP "\fB\-launcherres\fR " 4 .IX Item "-launcherres " Set the size of the \s-1ROM\s0 launcher. .IP "\fB\-launcherfont\fR " 4 .IX Item "-launcherfont " Set the size of the font in the \s-1ROM\s0 launcher. .IP "\fB\-launcherexts\fR " 4 .IX Item "-launcherexts " Specifies which files to show in the \s-1ROM\s0 launcher ('allfiles' is self-explanatory, 'allroms' is all files with valid rom extensions (currently: a26, bin, rom, gz, zip), '\s-1LIST\s0' is a ':' separated list of valid rom extensions. .IP "\fB\-romviewer\fR <0|1|2>" 4 .IX Item "-romviewer <0|1|2>" Hide \s-1ROM\s0 info viewer in \s-1ROM\s0 launcher mode (0), or use the given zoom level (1 or 2). .IP "\fB\-uipalette\fR " 4 .IX Item "-uipalette " Use the specified palette for \s-1UI\s0 elements. \fBclassic\fR is green-on-black, \&\fBstandard\fR is more colorful. .IP "\fB\-listdelay\fR " 4 .IX Item "-listdelay " Set the amount of time to wait between treating successive keypresses as a single word in list widgets (value can range from 300\-1000). Use \&'0' to disable list-skipping completely, .IP "\fB\-mwheel\fR " 4 .IX Item "-mwheel " Set the number of lines a mousewheel will scroll in the \s-1UI.\s0 .IP "\fB\-romdir\fR " 4 .IX Item "-romdir " Set the directory where the \s-1ROM\s0 launcher will start. .IP "\fB\-statedir\fR " 4 .IX Item "-statedir " Set the directory in which to access state files. .IP "\fB\-cheatfile\fR " 4 .IX Item "-cheatfile " Set the full pathname of the cheatfile database. .IP "\fB\-palettefile\fR " 4 .IX Item "-palettefile " Set the full pathname of the user-defined palette file. .IP "\fB\-propsfile\fR " 4 .IX Item "-propsfile " Set the full pathname of the \s-1ROM\s0 properties file. .IP "\fB\-nvramdir\fR " 4 .IX Item "-nvramdir " Set the directory in which to access non-volatile (flash/EEPROM) files. .IP "\fB\-cfgdir\fR " 4 .IX Item "-cfgdir " Set the directory in which to access Distella config files. .IP "\fB\-avoxport\fR " 4 .IX Item "-avoxport " Set the name of the serial port where an AtariVox is connected. .IP "\fB\-maxres\fR " 4 .IX Item "-maxres " Useful for developers, this sets the maximum size of window that can be created, allowing to simulate testing on 'smaller' systems. .IP "\fB\-help\fR" 4 .IX Item "-help" Prints a help message describing these options, and then exit Stella. .Sp The following are useful to developers. Only use them if you know what you're doing! Note that in all cases, the values supplied to the arguments are not case sensitive. .Sp Argument Description .IP "\fB\-dis.resolve\fR <1|0>" 4 .IX Item "-dis.resolve <1|0>" Try to differentiate between code vs. data sections in the disassembler. See the Debugger section for more information. .IP "\fB\-dis.gfxformat\fR <2|16>" 4 .IX Item "-dis.gfxformat <2|16>" Sets the base to use for displaying \s-1GFX\s0 sections in the disassembler. .IP "\fB\-dis.showaddr\fR <1|0>" 4 .IX Item "-dis.showaddr <1|0>" Shows/hides opcode addresses in the disassembler. .IP "\fB\-dis.relocate\fR <1|0>" 4 .IX Item "-dis.relocate <1|0>" Relocate calls out of address range in the disassembler. .IP "\fB\-dbg.res\fR " 4 .IX Item "-dbg.res " Set the size of the debugger window. .IP "\fB\-dbg.fontstyle\fR <0|1|2|3>" 4 .IX Item "-dbg.fontstyle <0|1|2|3>" How to use bold fonts in the debugger window. '0' means all normal font, '1' is bold labels only, '2' is bold non-labels only, '3' is all bold font. .IP "\fB\-break\fR
" 4 .IX Item "-break
" Set a breakpoint at specified address. .IP "\fB\-debug\fR" 4 .IX Item "-debug" Immediately jump to debugger mode when starting Stella. .IP "\fB\-holdjoy0\fR " 4 .IX Item "-holdjoy0 " Start the emulator with the left joystick direction/button held down (ie, use '\s-1UF\s0' for up and fire). .IP "\fB\-holdjoy1\fR " 4 .IX Item "-holdjoy1 " Start the emulator with the right joystick direction/button held down (ie, use '\s-1UF\s0' for up and fire). .IP "\fB\-holdselect\fR" 4 .IX Item "-holdselect" Start the emulator with the Game Select switch held down. .IP "\fB\-holdreset\fR" 4 .IX Item "-holdreset" Start the emulator with the Game Reset switch held down. .IP "\fB\-tiadriven\fR <1|0>" 4 .IX Item "-tiadriven <1|0>" Set unused \s-1TIA\s0 pins to be randomly driven high or low on a read/peek. If disabled, use the last databus value for those pins instead. .IP "\fB\-cpurandom\fR " 4 .IX Item "-cpurandom " On reset, randomize the content of the specified \s-1CPU\s0 registers. .IP "\fB\-ramrandom\fR <1|0>" 4 .IX Item "-ramrandom <1|0>" On reset, either randomize all \s-1RAM\s0 content, or zero it out instead. .IP "\fB\-bs\fR " 4 .IX Item "-bs " Set \*(L"Cartridge.Type\*(R" property. See the Game Properties section for valid types. .IP "\fB\-type\fR " 4 .IX Item "-type " Same as using \-bs. .IP "\fB\-channels\fR " 4 .IX Item "-channels " Set \*(L"Cartridge.Sound\*(R" property. .IP "\fB\-ld\fR " 4 .IX Item "-ld " Set \*(L"Console.LeftDifficulty\*(R" property. .IP "\fB\-rd\fR " 4 .IX Item "-rd " Set \*(L"Console.RightDifficulty\*(R" property. .IP "\fB\-tv\fR " 4 .IX Item "-tv " Set \*(L"Console.TelevisionType\*(R" property. .IP "\fB\-sp\fR " 4 .IX Item "-sp " Set \*(L"Console.SwapPorts\*(R" property. .IP "\fB\-lc\fR " 4 .IX Item "-lc " Set \*(L"Controller.Left\*(R" property. See the Game Properties section for valid types. .IP "\fB\-rc\fR " 4 .IX Item "-rc " Set \*(L"Controller.Right\*(R" property. See the Game Properties section for valid types. .IP "\fB\-bc\fR " 4 .IX Item "-bc " Sets both \*(L"Controller.Left\*(R" and \*(L"Controller.Right\*(R" properties. See the Game Properties section for valid types. .IP "\fB\-cp\fR " 4 .IX Item "-cp " Set \*(L"Controller.SwapPaddles\*(R" property. .IP "\fB\-ma\fR " 4 .IX Item "-ma " Set \*(L"Controller.MouseAxis\*(R" property. See the Game Properties section for valid types. .IP "\fB\-format\fR " 4 .IX Item "-format " Set \*(L"Display.Format\*(R" property. See the Game Properties section for valid formats. .IP "\fB\-ystart\fR " 4 .IX Item "-ystart " Set \*(L"Display.YStart\*(R" property (0 \- 64). .IP "\fB\-height\fR " 4 .IX Item "-height " Set \*(L"Display.Height\*(R" property (210 \- 256). .IP "\fB\-pp\fR " 4 .IX Item "-pp " Set \*(L"Display.Phosphor\*(R" property. .IP "\fB\-ppblend\fR " 4 .IX Item "-ppblend " Set \*(L"Display.PPBlend\*(R" property, used for phosphor effect (0\-100). Default is 77. .IP "\fB\-thumb.trapfatal\fR <1|0>" 4 .IX Item "-thumb.trapfatal <1|0>" The default of true allows the Thumb \s-1ARM\s0 emulation to throw an exception and enter the debugger on fatal errors. When disabled, such fatal errors are simply logged, and emulation continues. Do not use this unless you know exactly what you're doing, as it changes the behaviour as compared to real hardware. Note that Thumb \s-1ARM\s0 emulation only applies to the \s-1BUS, CDF,\s0 and \s-1DPC+\s0 cartridge types. .SH "KEYBOARD" .IX Header "KEYBOARD" The Atari 2600 console controls and controllers are mapped to the computer's keyboard as shown in the following tables. However, most of these events can be remapped to other keys on your keyboard or buttons on your joystick (see \fBAdvanced Configuration \- Event Remapping\fR in the \s-1HTML\s0 documentation). The tables below show the default settings. .SS "Console Controls (can be remapped)" .IX Subsection "Console Controls (can be remapped)" .IP "\fBControl + q\fR" 4 .IX Item "Control + q" Exit emulator .IP "\fBEscape\fR" 4 .IX Item "Escape" Exit game mode/enter launcher mode .IP "\fBTab\fR" 4 .IX Item "Tab" Enter/exit options mode .IP "\fBBackslash (\e)\fR" 4 .IX Item "Backslash ()" Enter/exit command mode .IP "\fBBackquote (`)\fR" 4 .IX Item "Backquote (`)" Enter/exit debugger .IP "\fBF1\fR" 4 .IX Item "F1" Select Game .IP "\fBF2\fR" 4 .IX Item "F2" Reset Game .IP "\fBF3\fR" 4 .IX Item "F3" Color \s-1TV\s0 .IP "\fBF4\fR" 4 .IX Item "F4" Black/White \s-1TV\s0 .IP "\fBF5\fR" 4 .IX Item "F5" Left Player Difficulty A .IP "\fBF6\fR" 4 .IX Item "F6" Left Player Difficulty B .IP "\fBF7\fR" 4 .IX Item "F7" Right Player Difficulty A .IP "\fBF8\fR" 4 .IX Item "F8" Right Player Difficulty B .IP "\fBF9\fR" 4 .IX Item "F9" Save state to current slot .IP "\fBF10\fR" 4 .IX Item "F10" Change current state slot .IP "\fBF11\fR" 4 .IX Item "F11" Load state from current slot .IP "\fBF12\fR" 4 .IX Item "F12" Save \s-1PNG\s0 snapshot .IP "\fBPause\fR" 4 .IX Item "Pause" Pause/resume emulation .SS "Joystick / BoosterGrip Controller (can be remapped)" .IX Subsection "Joystick / BoosterGrip Controller (can be remapped)" \fILeft Joystick (Joy0)\fR .IX Subsection "Left Joystick (Joy0)" .IP "\fBUp arrow\fR" 4 .IX Item "Up arrow" Joystick Up .IP "\fBDown arrow\fR" 4 .IX Item "Down arrow" Joystick Down .IP "\fBLeft arrow\fR" 4 .IX Item "Left arrow" Joystick Left .IP "\fBRight arrow\fR" 4 .IX Item "Right arrow" Joystick Right .IP "\fBSpace\fR" 4 .IX Item "Space" Fire Button .IP "\fB4\fR" 4 .IX Item "4" Trigger Button .IP "\fB5\fR" 4 .IX Item "5" Booster Button .PP \fIRight Joystick (Joy1)\fR .IX Subsection "Right Joystick (Joy1)" .IP "\fBY\fR" 4 .IX Item "Y" Joystick Up .IP "\fBH\fR" 4 .IX Item "H" Joystick Down .IP "\fBG\fR" 4 .IX Item "G" Joystick Left .IP "\fBJ\fR" 4 .IX Item "J" Joystick Right .IP "\fBF\fR" 4 .IX Item "F" Fire Button .IP "\fB6\fR" 4 .IX Item "6" Trigger Button .IP "\fB7\fR" 4 .IX Item "7" Booster Button .SS "Paddle Controller digital emulation (can be remapped independently of joystick controller)" .IX Subsection "Paddle Controller digital emulation (can be remapped independently of joystick controller)" \fILeft Paddles\fR .IX Subsection "Left Paddles" .IP "\fBSame as 'Joy0 Left'\fR" 4 .IX Item "Same as 'Joy0 Left'" Paddle 0 decrease .IP "\fBSame as 'Joy0 Right'\fR" 4 .IX Item "Same as 'Joy0 Right'" Paddle 0 increase .IP "\fBSame as 'Joy0 Fire'\fR" 4 .IX Item "Same as 'Joy0 Fire'" Paddle 0 Fire .IP "\fBSame as 'Joy0 Up'\fR" 4 .IX Item "Same as 'Joy0 Up'" Paddle 1 decrease .IP "\fBSame as 'Joy0 Down'\fR" 4 .IX Item "Same as 'Joy0 Down'" Paddle 1 increase .IP "\fBSame as 'Joy0 Booster'\fR" 4 .IX Item "Same as 'Joy0 Booster'" Paddle 1 Fire .PP \fIRight Paddles\fR .IX Subsection "Right Paddles" .IP "\fBSame as 'Joy1 Left'\fR" 4 .IX Item "Same as 'Joy1 Left'" Paddle 2 decrease .IP "\fBSame as 'Joy1 Right'\fR" 4 .IX Item "Same as 'Joy1 Right'" Paddle 2 increase .IP "\fBSame as 'Joy1 Fire'\fR" 4 .IX Item "Same as 'Joy1 Fire'" Paddle 2 Fire .IP "\fBSame as 'Joy1 Up'\fR" 4 .IX Item "Same as 'Joy1 Up'" Paddle 3 decrease .IP "\fBSame as 'Joy1 Down'\fR" 4 .IX Item "Same as 'Joy1 Down'" Paddle 3 increase .IP "\fBSame as 'Joy1 Booster'\fR" 4 .IX Item "Same as 'Joy1 Booster'" Paddle 3 Fire .SS "Driving Controller (cannot be remapped, always associated with joystick controller)" .IX Subsection "Driving Controller (cannot be remapped, always associated with joystick controller)" \fILeft Driving\fR .IX Subsection "Left Driving" .IP "\fBSame as 'Joy0 Left'\fR" 4 .IX Item "Same as 'Joy0 Left'" Left Direction .IP "\fBSame as 'Joy0 Right'\fR" 4 .IX Item "Same as 'Joy0 Right'" Right Direction .IP "\fBSame as 'Joy0 Fire'\fR" 4 .IX Item "Same as 'Joy0 Fire'" Fire Button .PP \fIRight Driving\fR .IX Subsection "Right Driving" .IP "\fBSame as 'Joy1 Left'\fR" 4 .IX Item "Same as 'Joy1 Left'" Left Direction .IP "\fBSame as 'Joy1 Right'\fR" 4 .IX Item "Same as 'Joy1 Right'" Right Direction .IP "\fBSame as 'Joy1 Fire'\fR" 4 .IX Item "Same as 'Joy1 Fire'" Fire Button .SS "Sega Genesis Controller (cannot be remapped, always associated with joystick and booster-grip controllers)" .IX Subsection "Sega Genesis Controller (cannot be remapped, always associated with joystick and booster-grip controllers)" \fILeft Pad\fR .IX Subsection "Left Pad" .IP "\fBSame as 'Joy0 Up'\fR" 4 .IX Item "Same as 'Joy0 Up'" Pad Up .IP "\fBSame as 'Joy0 Down'\fR" 4 .IX Item "Same as 'Joy0 Down'" Pad Down .IP "\fBSame as 'Joy0 Left'\fR" 4 .IX Item "Same as 'Joy0 Left'" Pad Left .IP "\fBSame as 'Joy0 Right'\fR" 4 .IX Item "Same as 'Joy0 Right'" Pad Right .IP "\fBSame as 'Joy0 Fire'\fR" 4 .IX Item "Same as 'Joy0 Fire'" Button 'B' .IP "\fBSame as 'Joy0 Booster'\fR" 4 .IX Item "Same as 'Joy0 Booster'" Button 'C' .PP \fIRight Pad\fR .IX Subsection "Right Pad" .IP "\fBSame as 'Joy1 Up'\fR" 4 .IX Item "Same as 'Joy1 Up'" Pad Up .IP "\fBSame as 'Joy1 Down'\fR" 4 .IX Item "Same as 'Joy1 Down'" Pad Down .IP "\fBSame as 'Joy1 Left'\fR" 4 .IX Item "Same as 'Joy1 Left'" Pad Left .IP "\fBSame as 'Joy1 Right'\fR" 4 .IX Item "Same as 'Joy1 Right'" Pad Right .IP "\fBSame as 'Joy1 Fire'\fR" 4 .IX Item "Same as 'Joy1 Fire'" Button 'B' .IP "\fBSame as 'Joy1 Booster'\fR" 4 .IX Item "Same as 'Joy1 Booster'" Button 'C' .SS "Keypad Controller (can be remapped)" .IX Subsection "Keypad Controller (can be remapped)" \fILeft Keypad\fR .IX Subsection "Left Keypad" .IP "\fB1\fR" 4 .IX Item "1" 1 .IP "\fB2\fR" 4 .IX Item "2" 2 .IP "\fB3\fR" 4 .IX Item "3" 3 .IP "\fBQ\fR" 4 .IX Item "Q" 4 .IP "\fBW\fR" 4 .IX Item "W" 5 .IP "\fBE\fR" 4 .IX Item "E" 6 .IP "\fBA\fR" 4 .IX Item "A" 7 .IP "\fBS\fR" 4 .IX Item "S" 8 .IP "\fBD\fR" 4 .IX Item "D" 9 .IP "\fBZ\fR" 4 .IX Item "Z" \&. .IP "\fBX\fR" 4 .IX Item "X" 0 .IP "\fBC\fR" 4 .IX Item "C" # .PP \fIRight Keypad\fR .IX Subsection "Right Keypad" .IP "\fB8\fR" 4 .IX Item "8" 1 .IP "\fB9\fR" 4 .IX Item "9" 2 .IP "\fB0\fR" 4 .IX Item "0" 3 .IP "\fBI\fR" 4 .IX Item "I" 4 .IP "\fBO\fR" 4 .IX Item "O" 5 .IP "\fBP\fR" 4 .IX Item "P" 6 .IP "\fBK\fR" 4 .IX Item "K" 7 .IP "\fBL\fR" 4 .IX Item "L" 8 .IP "\fB;\fR" 4 .IX Item ";" 9 .IP "\fB,\fR" 4 .IX Item "," \&. .IP "\fB.\fR" 4 .IX Item "." 0 .IP "\fB/\fR" 4 .IX Item "/" # .SS "CompuMate Controller (cannot be remapped)" .IX Subsection "CompuMate Controller (cannot be remapped)" .IP "\fB 0 \- 9\fR" 4 .IX Item " 0 - 9" 0 \- 9 .IP "\fB A \- Z\fR" 4 .IX Item " A - Z" A \- Z .IP "\fB Comma\fR" 4 .IX Item " Comma" Comma .IP "\fB Period\fR" 4 .IX Item " Period" Period .IP "\fB Control (left or right)\fR" 4 .IX Item " Control (left or right)" Func .IP "\fB Shift (left or right)\fR" 4 .IX Item " Shift (left or right)" Shift .IP "\fB Return/Enter\fR" 4 .IX Item " Return/Enter" Enter .IP "\fB Space\fR" 4 .IX Item " Space" Space .IP "\fB Backspace\fR" 4 .IX Item " Backspace" Func-Space .IP "\fB + or Shift\-1\fR" 4 .IX Item " + or Shift-1" + .IP "\fB \- or Shift\-2\fR" 4 .IX Item " - or Shift-2" \&\- .IP "\fB Shift\-3\fR" 4 .IX Item " Shift-3" * .IP "\fB / or Shift\-4\fR" 4 .IX Item " / or Shift-4" / .IP "\fB = or Shift\-5\fR" 4 .IX Item " = or Shift-5" = .IP "\fB ? (Shift\-/) or Shift\-6\fR" 4 .IX Item " ? (Shift-/) or Shift-6" ? .IP "\fB Shift\-7\fR" 4 .IX Item " Shift-7" $ .IP "\fB [ or Shift\-8\fR" 4 .IX Item " [ or Shift-8" [ .IP "\fB ] or Shift\-9\fR" 4 .IX Item " ] or Shift-9" ] .IP "\fB "" (Shift\-') or Shift\-0\fR" 4 .IX Item " "" (Shift-') or Shift-0" " .SS "\s-1TV\s0 effects (cannot be remapped, only active in \s-1TIA\s0 mode)" .IX Subsection "TV effects (cannot be remapped, only active in TIA mode)" .IP "\fBAlt + 1\fR" 4 .IX Item "Alt + 1" Disable \s-1TV\s0 effects .IP "\fBAlt + 2\fR" 4 .IX Item "Alt + 2" Select 'Composite' preset .IP "\fBAlt + 3\fR" 4 .IX Item "Alt + 3" Select 'S\-video' preset .IP "\fBAlt + 4\fR" 4 .IX Item "Alt + 4" Select '\s-1RGB\s0' preset .IP "\fBAlt + 5\fR" 4 .IX Item "Alt + 5" Select 'Badly adjusted' preset .IP "\fBAlt + 6\fR" 4 .IX Item "Alt + 6" Select 'Custom' preset .IP "\fBShift-Alt + 7\fR" 4 .IX Item "Shift-Alt + 7" Decrease scanline intensity .IP "\fBAlt + 7\fR" 4 .IX Item "Alt + 7" Increase scanline intensity .IP "\fBShift-Alt + 8\fR" 4 .IX Item "Shift-Alt + 8" Disable scanline interpolation .IP "\fBAlt + 8\fR" 4 .IX Item "Alt + 8" Enable scanline interpolation .IP "\fBShift-Alt + 9\fR" 4 .IX Item "Shift-Alt + 9" Select previous 'Custom' mode attribute (*) .IP "\fBAlt + 9\fR" 4 .IX Item "Alt + 9" Select next 'Custom' mode attribute (*) .IP "\fBShift-Alt + 0\fR" 4 .IX Item "Shift-Alt + 0" Decrease 'Custom' selected attribute value (*) .IP "\fBAlt + 0\fR" 4 .IX Item "Alt + 0" Increase 'Custom' selected attribute value (*) .PP Items marked as (*) are only available in 'Custom' preset mode .SS "Developer Keys in \s-1TIA\s0 mode (cannot be remapped)" .IX Subsection "Developer Keys in TIA mode (cannot be remapped)" .IP "\fBAlt + PageUp\fR" 4 .IX Item "Alt + PageUp" Set \*(L"Display.YStart\*(R" to next larger value .IP "\fBAlt + PageDown\fR" 4 .IX Item "Alt + PageDown" Set \*(L"Display.YStart\*(R" to next smaller value .IP "\fBControl + PageUp\fR" 4 .IX Item "Control + PageUp" Set \*(L"Display.Height\*(R" to next larger value .IP "\fBControl + PageDown\fR" 4 .IX Item "Control + PageDown" Set \*(L"Display.Height\*(R" to next smaller value .IP "\fBAlt + l\fR" 4 .IX Item "Alt + l" Toggle frame stats (scanline count/fps/bs type/etc) .IP "\fBAlt + z\fR" 4 .IX Item "Alt + z" Toggle \s-1TIA\s0 Player0 object .IP "\fBAlt + x\fR" 4 .IX Item "Alt + x" Toggle \s-1TIA\s0 Player1 object .IP "\fBAlt + c\fR" 4 .IX Item "Alt + c" Toggle \s-1TIA\s0 Missile0 object .IP "\fBAlt + v\fR" 4 .IX Item "Alt + v" Toggle \s-1TIA\s0 Missile1 object .IP "\fBAlt + b\fR" 4 .IX Item "Alt + b" Toggle \s-1TIA\s0 Ball object .IP "\fBAlt + n\fR" 4 .IX Item "Alt + n" Toggle \s-1TIA\s0 Playfield object .IP "\fBShift-Alt + z\fR" 4 .IX Item "Shift-Alt + z" Toggle \s-1TIA\s0 Player0 collisions .IP "\fBShift-Alt + x\fR" 4 .IX Item "Shift-Alt + x" Toggle \s-1TIA\s0 Player1 collisions .IP "\fBShift-Alt + c\fR" 4 .IX Item "Shift-Alt + c" Toggle \s-1TIA\s0 Missile0 collisions .IP "\fBShift-Alt + v\fR" 4 .IX Item "Shift-Alt + v" Toggle \s-1TIA\s0 Missile1 collisions .IP "\fBShift-Alt + b\fR" 4 .IX Item "Shift-Alt + b" Toggle \s-1TIA\s0 Ball collisions .IP "\fBShift-Alt + n\fR" 4 .IX Item "Shift-Alt + n" Toggle \s-1TIA\s0 Playfield collisions .IP "\fBAlt + m\fR" 4 .IX Item "Alt + m" Toggle \s-1TIA HMOVE\s0 blanks .IP "\fBAlt + Comma\fR" 4 .IX Item "Alt + Comma" Toggle \s-1TIA \s0'Fixed Debug Colors' mode .IP "\fBAlt + .\fR" 4 .IX Item "Alt + ." Toggle all \s-1TIA\s0 objects .IP "\fBShift-Alt + .\fR" 4 .IX Item "Shift-Alt + ." Toggle all \s-1TIA\s0 collisions .SS "Other Keys (cannot be remapped, except those marked with '*')" .IX Subsection "Other Keys (cannot be remapped, except those marked with '*')" .IP "\fBAlt + =\fR" 4 .IX Item "Alt + =" Switch to next larger zoom level .IP "\fBAlt + \-\fR" 4 .IX Item "Alt + -" Switch to next smaller zoom level .IP "\fBAlt + Enter\fR" 4 .IX Item "Alt + Enter" Toggle fullscreen/windowed mode .IP "\fBAlt + [\fR" 4 .IX Item "Alt + [" Decrease volume (*) .IP "\fBAlt + ]\fR" 4 .IX Item "Alt + ]" Increase volume (*) .IP "\fBControl + f\fR" 4 .IX Item "Control + f" Toggle console type in increasing order (\s-1NTSC/PAL/SECAM,\s0 etc)) .IP "\fBShift-Control + f\fR" 4 .IX Item "Shift-Control + f" Toggle console type in decreasing order (\s-1NTSC/PAL/SECAM,\s0 etc)) .IP "\fBControl + s\fR" 4 .IX Item "Control + s" Save current properties to a new properties file .IP "\fBControl + 0\fR" 4 .IX Item "Control + 0" Switch mouse between controller emulation modes .IP "\fBControl + 1\fR" 4 .IX Item "Control + 1" Swap Stelladaptor/2600\-daptor port ordering .IP "\fBControl + r\fR" 4 .IX Item "Control + r" Reload current \s-1ROM \s0(singlecart \s-1ROM, TIA\s0 mode) or Load next game in \s-1ROM \s0(multicart \s-1ROM, TIA\s0 mode) .IP "\fBControl + r\fR" 4 .IX Item "Control + r" Reload \s-1ROM\s0 listing (\s-1ROM\s0 launcher mode) .IP "\fBBackspace\fR" 4 .IX Item "Backspace" Emulate 'frying' effect (\s-1TIA\s0 mode) (*), Go to parent directory (\s-1UI\s0 mode) (*) =item \fBAlt + p\fR .Sp Toggle 'phosphor' effect .IP "\fBControl + p\fR" 4 .IX Item "Control + p" Toggle palette .IP "\fBControl + l\fR" 4 .IX Item "Control + l" Toggle \s-1PAL\s0 color-loss effect .IP "\fBAlt + s\fR" 4 .IX Item "Alt + s" Save continuous \s-1PNG\s0 snapshots (per interval) .IP "\fBShift-Alt + s\fR" 4 .IX Item "Shift-Alt + s" Save continuous \s-1PNG\s0 snapshots (every frame) .SS "\s-1UI\s0 keys in Text Editing areas (cannot be remapped)" .IX Subsection "UI keys in Text Editing areas (cannot be remapped)" .IP "\fBHome\fR" 4 .IX Item "Home" Move cursor to beginning of line .IP "\fBEnd\fR" 4 .IX Item "End" Move cursor to end of line .IP "\fBDelete\fR" 4 .IX Item "Delete" Remove character to right of cursor .IP "\fBBackspace\fR" 4 .IX Item "Backspace" Remove character to left of cursor .IP "\fBControl-a\fR" 4 .IX Item "Control-a" Same function as 'Home' .IP "\fBControl-e\fR" 4 .IX Item "Control-e" Same function as 'End' .IP "\fBControl-d\fR" 4 .IX Item "Control-d" Same function as 'Delete' .IP "\fBControl-k\fR" 4 .IX Item "Control-k" Remove all characters from cursor to end of line .IP "\fBControl-u\fR" 4 .IX Item "Control-u" Remove all characters from cursor to beginning of line .IP "\fBControl-w\fR" 4 .IX Item "Control-w" Remove entire word to left of cursor .IP "\fBControl-Left\fR" 4 .IX Item "Control-Left" Move cursor to beginning of word to the left .IP "\fBControl-Right\fR" 4 .IX Item "Control-Right" Move cursor to beginning of word to the right .IP "\fBControl-c\fR" 4 .IX Item "Control-c" Copy entire line to clipboard (not complete) .IP "\fBControl-v\fR" 4 .IX Item "Control-v" Paste clipboard contents (not complete) .SH "FILES" .IX Header "FILES" Starting with 5.0, \fBstella\fR uses \fB\f(CB$HOME\fB/.config/stella/\fR as the per-user config directory. Previous versions used \fB\f(CB$HOME\fB/.stella/\fR. .PP The config directory contains the following: .IP "\fBstellarc\fR" 4 .IX Item "stellarc" The Stella config file, created by \fBstella\fR. May be hand-edited, but normally the built-in \s-1GUI\s0 is used to set these options. .IP "\fBcfg/\fR" 4 .IX Item "cfg/" Directory for DiStella config files, used only by the debugger. .IP "\fBnvram/\fR" 4 .IX Item "nvram/" Directory used to store the contents of non-volatile cartridge memory. .IP "\fBstate/\fR" 4 .IX Item "state/" Directory used to store save-states (see \fBF9\fR key). .SH "AUTHORS" .IX Header "AUTHORS" Stella was originally developed for Linux by Bradford W. Mott , and is currently maintained by Stephen Anthony . Other contributors include Eckhard Stolberg and Brian Watson . .SH "SEE ALSO" .IX Header "SEE ALSO" Stella web site: \fIhttp://stella.sourceforge.net/\fR.