diff --git a/games/stella/stella.6 b/games/stella/stella.6 index 0831ce29c1..d7c868fd3b 100644 --- a/games/stella/stella.6 +++ b/games/stella/stella.6 @@ -1,1127 +1,726 @@ -.\" 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 +.TH stella 6 "January 12, 2019" stella +.SH NAME +stella \- Atari 2600 emulator +.SH SYNOPSIS +.B stella +[\fIoptions\fP] <\fIROM file\fP> +.SH DESCRIPTION +.B stella +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>" +.SH OPTIONS +.B stella +accepts the following options: +.TP +.BR \-video " <" opengl | opengles2 | opengles | software > +Use OpenGL, OpenGLES or SDL software rendering mode; the default is +the best available mode detected. +.TP +.BR \-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>" +.TP +.BR \-fullscreen " <" 1 | 0 > +Play the game in fullscreen mode (\fB1\fP) or in a window (\fB0\fP). +.TP +.BR \-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 +.TP +.BR \-palette " <" standard | z26 | user > +Sets the palette to either normal Stella, the one used in the \fBz26\fP 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>" +.TP +.BR \-speed " <\fInumber\fP>" +Controls the emulation speed (as a percentage, between 10 and 1000, +from one-tenth the native speed to ten times the native speed). +.TP +.BR \-uimessages " <" 1 | 0 > +Enable or disable display of message in the UI. +Note that messages indicating serious errors override this setting, +and are always shown. +.TP +.BR \-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 " +.TP +.BR \-fragsize " <\fInumber\fP>" +Specify the sound fragment size to use. Under Debian the recommended +value is 512. +.TP +.BR \-freq " <\fInumber\fP>" +Set sound sample output frequency (0 - 48000). Default is 31400. Do +not change unless you experience sound issues. +.TP +.BR \-volume " <\fInumber\fP>" +Set the volume (0 - 100). +.TP +.BR \-tia.zoom " <\fInumber\fP>" 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 +.TP +.BR \-tia.inter " <" 1 | 0 > +Use interpolation for the TIA 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 +.TP +.BR \-tia.aspectn " <\fInumber\fP>, " \-tia.aspectp " <\fInumber\fP>" +Specify the amount (as a percentage) to scale the TIA image width in +NTSC and PAL mode. Since many video modes do not use square pixels, +you can reduce width until the pixels appear square. Allowable values +are 80\-120; the author finds 85\-90 gives the mos authentic look for +NTSC, and 105\-110 for PAL. +.TP +.BR \-tia.fsfill " <" 1 | 0 > +Stretch TIA 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' +.TP +.BR \-tia.dbgcolors " <\fIroygbp\fP>" +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. +.TP +.BR \-tv.filter " <" 0 \- 5 > +Blargg TV effects, 0 is disabled, next numbers in sequence represent +presets for "Composite", "S-Video", "RGB", "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 +.TP +.BR \-tv.phosphor " <" always | byrom > +Determines how phosphor mode is enabled. If +.BR always , +then the ROM properties entry is ignored, and phosphor mode is always +turned on. +Otherwise, the ROM properties determine whether phosphor mode is used +for each ROM. +.TP +.BR \-tv.scanlines " <" 0 \- 100 > +TV effects scanline intensity, where 0 means completely off. +.TP +.BR \-tv.scaninter " <" 1 | 0 > +Blargg TV 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 +.TP +.BR \-tv.contrast " <\fInumber\fP>" +Blargg TV effects 'contrast' (only available in custom mode, range +\-1.0 to 1.0). +.TP +.BR \-tv.brightness " <\fInumber\fP>" +Blargg TV effects 'brightness' (only available in custom mode, range +\-1.0 to 1.0). +.TP +.BR \-tv.hue " <\fInumber\fP>" +Blargg TV effects 'hue' (only available in custom mode, range \-1.0 to +1.0). +.TP +.BR \-tv.saturation " <\fInumber\fP>" +Blargg TV effects 'saturation' (only available in custom mode, range +\-1.0 to 1.0). +.TP +.BR \-tv.gamma " <\fInumber\fP>" +Blargg TV effects 'gamma' (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 +.TP +.BR \-tv.sharpness " <\fInumber\fP>" +Blargg TV effects 'sharpness' (only available in custom mode, range +\-1.0 to 1.0). +.TP +.BR \-tv.resolution " <\fInumber\fP>" +Blargg TV effects 'resolution' (only available in custom mode, range +\-1.0 to 1.0). +.TP +.BR \-tv.artifacts " <\fInumber\fP>" +Blargg TV effects 'artifacts' (only available in custom mode, range +\-1.0 to 1.0). +.TP +.BR \-tv.fringing " <\fInumber\fP>" +Blargg TV effects 'fringing' (only available in custom mode, range +\-1.0 to 1.0). +.TP +.BR \-tv.bleed " <\fInumber\fP>" +Blargg TV effects 'bleed' (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>" +.TP +.BR \-cheat " <\fIcode\fP>" +Use the specified cheatcode (see the \fICheat\fP section in the +provided documentation for a description of cheatcodes). +.TP +.BR \-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. +.TP +.BR \-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>" +console/commandline as it's being collected. An internal log will +still be kept, and the amount of logging is still controlled +by \fBloglevel\fP. +.TP +.BR \-joydeadzone " <\fInumber\fP>" +Sets the joystick deadzone area for analog joysticks. Accepts a number +from 0 - 29, and uses the formula 3200 + \fInumber\fP * 1000. So the +possible deadzone values range from 3200 to 32200. +.TP +.BR \-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. +.TP +.BR \-usemouse " <" always | analog | never > +Use mouse as a controller as specified by ROM properties in specific +case. \fBalways\fP and \fBnever\fP are self-explanatory, \fBanalog\fP +means only for analog-type devices (paddles, trackball, etc.). +.TP +.BR \-grabmouse " <" 1 | 0 > +Keeps the mouse in the game window in emulation mode. +.TP +.BR \-cursor " <" 0 | 1 | 2 | 3 > +Set mouse cursor state in UI/emulation modes. +.TP +.BR \-dsense " <\fInumber\fP>" +Sensitivity for emulation of paddles when using a digital device +(joystick digital axis or button, keyboard key, etc.). \fInumber\fP +may range from 1 to 20, with larger numbers causing faster movement. +.TP +.BR \-msense " <\fInumber\fP>" +Sensitivity for emulation of paddles when using a mouse. \fInumber\fP +may range from 1 to 20, with larger numbers causing faster movement. +.TP +.BR \-tsense " <\fInumber\fP>" +Sensitivity for emulation of trackball controllers when using a mouse. +\fInumber\fP may range from 1 to 20, with larger numbers causing +faster movement. +.TP +.BR \-saport " <" lr | rl > +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. +.TP +.BR \-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 +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 " +.TP +.BR \-autoslot " <" 1 | 0 > +Automatically switch to the next available save state slot after +saving a ROM state file. +.TP +.BR \-fastscbios " <" 1 | 0 > +Disable Supercharger BIOS progress loading bars. +.TP +.BR \-snapsavedir " <\fIpath\fP>" The directory to save snapshot files to. -.IP "\fB\-snaploaddir\fR " 4 -.IX Item "-snaploaddir " +.TP +.BR \-snaploaddir " <\fIpath\fP>" The directory to load snapshot files from. -.IP "\fB\-snapname\fR " 4 -.IX Item "-snapname " +.TP +.BR \-snapname " <" int | rom > 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>" +actual ROM filename. +.TP +.BR \-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 +.TP +.BR \-ss1x " <" 1 | 0 > +Ignore any scaling applied to the TIA image, and save snapshot in unscaled (1x) mode. -.IP "\fB\-ssinterval\fR " 4 -.IX Item "-ssinterval " +.TP +.BR \-ssinterval " <\fInumber\fP>" 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, +snapshot mode (currently, 1 - 10). +.TP +.BR \-rominfo " <\fIrom\fP>" +Display detailed information about the given ROM, and then exit +Stella. +.TP +.BR \-listrominfo +Prints relevant contents of the Stella ROM database, one ROM 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 +.TP +.BR \-exitlauncher " <" 1 | 0 > +Always exit to ROM launcher when exiting a ROM (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 +.TP +.BR \-launcherres " <\fIW\fP" x \fIH\fP> +Set the size of the ROM launcher. +.TP +.BR \-launcherfont " <" small | medium | large > +Set the size of the font in the ROM launcher. +.TP +.BR \-laucnherroms " <" 1 | 0 > +Specifies whether to show ROMs only (the default) or all files in the +ROM launcher. +.TP +.BR \-romviewer " <" 0 | 1 | 2 > +Hide ROM info viewer in ROM 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 " +.TP +.BR \-uipalette " <" standard | classic > +Use the specified palette for UI elements. +.TP +.BR \-listdelay " <\fIdelay\fP>" 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 " +as a single word in list widgets (value can range from 300-1000). +.TP +.BR \-mwheel " <\fIlines\fP>" +Set the number of lines a mousewheel will scroll in the UI. +.TP +.BR \-romdir " <\fIdir\fP>" +Set the directory where the ROM launcher will start. +.TP +.BR \-statedir " <\fIdir\fP>" +Set the directory in which to save state files. +.TP +.BR \-cheatfile " <\fIfile\fP>" Set the full pathname of the cheatfile database. -.IP "\fB\-palettefile\fR " 4 -.IX Item "-palettefile " +.TP +.BR \-palettefile " <\fIfile\fP>" 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 " +.TP +.BR \-propsfile " <\fIfile\fP>" +Set the full pathname of the ROM properties file. +.TP +.BR \-nvramdir " <\fIdir\fP>" +Set the directory in which to save EEPROM files. +.TP +.BR \-cfgdir " <\fIdir\fP>" Set the directory in which to access Distella config files. -.IP "\fB\-avoxport\fR " 4 -.IX Item "-avoxport " +.TP +.BR \-avoxport " <\fIname\fP>" 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>" +.TP +.BR \-maxres " <\fIW\fP" x \fIH\fP> +Useful for developers, this sets the maximum size of window that can +be created, allowing to simulate testing on 'smaller' systems. +.TP +.BR \-help +Print a help message describing these options, and then exit Stella. + +.P +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 \fBnot\fP case sensitive. +.TP +.BR \-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>" +disassembler. See the \fIDebugger\fP section in the provided +documentation for more information. +.TP +.BR \-dis.gfxformat " <" 2 | 16 > +Sets the base to use for displaying GFX sections in the disassembler. +.TP +.BR \-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>" +.TP +.BR \-dis.relocate " <" 1 | 0 > Relocate calls out of address range in the disassembler. -.IP "\fB\-dbg.res\fR " 4 -.IX Item "-dbg.res " +.TP +.BR \-dbg.res " <\fIW\fP" x \fIH\fP> 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" +.TP +.BR \-dbg.fontsize " <" small | medium | large > +Set the font size in the debugger window. +.TP +.BR \-dbg.fontstyle " <" 0 | 1 | 2 | 3 > +How to use bold fonts in the debugger window. \fB0\fP means all normal +font, \fB1\fP is bold labels only, \fB2\fP is bold non-labels only, +\fB3\fP is all bold font. +.TP +.BR \-dbg.ghostreadstrap " <" 1 | 0 > +Debugger considers/ignores 'ghost' reads for trap addresses. +.TP +.BR \-dbg.uhex " <" 0 | 1 > +Lower/uppercase hexadecimal display. +.TP +.BR \-break " <\fIaddress\fP>" +Set a breakpoint at a specified address. +.TP +.BR \-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" +.TP +.BR \-holdjoy0 " [" UDLRF ] +Start the emulator with the specified left joystick direction and +button held down (\fBUF\fP for up and fire). +After entering the emulation, you will have to press and release the +direction again to release the event. +.TP +.BR \-holdjoy1 " [" UDLRF ] +Start the emulator with the specified right joystick direction and +button held down (\fBUF\fP for up and fire). +After entering the emulation, you will have to press and release the +direction again to release the event. +.TP +.BR \-holdselect Start the emulator with the Game Select switch held down. -.IP "\fB\-holdreset\fR" 4 -.IX Item "-holdreset" +After entering the emulation, you will have to press and +release 'Select' to release the event. +.TP +.BR \-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" +After entering the emulation, you will have to press and +release 'Reset' to release the event. +.TP +.BR \-bs " <\fItype\fP>, " \-type " <\fItype\fP>" +Set "Cartridge.Type" property. See the \fIGame Properties\fP section +in the provided documentation for valid types. +.TP +.BR \-channels " <" Mono | Stereo > +Set "Cartridge.Sound" property. +.TP +.BR \-ld " <" A | B > +Set "Console.LeftDifficulty" property. +.TP +.BR \-rd " <" A | B > +Set "Console.RightDifficulty" property. +.TP +.BR \-tv " <" Color | BlackAndWhite > +Set "Console.TelevitionType" property. +.TP +.BR \-sp " <" Yes | No > +Set "Console.SwapPorts" property. +.TP +.BR \-lc " <\fItype\fP>" +Set "Controller.Left" property. See the \fIGame Properties\fP section +in the provided documentation for valid types. +.TP +.BR \-rc " <\fItype\fP>" +Set "Controller.Right" property. See the \fIGame Properties\fP section +in the provided documentation for valid types. +.TP +.BR \-bc " <\fItype\fP>" +Sets both "Controller.Left" and "Controller.Right" properties. See the +\fIGame Properties\fP section in the provided documentation for valid +types. +.TP +.BR \-cp " <" Yes | No > +Set "Controller.SwapPaddles" property. See the \fIGame Properties\fP +section in the provided documentation for valid types. +.TP +.BR \-ma " <" Auto | XY > +Set "Controller.MouseAxis" property. See the \fIGame Properties\fP +section in the provided documentation for valid types. +.TP +.BR \-format " <\fIformat\fP>" +Set "Display.Format" property. See the \fIGame Properties\fP section +in the provided documentation for valid formats. +.TP +.BR \-ystart " <\fInumber\fP>" +Set "Display.YStart" property (0 - 64). +.TP +.BR \-height " <\fInumber\fP>" +Set "Display.Height" property (210 - 256). +.TP +.BR \-pp " <" Yes | No > +Set "Display.Phosphor" property. +.TP +.BR \-ppblend " <\fInumber\fI>" +Set "Display.PPBlend" property, used for phosphor effect +(0-100). Default is 77. + +.P +The following are available in two sets, one for players (prefixed by +.BR plr. ) +and one for developers (prefixed by +.BR dev. ). +Only use them if you know what you're doing! +Note that in all cases, the values supplied to the arguments are +\fBnot\fP case sensitive. +.TP +.BR \-dev.settings " <" 1 | 0 > +Select developer +.RB ( 1 ) +or player +.RB ( 0 ) +set. +.TP +.BR \- < plr | dev > .stats " <" 1 | 0 > +Overlay console info on the TIA image during emulation. +.TP +.BR \- < plr | dev > .console " <" 2600 | 7800 > +Select console for B/W and Pause key handling and RAM initialization. +.TP +.BR \- < plr | dev > .bankrandom " <" 1 | 0 > +On reset, randomize the startup bank (only for selected bankswitch +types). +.TP +.BR \- < plr | dev > .ramrandom " <" 1 | 0 > +On reset, either randomize all RAM content, or zero it out instead. +.TP +.BR \- < plr | dev > .cpurandom " [" SAXYP ] +On reset, randomize the content of the specified CPU registers. +.TP +.BR \- < plr | dev > .tiadriven " <" 1 | 0 > +Set unused TIA pins to be randomly driven high or low on a read/peek. +.TP +.BR \- < plr | dev > .rwportbreak " <" 1 | 0 > +Since the 2600 has no dedicated R/W line, different addresses are used +for RAM read or write access. +If the code reads from such a write address, this causes an unwanted, +semi-random write to that address. +When this option is enabled, such reads interrupt emulation and the +debugger is entered. +.TP +.BR \- < plr | dev > .thumb.trapfatal " <" true | false > +The default of \fBtrue\fP allows the Thumb ARM 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. +.TP +.BR \- < plr | dev > .eepromaccess " <" 1 | 0 > +When enabled, each read or write access to the AtariVox/SaveKey EEPROM +is signalled by a message. +.TP +.BR \- < plr | dev > .tv.jitter " <" 1 | 0 > +Enable TV jitter/roll effect, when there are too many or too few +scanlines per frame. +.TP +.BR \- < plr | dev > .tv.jitter_recovery " <" 1 - 20 > +When TV jitter/roll effect is enabled, determines how long to delay +recovery time (recovery spread over multiple frames). +.TP +.BR \- < plr | dev > .colorloss " <" 1 | 0 > +Enable/disable the PAL color-loss effect. +.TP +.BR \- < plr | dev > .debugcolors " <" 1 | 0 > +Enable/disable the fixed debug colors. +.TP +.BR \- < plr | dev > .timemachine " <" 1 | 0 > +Enables the Time Machine. +.TP +.BR \- < plr | dev > .tm.size " <" 20 - 1000 > +Defines the Time Machine buffer size. +.TP +.BR \- < plr | dev > .tm.uncompressed " <" 0 - 1000 > +Defines the uncompressed Time Machine buffer size. +Must be less than Time Machine the buffer size. +.TP +.BR \- < plr | dev > .tm.interval " <" 1f | 3f | 10f | 30f | 1s | 3s | 10s > +Defines the interval between two save states. +.TP +.BR \- < plr | dev > .tm.horizon " <" 3s | 10s | 30s | 1m | 3m | 10m | 30m | 60m > +Defines the horizon of the Time Machine. + +.SH KEYBOARD CONTROLS The Atari 2600 console controls and controllers are mapped to the -computer's keyboard as shown in the following tables. However, most of +computer's keyboard as shown in the following sections. 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" +on your joystick. + +.SS Console controls (can be remapped) +.IP "Control + q" Exit emulator -.IP "\fBEscape\fR" 4 -.IX Item "Escape" +.IP Escape Exit game mode/enter launcher mode -.IP "\fBTab\fR" 4 -.IX Item "Tab" +.IP Tab Enter/exit options mode -.IP "\fBBackslash (\e)\fR" 4 -.IX Item "Backslash ()" +.IP "Backslash (\e)" Enter/exit command mode -.IP "\fBBackquote (`)\fR" 4 -.IX Item "Backquote (`)" +.IP "Backquote (`)" Enter/exit debugger -.IP "\fBF1\fR" 4 -.IX Item "F1" +.IP F1 Select Game -.IP "\fBF2\fR" 4 -.IX Item "F2" +.IP 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" +.IP F3 +Color TV +.IP F4 +Black/White TV +.IP F5 Left Player Difficulty A -.IP "\fBF6\fR" 4 -.IX Item "F6" +.IP F6 Left Player Difficulty B -.IP "\fBF7\fR" 4 -.IX Item "F7" +.IP F7 Right Player Difficulty A -.IP "\fBF8\fR" 4 -.IX Item "F8" +.IP F8 Right Player Difficulty B -.IP "\fBF9\fR" 4 -.IX Item "F9" +.IP F9 Save state to current slot -.IP "\fBF10\fR" 4 -.IX Item "F10" +.IP F10 Change current state slot -.IP "\fBF11\fR" 4 -.IX Item "F11" +.IP 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" +.IP F12 +Save PNG snapshot +.IP 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'" + +.SS Joystick / BoosterGrip Controller (can be remapped) +.P +Left joystick: +.IP "Up arrow" +Joystick up +.IP "Down arrow" +Joystick down +.IP "Left arrow" +Joystick left +.IP "Right arrow" +Joystick right +.IP Space +Fire button +.IP 4 +Trigger button +.IP 5 +Booster button +.P +Right joystick: +.IP Y +Joystick up +.IP H +Joystick down +.IP G +Joystick left +.IP J +Joystick right +.IP F +Fire button +.IP 6 +Trigger button +.IP 7 +Booster button + +.SS Paddle Controller digital emulation (can be remapped independently of joystick controller) +.P +By default the left paddles are mapped to the left joystick as follows: +.IP Left Paddle 0 decrease -.IP "\fBSame as 'Joy0 Right'\fR" 4 -.IX Item "Same as 'Joy0 Right'" +.IP 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'" +.IP Fire +Paddle 0 fire +.IP Up Paddle 1 decrease -.IP "\fBSame as 'Joy0 Down'\fR" 4 -.IX Item "Same as 'Joy0 Down'" +.IP 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'" +.IP Booster +Paddle 1 fire +.P +The same mappings on the right joystick correspond to the right +paddles (paddles 2 and 3 respectively). + +.SS Driving Controller (cannot be remapped, always associated with joystick controllers) +Each driving controller is mapped to the corresponding joystick, using +the left, right and fire controls. + +.SS Sega Genesis Controller (cannot be remapped, always associated with joystick and booster-grip controllers) +Each pad is mapped to the correspondig joystick as follows: +.IP Up +Up +.IP Down +Down +.IP Left +Left +.IP Right +Right +.IP Fire Button 'B' -.IP "\fBSame as 'Joy0 Booster'\fR" 4 -.IX Item "Same as 'Joy0 Booster'" +.IP 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" + +.SS Keypad Controller (can be remapped) +.P +Left keypad (press the key on the left to emulate the key on the +right): +.IP 1 1 -.IP "\fB2\fR" 4 -.IX Item "2" +.IP 2 2 -.IP "\fB3\fR" 4 -.IX Item "3" +.IP 3 3 -.IP "\fBQ\fR" 4 -.IX Item "Q" +.IP Q 4 -.IP "\fBW\fR" 4 -.IX Item "W" +.IP W 5 -.IP "\fBE\fR" 4 -.IX Item "E" +.IP E 6 -.IP "\fBA\fR" 4 -.IX Item "A" +.IP A 7 -.IP "\fBS\fR" 4 -.IX Item "S" +.IP S 8 -.IP "\fBD\fR" 4 -.IX Item "D" +.IP D 9 -.IP "\fBZ\fR" 4 -.IX Item "Z" +.IP Z \&. -.IP "\fBX\fR" 4 -.IX Item "X" +.IP X 0 -.IP "\fBC\fR" 4 -.IX Item "C" +.IP C # -.PP -\fIRight Keypad\fR -.IX Subsection "Right Keypad" -.IP "\fB8\fR" 4 -.IX Item "8" + +.P +Right keypad: +.IP 8 1 -.IP "\fB9\fR" 4 -.IX Item "9" +.IP 9 2 -.IP "\fB0\fR" 4 -.IX Item "0" +.IP "0 (the digit)" 3 -.IP "\fBI\fR" 4 -.IX Item "I" +.IP I 4 -.IP "\fBO\fR" 4 -.IX Item "O" +.IP "O (the letter)" 5 -.IP "\fBP\fR" 4 -.IX Item "P" +.IP P 6 -.IP "\fBK\fR" 4 -.IX Item "K" +.IP K 7 -.IP "\fBL\fR" 4 -.IX Item "L" +.IP L 8 -.IP "\fB;\fR" 4 -.IX Item ";" +.IP ; 9 -.IP "\fB,\fR" 4 -.IX Item "," +.IP , \&. -.IP "\fB.\fR" 4 -.IX Item "." +.IP . 0 -.IP "\fB/\fR" 4 -.IX Item "/" +.IP / # -.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" + +.SS CompuMate Controller (cannot be remapped) +.P +.IP 0-9 +0-9 +.IP A-Z +A-Z +.IP Comma Comma -.IP "\fB Period\fR" 4 -.IX Item " Period" +.IP Period Period -.IP "\fB Control (left or right)\fR" 4 -.IX Item " Control (left or right)" +.IP Control Func -.IP "\fB Shift (left or right)\fR" 4 -.IX Item " Shift (left or right)" +.IP Shift Shift -.IP "\fB Return/Enter\fR" 4 -.IX Item " Return/Enter" +.IP "; or Return/Enter" Enter -.IP "\fB Space\fR" 4 -.IX Item " Space" +.IP "/ or Space" Space -.IP "\fB Backspace\fR" 4 -.IX Item " Backspace" +.IP 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. + +.SH FILES +.IP ~/.config/stella/stellarc +Default options (command line options override these). Lines starting +with ';' are considered comments and are ignored. Any other line must +be of the form <\fIcommand\fP> \fB=\fP <\fIvalue\fP>, where +\fIcommand\fP is the same as that specified on the command line, +without the '-' character, and \fIvalue\fP is the value given to the +setting. +.IP ~/.config/stella/atarivox_eeprom.dat +Default storage for the emulated EEPROM portion of an attached +AtariVox device. +.IP ~/.config/stella/savekey_eeprom.dat +Default storage for the emulated EEPROM portion of an attached SaveKey +device. +.IP ~/.config/stella/stella.cht +Default location of the cheat database file. + +.SH SEE ALSO +\fB/usr/share/doc/stella/index.html\fP, +\fB/usr/share/doc/stella/debugger.html\fP. + +.SH AUTHORS +\fBstella\fP was written by Bradford W. Mott, Stephen Anthony and the +Stella Team. + +This manual page was adapted from the provided documentation by +Stephen Kitt , for the Debian GNU/Linux system (but +may be used by others). It was last modified for \fBstella\fP version +6.0. diff --git a/games/stella/stella.SlackBuild b/games/stella/stella.SlackBuild index 990c9fc111..4c4f6cc0f8 100644 --- a/games/stella/stella.SlackBuild +++ b/games/stella/stella.SlackBuild @@ -8,6 +8,10 @@ # Now maintained by B. Watson +# 20191201 bkw: +# - update for 6.0.2. +# - replace my outdated man page with the up-to-date one from Debian. + # 20180611 bkw: update for 5.1.3, move binary to /usr/games # 20180206 bkw: update for 5.1 # 20170821 bkw: update for 5.0.2 @@ -37,7 +41,7 @@ # - StartupNotify=false in .desktop PRGNAM=stella -VERSION=${VERSION:-5.1.3} +VERSION=${VERSION:-6.0.2} BUILD=${BUILD:-1} TAG=${TAG:-_SBo} @@ -76,16 +80,12 @@ cd $TMP rm -rf $PRGNAM-$VERSION tar xvf $CWD/$PRGNAM-$VERSION-src.tar.xz cd $PRGNAM-$VERSION -chown -R root:root . -find -L . \ - \( -perm 777 -o -perm 775 -o -perm 750 -o -perm 711 -o -perm 555 -o -perm 511 \) \ - -exec chmod 755 {} \; -o \ - \( -perm 666 -o -perm 664 -o -perm 600 -o -perm 444 -o -perm 440 -o -perm 400 \) \ - -exec chmod 644 {} \; +find -L . -perm /111 -a \! -perm 755 -a -exec chmod 755 {} \+ -o \ + \! -perm /111 -a \! -perm 644 -a -exec chmod 644 {} \+ # 20170620 bkw: configure checks for gcc 4.7, 5.x, or 6.x. Fails on -current # because we have 7.x. -sed -i 's,\[5-6\],[5-9],g' configure +#sed -i 's,\[5-6\],[5-9],g' configure CFLAGS="$SLKCFLAGS" \ CXXFLAGS="$SLKCFLAGS" \ @@ -105,7 +105,7 @@ ln -s \ ../icons/hicolor/128x128/apps/$PRGNAM.png \ $PKG/usr/share/pixmaps/$PRGNAM.png -# Man page written for this build. +# Man page borrowed from Debian. # Upstream said he'd be shipping a man page starting with 4.7, so I could # quit including one here, but so far it hasn't happened... mkdir -p $PKG/usr/man/man6 diff --git a/games/stella/stella.info b/games/stella/stella.info index c77077e2a4..4f84ddc7dd 100644 --- a/games/stella/stella.info +++ b/games/stella/stella.info @@ -1,8 +1,8 @@ PRGNAM="stella" -VERSION="5.1.3" +VERSION="6.0.2" HOMEPAGE="https://stella-emu.github.io/" -DOWNLOAD="https://github.com/stella-emu/stella/releases/download/5.1.3/stella-5.1.3-src.tar.xz" -MD5SUM="f7cccdf4761b7183a235ffeef136e180" +DOWNLOAD="https://github.com/stella-emu/stella/releases/download/6.0.2/stella-6.0.2-src.tar.xz" +MD5SUM="43f71246d9ab256687bce4ddc6e63965" DOWNLOAD_x86_64="" MD5SUM_x86_64="" REQUIRES="SDL2" diff --git a/games/stella/stella.pod b/games/stella/stella.pod deleted file mode 100644 index 908d33cc28..0000000000 --- a/games/stella/stella.pod +++ /dev/null @@ -1,1411 +0,0 @@ -# pod source for stella man page. Convert with: -# pod2man --stderr -s6 -cSlackBuilds.org -r5.0.2 -u stella.pod > stella.6 - -=pod - -=head1 NAME - -stella - an Atari 2600 emulator - -=head1 SYNOPSIS - -B I I - -=head1 DESCRIPTION - -B is a comprehensive emulator of the old Atari 2600 video-game -console. It support most Atari 2600 games and many peripherals. - -If you start Stella and do not specify a ROM image, it will start in -'ROM Launcher' mode. If this is your first time starting Stella, you -will be asked to select the default ROM directory to use. - -This man page only documents the command-line options and default -keybindings. The complete documentation is in I and -I, usually installed in I or -I. - -=head1 OPTIONS - -=over 4 - -=item B<-video> - -Use the given rendering backend (where applicable); default is the best -available mode detected. - -=item B<-vsync> <1|0> - -Synchronize screen updates to the vertical blank period. This can -result in smoother updates, and eliminate tearing. - -=item B<-fullscreen> <1|0> - -Enable fullscreen mode. - -=item B<-center> <1|0> - -Centers game window (if possible). - -=item B<-palette> - -Set the palette to either normal Stella, the one used in the z26 -emulator, or a user-defined palette. - -=item B<-colorloss> <1|0> - -Enable/disable the PAL color-loss effect. - -=item B<-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). - -=item B<-timing> - -Determines type of wait to perform between processing frames. Sleep -will release the CPU 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 CPU time, -but may eliminate graphical 'tearing' in software mode. - -=item B<-uimessages> <1|0> - -Enable or disable display of message in the UI. Note that messages -indicating serious errors override this setting, and are always shown. - -=item B<-sound> <1|0> - -Enable or disable sound generation. - -=item B<-fragsize> - -Specify the sound fragment size to use. Linux/Mac seems to work with -512, Windows usually needs 1024. - -=item B<-freq> - -Set sound sample output frequency (11025,22050,31400,44100,48000) -Default is 31400. Do not change unless you experience sound issues. - -=item B<-volume> - -Set the volume (0 - 100). - -=item B<-tia.zoom> - -Use the specified zoom level (integer) while in TIA/emulation mode. - -=item B<-tia.inter> <1|0> - -Use interpolation for the TIA image (results in blending/smoothing of -the image). - -=item B<-tia.aspectn> - -=item B<-tia.aspectp> - -Specify the amount (as a percentage) to scale the TIA image width in -NTSC and PAL 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 NTSC, and -105 - 110 for PAL. - -=item B<-tia.fsfill> <1|0> - -Stretch TIA image completely while in fullscreen mode (vs. an integral -stretch which won't necessarily completely fill the screen). - -=item B<-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. - -=item B<-tv.phosphor> - -When to use phosphor mode. - -=item B<-tv.phosblend> <0 - 100> - -Set default blend level in phosphor mode. - -=item B<-tv.filter> <1 - 6> - -Blargg TV effects, 0 is disabled, next numbers in sequence represent -presets for 'Composite', 'S-Video', 'RGB', 'Bad Adjust', and 'Custom' -modes. - -=item B<-tv.scanlines> <0 - 100> - -Blargg TV effects scanline intensity, where 0 means completely off. - -=item B<-tv.scaninter> <1|0> - -Blargg TV effects scanline interpolation, resulting in -blending/smoothing of the scanlines. - -=item B<-tv.jitter> <1|0> - -Enable TV jitter effect. - -=item B<-tv.jitter_recovery> <1 - 20> - -Set recovery time for TV jitter effect. - -=item B<-tv.contrast> - -Blargg TV effects 'contrast' (only available in custom mode, range -1.0 -to 1.0). - -=item B<-tv.brightness> - -Blargg TV effects 'brightness' (only available in custom mode, range --1.0 to 1.0). - -=item B<-tv.hue> - -Blargg TV effects 'hue' (only available in custom mode, range -1.0 to -1.0). - -=item B<-tv.saturation> - -Blargg TV effects 'saturation' (only available in custom mode, range --1.0 to 1.0). - -=item B<-tv.gamma> - -Blargg TV effects 'gamma' (only available in custom mode, range -1.0 to -1.0). - -=item B<-tv.sharpness> - -Blargg TV effects 'sharpness' (only available in custom mode, range --1.0 to 1.0). - -=item B<-tv.resolution> - -Blargg TV effects 'resolution' (only available in custom mode, range --1.0 to 1.0). - -=item B<-tv.artifacts> - -Blargg TV effects 'artifacts' (only available in custom mode, range --1.0 to 1.0). - -=item B<-tv.fringing> - -Blargg TV effects 'fringing' (only available in custom mode, range -1.0 -to 1.0). - -=item B<-tv.bleed> - -Blargg TV effects 'bleed' (only available in custom mode, range -1.0 to -1.0). - -=item B<-cheat> - -Use the specified cheatcode (see Cheat section for description). - -=item B<-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. - -=item B<-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'. - -=item B<-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. - -=item B<-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. - -=item B<-usemouse> - -Use mouse as a controller as specified by ROM properties in specific -case. Always and never are self-explanatory, analog means only for -analog-type devices (paddles, trackball, etc). - -=item B<-grabmouse> <1|0> - -Locks the mouse cursor in the game window in emulation mode. - -=item B<-cursor> <0,1,2,3> - -Set cursor state in UI/emulation modes. - -=item B<-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. - -=item B<-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. - -=item B<-tsense> - -Sensitivity of mouse emulated trackball movement (1-20). - -=item B<-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. - -=item B<-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. - -=item B<-autoslot> <1|0> - -Automatically switch to the next available save state slot after saving -a ROM state file. - -=item B<-stats> <1|0> - -Overlay console info on the TIA image during emulation. - -=item B<-fastscbios> <1|0> - -Disable Supercharger BIOS progress loading bars. - -=item B<-snapsavedir> - -The directory to save snapshot files to. - -=item B<-snaploaddir> - -The directory to load snapshot files from. - -=item B<-snapname> - -When saving snapshots, use either the internal database name or the -actual ROM filename. - -=item B<-sssingle> <1|0> - -Generate single snapshot instead of many, overwriting any previous -snapshots. - -=item B<-ss1x> <1|0> - -Ignore any scaling applied to the TIA image, and save snapshot in -unscaled (1x) mode. - -=item B<-ssinterval> - -Set the interval in seconds between taking snapshots in continuous -snapshot mode (currently, 1 - 10). - -=item B<-rominfo> - -Display detailed information about the given ROM, and then exit Stella. - -=item B<-listrominfo> - -Prints relevant contents of the Stella ROM database, one ROM per line, -and then exit Stella. This can be used for external frontends. - -=item B<-exitlauncher> <1|0> - -Always exit to ROM launcher when exiting a ROM (normally, an exit to -launcher only happens when started with the launcher). - -=item B<-launcherres> - -Set the size of the ROM launcher. - -=item B<-launcherfont> - -Set the size of the font in the ROM launcher. - -=item B<-launcherexts> - -Specifies which files to show in the ROM launcher ('allfiles' is -self-explanatory, 'allroms' is all files with valid rom extensions -(currently: a26, bin, rom, gz, zip), 'LIST' is a ':' separated list of -valid rom extensions. - -=item B<-romviewer> <0|1|2> - -Hide ROM info viewer in ROM launcher mode (0), or use the given zoom -level (1 or 2). - -=item B<-uipalette> - -Use the specified palette for UI elements. B is green-on-black, -B is more colorful. - -=item B<-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, - -=item B<-mwheel> - -Set the number of lines a mousewheel will scroll in the UI. - -=item B<-romdir> - -Set the directory where the ROM launcher will start. - -=item B<-statedir> - -Set the directory in which to access state files. - -=item B<-cheatfile> - -Set the full pathname of the cheatfile database. - -=item B<-palettefile> - -Set the full pathname of the user-defined palette file. - -=item B<-propsfile> - -Set the full pathname of the ROM properties file. - -=item B<-nvramdir> - -Set the directory in which to access non-volatile (flash/EEPROM) files. - -=item B<-cfgdir> - -Set the directory in which to access Distella config files. - -=item B<-avoxport> - -Set the name of the serial port where an AtariVox is connected. - -=item B<-maxres> - -Useful for developers, this sets the maximum size of window that can be -created, allowing to simulate testing on 'smaller' systems. - -=item B<-help> - -Prints a help message describing these options, and then exit Stella. - -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. - -Argument Description - -=item B<-dis.resolve> <1|0> - -Try to differentiate between code vs. data sections in the -disassembler. See the Debugger section for more information. - -=item B<-dis.gfxformat> <2|16> - -Sets the base to use for displaying GFX sections in the disassembler. - -=item B<-dis.showaddr> <1|0> - -Shows/hides opcode addresses in the disassembler. - -=item B<-dis.relocate> <1|0> - -Relocate calls out of address range in the disassembler. - -=item B<-dbg.res> - -Set the size of the debugger window. - -=item B<-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. - -=item B<-break>
- -Set a breakpoint at specified address. - -=item B<-debug> - -Immediately jump to debugger mode when starting Stella. - -=item B<-holdjoy0> - -Start the emulator with the left joystick direction/button held down -(ie, use 'UF' for up and fire). - -=item B<-holdjoy1> - -Start the emulator with the right joystick direction/button held down -(ie, use 'UF' for up and fire). - -=item B<-holdselect> - -Start the emulator with the Game Select switch held down. - -=item B<-holdreset> - -Start the emulator with the Game Reset switch held down. - -=item B<-tiadriven> <1|0> - -Set unused TIA pins to be randomly driven high or low on a read/peek. -If disabled, use the last databus value for those pins instead. - -=item B<-cpurandom> - -On reset, randomize the content of the specified CPU registers. - -=item B<-ramrandom> <1|0> - -On reset, either randomize all RAM content, or zero it out instead. - -=item B<-bs> - -Set "Cartridge.Type" property. See the Game Properties section for -valid types. - -=item B<-type> - -Same as using -bs. - -=item B<-channels> - -Set "Cartridge.Sound" property. - -=item B<-ld> - -Set "Console.LeftDifficulty" property. - -=item B<-rd> - -Set "Console.RightDifficulty" property. - -=item B<-tv> - -Set "Console.TelevisionType" property. - -=item B<-sp> - -Set "Console.SwapPorts" property. - -=item B<-lc> - -Set "Controller.Left" property. See the Game Properties section for -valid types. - -=item B<-rc> - -Set "Controller.Right" property. See the Game Properties section for -valid types. - -=item B<-bc> - -Sets both "Controller.Left" and "Controller.Right" properties. See the -Game Properties section for valid types. - -=item B<-cp> - -Set "Controller.SwapPaddles" property. - -=item B<-ma> - -Set "Controller.MouseAxis" property. See the Game Properties section -for valid types. - -=item B<-format> - -Set "Display.Format" property. See the Game Properties section for -valid formats. - -=item B<-ystart> - -Set "Display.YStart" property (0 - 64). - -=item B<-height> - -Set "Display.Height" property (210 - 256). - -=item B<-pp> - -Set "Display.Phosphor" property. - -=item B<-ppblend> - -Set "Display.PPBlend" property, used for phosphor effect (0-100). -Default is 77. - -=item B<-thumb.trapfatal> <1|0> - -The default of true allows the Thumb ARM 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 ARM emulation -only applies to the BUS, CDF, and DPC+ cartridge types. - -=back - -=head1 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 B in -the HTML documentation). The tables below show the default settings. - -=head2 Console Controls (can be remapped) - -=over 4 - -=item B - -Exit emulator - -=item B - -Exit game mode/enter launcher mode - -=item B - -Enter/exit options mode - -=item B - -Enter/exit command mode - -=item B - -Enter/exit debugger - -=item B - -Select Game - -=item B - -Reset Game - -=item B - -Color TV - -=item B - -Black/White TV - -=item B - -Left Player Difficulty A - -=item B - -Left Player Difficulty B - -=item B - -Right Player Difficulty A - -=item B - -Right Player Difficulty B - -=item B - -Save state to current slot - -=item B - -Change current state slot - -=item B - -Load state from current slot - -=item B - -Save PNG snapshot - -=item B - -Pause/resume emulation - -=back - -=head2 Joystick / BoosterGrip Controller (can be remapped) - -=head3 Left Joystick (Joy0) - -=over 4 - -=item B - -Joystick Up - -=item B - -Joystick Down - -=item B - -Joystick Left - -=item B - -Joystick Right - -=item B - -Fire Button - -=item B<4> - -Trigger Button - -=item B<5> - -Booster Button - -=back - -=head3 Right Joystick (Joy1) - -=over 4 - -=item B - -Joystick Up - -=item B - -Joystick Down - -=item B - -Joystick Left - -=item B - -Joystick Right - -=item B - -Fire Button - -=item B<6> - -Trigger Button - -=item B<7> - -Booster Button - -=back - -=head2 Paddle Controller digital emulation (can be remapped independently of joystick controller) - -=head3 Left Paddles - -=over 4 - -=item B - -Paddle 0 decrease - -=item B - -Paddle 0 increase - -=item B - -Paddle 0 Fire - -=item B - -Paddle 1 decrease - -=item B - -Paddle 1 increase - -=item B - -Paddle 1 Fire - -=back - -=head3 Right Paddles - -=over 4 - -=item B - -Paddle 2 decrease - -=item B - -Paddle 2 increase - -=item B - -Paddle 2 Fire - -=item B - -Paddle 3 decrease - -=item B - -Paddle 3 increase - -=item B - -Paddle 3 Fire - -=back - -=head2 Driving Controller (cannot be remapped, always associated with joystick controller) - -=head3 Left Driving - -=over 4 - -=item B - -Left Direction - -=item B - -Right Direction - -=item B - -Fire Button - -=back - -=head3 Right Driving - -=over 4 - -=item B - -Left Direction - -=item B - -Right Direction - -=item B - -Fire Button - -=back - -=head2 Sega Genesis Controller (cannot be remapped, always associated with joystick and booster-grip controllers) - -=head3 Left Pad - -=over 4 - -=item B - -Pad Up - -=item B - -Pad Down - -=item B - -Pad Left - -=item B - -Pad Right - -=item B - -Button 'B' - -=item B - -Button 'C' - -=back - -=head3 Right Pad - -=over 4 - -=item B - -Pad Up - -=item B - -Pad Down - -=item B - -Pad Left - -=item B - -Pad Right - -=item B - -Button 'B' - -=item B - -Button 'C' - -=back - -=head2 Keypad Controller (can be remapped) - -=head3 Left Keypad - -=over 4 - -=item B<1> - -1 - -=item B<2> - -2 - -=item B<3> - -3 - -=item B - -4 - -=item B - -5 - -=item B - -6 - -=item B - -7 - -=item B - -8 - -=item B - -9 - -=item B - -. - -=item B - -0 - -=item B - -# - -=back - -=head3 Right Keypad - -=over 4 - -=item B<8> - -1 - -=item B<9> - -2 - -=item B<0> - -3 - -=item B - -4 - -=item B - -5 - -=item B

- -6 - -=item B - -7 - -=item B - -8 - -=item B<;> - -9 - -=item B<,> - -. - -=item B<.> - -0 - -=item B - -# - -=back - -=head2 CompuMate Controller (cannot be remapped) - -=over 4 - -=item B< 0 - 9> - -0 - 9 - -=item B< A - Z> - -A - Z - -=item B< Comma> - -Comma - -=item B< Period> - -Period - -=item B< Control (left or right)> - -Func - -=item B< Shift (left or right)> - -Shift - -=item B< Return/Enter> - -Enter - -=item B< Space> - -Space - -=item B< Backspace> - -Func-Space - -=item B< + or Shift-1> - -+ - -=item B< - or Shift-2> - -- - -=item B< Shift-3> - -* - -=item B< / or Shift-4> - -/ - -=item B< = or Shift-5> - -= - -=item B< ? (Shift-/) or Shift-6> - -? - -=item B< Shift-7> - -$ - -=item B< [ or Shift-8> - -[ - -=item B< ] or Shift-9> - -] - -=item B< " (Shift-') or Shift-0> - -" - -=back - -=head2 TV effects (cannot be remapped, only active in TIA mode) - -=over 4 - -=item B - -Disable TV effects - -=item B - -Select 'Composite' preset - -=item B - -Select 'S-video' preset - -=item B - -Select 'RGB' preset - -=item B - -Select 'Badly adjusted' preset - -=item B - -Select 'Custom' preset - -=item B - -Decrease scanline intensity - -=item B - -Increase scanline intensity - -=item B - -Disable scanline interpolation - -=item B - -Enable scanline interpolation - -=item B - -Select previous 'Custom' mode attribute (*) - -=item B - -Select next 'Custom' mode attribute (*) - -=item B - -Decrease 'Custom' selected attribute value (*) - -=item B - -Increase 'Custom' selected attribute value (*) - -=back - -Items marked as (*) are only available in 'Custom' preset mode - -=head2 Developer Keys in TIA mode (cannot be remapped) - -=over - -=item B - -Set "Display.YStart" to next larger value - -=item B - -Set "Display.YStart" to next smaller value - -=item B - -Set "Display.Height" to next larger value - -=item B - -Set "Display.Height" to next smaller value - -=item B - -Toggle frame stats (scanline count/fps/bs type/etc) - -=item B - -Toggle TIA Player0 object - -=item B - -Toggle TIA Player1 object - -=item B - -Toggle TIA Missile0 object - -=item B - -Toggle TIA Missile1 object - -=item B - -Toggle TIA Ball object - -=item B - -Toggle TIA Playfield object - -=item B - -Toggle TIA Player0 collisions - -=item B - -Toggle TIA Player1 collisions - -=item B - -Toggle TIA Missile0 collisions - -=item B - -Toggle TIA Missile1 collisions - -=item B - -Toggle TIA Ball collisions - -=item B - -Toggle TIA Playfield collisions - -=item B - -Toggle TIA HMOVE blanks - -=item B - -Toggle TIA 'Fixed Debug Colors' mode - -=item B - -Toggle all TIA objects - -=item B - -Toggle all TIA collisions - -=back - -=head2 Other Keys (cannot be remapped, except those marked with '*') - -=over 4 - -=item B - -Switch to next larger zoom level - -=item B - -Switch to next smaller zoom level - -=item B - -Toggle fullscreen/windowed mode - -=item B - -Decrease volume (*) - -=item B - -Increase volume (*) - -=item B - -Toggle console type in increasing order (NTSC/PAL/SECAM, etc)) - -=item B - -Toggle console type in decreasing order (NTSC/PAL/SECAM, etc)) - -=item B - -Save current properties to a new properties file - -=item B - -Switch mouse between controller emulation modes - -=item B - -Swap Stelladaptor/2600-daptor port ordering - -=item B - -Reload current ROM (singlecart ROM, TIA mode) or Load next game in ROM (multicart ROM, TIA mode) - -=item B - -Reload ROM listing (ROM launcher mode) - -=item B - -Emulate 'frying' effect (TIA mode) (*), Go to parent directory (UI mode) (*) -=item B - -Toggle 'phosphor' effect - -=item B - -Toggle palette - -=item B - -Toggle PAL color-loss effect - -=item B - -Save continuous PNG snapshots (per interval) - -=item B - -Save continuous PNG snapshots (every frame) - -=back - -=head2 UI keys in Text Editing areas (cannot be remapped) - -=over 4 - -=item B - -Move cursor to beginning of line - -=item B - -Move cursor to end of line - -=item B - -Remove character to right of cursor - -=item B - -Remove character to left of cursor - -=item B - -Same function as 'Home' - -=item B - -Same function as 'End' - -=item B - -Same function as 'Delete' - -=item B - -Remove all characters from cursor to end of line - -=item B - -Remove all characters from cursor to beginning of line - -=item B - -Remove entire word to left of cursor - -=item B - -Move cursor to beginning of word to the left - -=item B - -Move cursor to beginning of word to the right - -=item B - -Copy entire line to clipboard (not complete) - -=item B - -Paste clipboard contents (not complete) - -=back - -=head1 FILES - -Starting with 5.0, B uses B<$HOME/.config/stella/> as -the per-user config directory. Previous versions used B<$HOME/.stella/>. - -The config directory contains the following: - -=over 4 - -=item B - -The Stella config file, created by B. May be hand-edited, but -normally the built-in GUI is used to set these options. - -=item B - -Directory for DiStella config files, used only by the debugger. - -=item B - -Directory used to store the contents of non-volatile cartridge memory. - -=item B - -Directory used to store save-states (see B key). - -=back - -=head1 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 -. - -=head1 SEE ALSO - -Stella web site: I.