mirror of https://github.com/stella-emu/stella.git
formatting aligned and numbering removed
This commit is contained in:
parent
b35a9ef946
commit
ded2c71bdd
|
@ -12,7 +12,7 @@
|
|||
<br>
|
||||
|
||||
<h2>Contents</h2>
|
||||
<ol>
|
||||
<ul>
|
||||
<li><a href="#Features">Features</a></li>
|
||||
<li><a href="#HowToDebugger">How to use the Debugger</a>
|
||||
<ul>
|
||||
|
@ -68,8 +68,7 @@
|
|||
<li><a href="#DistellaConfiguration">Distella Configuration Files</a></li>
|
||||
<li><a href="#Howtohack">Tutorial: How to hack a ROM</a></li>
|
||||
</li>
|
||||
</ol>
|
||||
|
||||
</ul>
|
||||
<br>
|
||||
|
||||
<h1><a name="Features">Features</a></h1>
|
||||
|
@ -240,8 +239,9 @@ execution by stepping one instruction, scanline, or frame at a time
|
|||
(or more than one at a time, using commands in the prompt). You can
|
||||
also set breakpoints or traps, which will cause the emulator to enter
|
||||
the debugger when they are triggered, even if it happens in mid-frame.</p>
|
||||
</br>
|
||||
|
||||
<h3><a name="Startup">Startup</a></h3>
|
||||
<h2><a name="Startup">Startup</a></h2>
|
||||
At startup, the debugger automatically tries load a number of files which
|
||||
will provide additional information for the debugger and can make debugging
|
||||
more convenient.
|
||||
|
@ -254,7 +254,7 @@ more convenient.
|
|||
|
||||
<p>The location of this file will depend on the OS as follows:</p>
|
||||
<p>
|
||||
<table cellpadding="3" border="1">
|
||||
<table cellpadding=4 border="1">
|
||||
<tr>
|
||||
<td><b>Linux/Unix</b></td>
|
||||
<td><i>~/.stella/autoexec.script</i></td>
|
||||
|
@ -324,7 +324,7 @@ previous rewind operation. The rewind buffer is 100 levels deep by default.<p>
|
|||
|
||||
<p>You can also use the buttons from anywhere in the GUI via hotkeys.</p>
|
||||
<p>
|
||||
<table BORDER=1 cellpadding=3>
|
||||
<table BORDER=1 cellpadding=4>
|
||||
<tr>
|
||||
<th>Key</th>
|
||||
<th>Function</th>
|
||||
|
@ -391,7 +391,7 @@ or Supermon for the C=64.</p>
|
|||
<p>Editing keys work about like you'd expect them to in Windows, but many
|
||||
Bash-style commands are also supported:</p>
|
||||
|
||||
<table border="1" cellpadding="3">
|
||||
<table border="1" cellpadding=4>
|
||||
<tr><th>Key</th><th>Function</th></tr>
|
||||
<tr><td>Home</td><td>Move cursor to beginning of line</td></tr>
|
||||
<tr><td>End</td><td>Move cursor to end of line</td></tr>
|
||||
|
@ -684,7 +684,7 @@ conditions without having to define the conditions yourself.</p>
|
|||
your game's source with underscores, if you plan to use them with the
|
||||
Stella debugger.</p>
|
||||
|
||||
<table border="1" cellpadding="3">
|
||||
<table border="1" cellpadding=4>
|
||||
<tr><th>Function</th><th>Definition</th><th>Description</th></tr>
|
||||
<tr><td> _joy0left</td><td> !(*SWCHA & $40)</td><td> Left joystick moved left</td></tr>
|
||||
<tr><td> _joy0right</td><td> !(*SWCHA & $80)</td><td> Left joystick moved right</td></tr>
|
||||
|
@ -716,7 +716,7 @@ They're not registers in the conventional sense, since they don't exist in
|
|||
a real system. For example, while the debugger keeps track of the number
|
||||
of scanlines in a frame, a real system would not (there is no register
|
||||
that holds 'number of scanlines' on an actual console).</p>
|
||||
<table border="1" cellpadding="3">
|
||||
<table border="1" cellpadding=4>
|
||||
<tr><th>Function</th><th>Description</th></tr>
|
||||
<tr><td> _bank</td><td> Currently selected bank</td></tr>
|
||||
<tr><td> _cclocks</td><td> Color clocks on a scanline</td></tr>
|
||||
|
@ -1186,7 +1186,7 @@ depending on which of these widgets is currently in focus.
|
|||
<p>Each of these buttons also have a keyboard shortcut (indicated in square
|
||||
brackets). In fact, many of the inputboxes in various parts of the debugger
|
||||
respond to these same keyboard shortcuts. If in doubt, give them a try.</p>
|
||||
<table border="1" cellpadding="3">
|
||||
<table border="1" cellpadding=4>
|
||||
<tr>
|
||||
<th>Button</th><th>Shortut</th><th>Description</th>
|
||||
</tr>
|
||||
|
@ -1322,7 +1322,7 @@ Note that only code, graphics or data will show bytes and can be edited.</li>
|
|||
can use. These are known as 'directives', and partly correspond to configuration
|
||||
options from the standalone Distella program. They are listed in order of
|
||||
decreasing hierarchy:</p>
|
||||
<table border="1" cellpadding="3">
|
||||
<table border="1" cellpadding=4>
|
||||
<tr><td><b>CODE</b></td><td>Addresses which have appeared in the program counter, or
|
||||
which tentatively can appear in the program counter. These can be edited in hex.</td></tr>
|
||||
<tr><td><b>GFX</b></td><td>Addresses which contain data stored in the player graphics registers
|
||||
|
@ -1496,7 +1496,7 @@ named "rr.a26", with properties entry "River Raid". Attempts will be made as fol
|
|||
</ul>
|
||||
<p>The location of 'configdir' will depend on the OS as follows:</p>
|
||||
|
||||
<p><table cellpadding="3" border="1">
|
||||
<p><table cellpadding=4 border="1">
|
||||
<tr>
|
||||
<td><b>Linux/Unix</b></td>
|
||||
<td><i>~/.stella/cfg/</i></td>
|
||||
|
|
|
@ -17,7 +17,7 @@
|
|||
<br>
|
||||
|
||||
<h2>Contents</h2>
|
||||
<ol>
|
||||
<ul>
|
||||
<li><a href="#History">A Brief History of the Atari 2600</a></li>
|
||||
<li><a href="#Introduction">Introduction</a><br>
|
||||
<ul><li><a href="#Features">Features</a></li></ul>
|
||||
|
@ -51,7 +51,7 @@
|
|||
</li>
|
||||
<li><a href="#Acknowledgments">Acknowledgments</a></li>
|
||||
<li><a href="#License">License and Disclaimer</a></li>
|
||||
</ol>
|
||||
</ul>
|
||||
|
||||
<br><br><br>
|
||||
|
||||
|
@ -59,7 +59,7 @@
|
|||
<center><b>The Stella Team</b></center>
|
||||
<center><b><a href="https://stella-emu.github.io">Stella Homepage</a></b></center>
|
||||
|
||||
<br><br><br>
|
||||
<br>
|
||||
|
||||
<!-- ///////////////////////////////////////////////////////////////////////// -->
|
||||
<br><br>
|
||||
|
@ -311,7 +311,7 @@
|
|||
<a name="QuickStart">Getting Started</a></h1>
|
||||
<hr>
|
||||
|
||||
<h2><b><a name="Requirements">1. Requirements</a></b></h2>
|
||||
<h2><b><a name="Requirements">Requirements</a></b></h2>
|
||||
|
||||
<blockquote>
|
||||
<p>The following sections outline the basic system requirements for running
|
||||
|
@ -378,7 +378,7 @@
|
|||
</blockquote>
|
||||
|
||||
|
||||
<h2><b><a name="Installation">2. Installation</a></b></h2>
|
||||
<h2><b><a name="Installation">Installation</a></b></h2>
|
||||
|
||||
<blockquote>
|
||||
<p>Stella is distributed in both source and binary form. In general, you should always
|
||||
|
@ -453,7 +453,7 @@
|
|||
</ul>
|
||||
</blockquote>
|
||||
|
||||
<h2><b><a name="Games">3. Locating Game Images (aka, ROMs)</a></b></h2>
|
||||
<h2><b><a name="Games">Locating Game Images (aka, ROMs)</a></b></h2>
|
||||
|
||||
<blockquote>
|
||||
<p>
|
||||
|
@ -526,7 +526,7 @@
|
|||
it (ie, the first one ending in a valid extension).</p>
|
||||
</blockquote>
|
||||
|
||||
<h2><b><a name="Playing">4. Playing a Game</a></b></h2>
|
||||
<h2><b><a name="Playing">Playing a Game</a></b></h2>
|
||||
|
||||
<blockquote>
|
||||
<p>Once Stella is installed and you have some ROM images you're almost ready to
|
||||
|
@ -595,7 +595,7 @@
|
|||
in a standalone gaming system).</p>
|
||||
</blockquote>
|
||||
|
||||
<h2><b><a name="Keyboard">5. Keyboard Layout</a></b></h2>
|
||||
<h2><b><a name="Keyboard">Keyboard Layout</a></b></h2>
|
||||
<blockquote>
|
||||
|
||||
<p>The Atari 2600 console controls and controllers are mapped to the computer's
|
||||
|
@ -613,7 +613,7 @@
|
|||
|
||||
<p><b>Console Controls (can be remapped)</b></p>
|
||||
|
||||
<table BORDER=2 cellpadding=5>
|
||||
<table BORDER=2 cellpadding=4>
|
||||
<tr>
|
||||
<th>Function</th>
|
||||
<th>Key (Standard)</th>
|
||||
|
@ -740,7 +740,7 @@
|
|||
|
||||
<tr>
|
||||
<td>
|
||||
<table BORDER=1 cellpadding=5>
|
||||
<table BORDER=1 cellpadding=4>
|
||||
<tr>
|
||||
<th>Function</th>
|
||||
<th>Key</th>
|
||||
|
@ -784,7 +784,7 @@
|
|||
</td>
|
||||
|
||||
<td>
|
||||
<table BORDER=1 cellpadding=5>
|
||||
<table BORDER=1 cellpadding=4>
|
||||
<tr>
|
||||
<th>Function</th>
|
||||
<th>Key</th>
|
||||
|
@ -839,7 +839,7 @@
|
|||
|
||||
<tr>
|
||||
<td>
|
||||
<table BORDER=1 cellpadding=5>
|
||||
<table BORDER=1 cellpadding=4>
|
||||
<tr>
|
||||
<th>Function</th>
|
||||
<th>Key</th>
|
||||
|
@ -878,7 +878,7 @@
|
|||
</td>
|
||||
|
||||
<td>
|
||||
<table BORDER=1 cellpadding=5>
|
||||
<table BORDER=1 cellpadding=4>
|
||||
<tr>
|
||||
<th>Function</th>
|
||||
<th>Key</th>
|
||||
|
@ -928,7 +928,7 @@
|
|||
|
||||
<tr>
|
||||
<td>
|
||||
<table BORDER=1 cellpadding=5>
|
||||
<table BORDER=1 cellpadding=4>
|
||||
<tr>
|
||||
<th>Function</th>
|
||||
<th>Key</th>
|
||||
|
@ -952,7 +952,7 @@
|
|||
</td>
|
||||
|
||||
<td>
|
||||
<table BORDER=1 cellpadding=5>
|
||||
<table BORDER=1 cellpadding=4>
|
||||
<tr>
|
||||
<th>Function</th>
|
||||
<th>Key</th>
|
||||
|
@ -987,7 +987,7 @@
|
|||
|
||||
<tr>
|
||||
<td>
|
||||
<table BORDER=1 cellpadding=5>
|
||||
<table BORDER=1 cellpadding=4>
|
||||
<tr>
|
||||
<th>Function</th>
|
||||
<th>Key</th>
|
||||
|
@ -1026,7 +1026,7 @@
|
|||
</td>
|
||||
|
||||
<td>
|
||||
<table BORDER=1 cellpadding=5>
|
||||
<table BORDER=1 cellpadding=4>
|
||||
<tr>
|
||||
<th>Function</th>
|
||||
<th>Key</th>
|
||||
|
@ -1076,7 +1076,7 @@
|
|||
|
||||
<tr>
|
||||
<td>
|
||||
<table BORDER=1 cellpadding=5>
|
||||
<table BORDER=1 cellpadding=4>
|
||||
<tr>
|
||||
<th>Pad Button</th>
|
||||
<th>Key</th>
|
||||
|
@ -1145,7 +1145,7 @@
|
|||
</td>
|
||||
|
||||
<td>
|
||||
<table BORDER=1 cellpadding=5>
|
||||
<table BORDER=1 cellpadding=4>
|
||||
<tr>
|
||||
<th>Pad Button</th>
|
||||
<th>Key</th>
|
||||
|
@ -1217,7 +1217,7 @@
|
|||
|
||||
<p><b>CompuMate Controller (cannot be remapped)</b></p>
|
||||
|
||||
<table BORDER=2 cellpadding=5>
|
||||
<table BORDER=2 cellpadding=4>
|
||||
<tr><th>CompuMate</th> <th>Key</th></tr>
|
||||
<tr><td>0 - 9 </td><td>0 - 9 </td></tr>
|
||||
<tr><td>A - Z </td><td>A - Z </td></tr>
|
||||
|
@ -1243,7 +1243,7 @@
|
|||
|
||||
<p><b>TV effects (cannot be remapped, only active in TIA mode)</b></p>
|
||||
|
||||
<table BORDER=2 cellpadding=5>
|
||||
<table BORDER=2 cellpadding=4>
|
||||
<tr>
|
||||
<th>Function</th>
|
||||
<th>Key (Standard)</th>
|
||||
|
@ -1328,7 +1328,7 @@
|
|||
<a name="DeveloperKeys"></a>
|
||||
<p><b>Developer Keys in TIA mode (cannot be remapped)</b></p>
|
||||
|
||||
<table BORDER=2 cellpadding=5>
|
||||
<table BORDER=2 cellpadding=4>
|
||||
<tr>
|
||||
<th>Function</th>
|
||||
<th>Key (Standard)</th>
|
||||
|
@ -1464,7 +1464,7 @@
|
|||
|
||||
<p><b>Other Keys (cannot be remapped, except those marked with '*')</b></p>
|
||||
|
||||
<table BORDER=2 cellpadding=5>
|
||||
<table BORDER=2 cellpadding=4>
|
||||
<tr>
|
||||
<th>Function</th>
|
||||
<th>Key (Standard)</th>
|
||||
|
@ -1624,7 +1624,7 @@
|
|||
|
||||
<p><b>UI keys in Text Editing areas (cannot be remapped)</b></p>
|
||||
|
||||
<table BORDER=2 cellpadding=5>
|
||||
<table BORDER=2 cellpadding=4>
|
||||
<tr><th>Key</th><th>Editor Function</th></tr>
|
||||
<tr><td>Home</td><td>Move cursor to beginning of line</td></tr>
|
||||
<tr><td>End</td><td>Move cursor to end of line</td></tr>
|
||||
|
@ -1643,7 +1643,7 @@
|
|||
</table>
|
||||
</blockquote>
|
||||
|
||||
<h2><b><a name="ControlMap">6. Controller Map</a></b></h2>
|
||||
<h2><b><a name="ControlMap">Controller Map</a></b></h2>
|
||||
<blockquote>
|
||||
|
||||
<p>Some Atari (virtual) controllers are simulated with more than one computer controller, and
|
||||
|
@ -1652,7 +1652,7 @@
|
|||
enough buttons/axes/etc. to fully emulate the device, so extra functionality must be mapped to other
|
||||
controllers.</p>
|
||||
|
||||
<table BORDER=2 cellpadding=5>
|
||||
<table BORDER=2 cellpadding=4>
|
||||
<tr>
|
||||
<th> </th>
|
||||
<th colspan="5">Computer</th>
|
||||
|
@ -1769,7 +1769,7 @@
|
|||
there's likely a configuration option to do so. The remainder of this (lengthy)
|
||||
section details every configurable option.</p>
|
||||
|
||||
<h2><b><a name="CommandLine">1. Using the Command Line</a></b></h2>
|
||||
<h2><b><a name="CommandLine">Using the Command Line</a></b></h2>
|
||||
<blockquote>
|
||||
|
||||
<p>In addition to the built in ROM launcher, Stella can also be used from the
|
||||
|
@ -2495,7 +2495,7 @@
|
|||
</table>
|
||||
</blockquote>
|
||||
|
||||
<h2><b><a name="Options">2. Changing Options</a></b></h2>
|
||||
<h2><b><a name="Options">Changing Options</a></b></h2>
|
||||
<blockquote>
|
||||
|
||||
<p>All settings can be changed within the integrated Options UI while Stella is
|
||||
|
@ -2686,7 +2686,7 @@
|
|||
</table>
|
||||
</blockquote>
|
||||
|
||||
<h2><b><a name="Remapping">3. Event Remapping / Input Devices</a></b></h2>
|
||||
<h2><b><a name="Remapping">Event Remapping / Input Devices</a></b></h2>
|
||||
<blockquote>
|
||||
|
||||
<p>Almost every event in Stella can be remapped to another key on the keyboard or
|
||||
|
@ -2759,7 +2759,7 @@
|
|||
</table>
|
||||
</blockquote>
|
||||
|
||||
<h2><b><a name="ROMInfo">4. ROM Launcher</a></b></h2>
|
||||
<h2><b><a name="ROMInfo">ROM Launcher</a></b></h2>
|
||||
<blockquote>
|
||||
|
||||
<p>Several options are configurable in the ROM launcher. The size of the
|
||||
|
@ -2867,7 +2867,7 @@
|
|||
</ol></p>
|
||||
</blockquote>
|
||||
|
||||
<h2><b><a name="ROMAudit">5. ROM Audit Mode</a></b></h2>
|
||||
<h2><b><a name="ROMAudit">ROM Audit Mode</a></b></h2>
|
||||
<blockquote>
|
||||
|
||||
<p>Stella has the ability to rename all your ROMs according to the name
|
||||
|
@ -2900,7 +2900,7 @@
|
|||
</ul>
|
||||
</blockquote>
|
||||
|
||||
<h2><b><a name="Adaptor">6. Stelladaptor/2600-daptor Support</a></b></h2>
|
||||
<h2><b><a name="Adaptor">Stelladaptor/2600-daptor Support</a></b></h2>
|
||||
<blockquote>
|
||||
|
||||
<p>Stella supports real Atari 2600 joysticks, paddles and driving controllers
|
||||
|
@ -2933,7 +2933,7 @@
|
|||
</ul>
|
||||
</blockquote>
|
||||
|
||||
<h2><b><a name="AtariVox">7. AtariVox/SaveKey Support</a></b></h2>
|
||||
<h2><b><a name="AtariVox">AtariVox/SaveKey Support</a></b></h2>
|
||||
<blockquote>
|
||||
|
||||
<p>Stella supports a real AtariVox device for the speech/SpeakJet portion
|
||||
|
@ -2964,7 +2964,7 @@
|
|||
If the path for these files hasn't been set, the default location will depend on the
|
||||
version of Stella, as follows:</p>
|
||||
|
||||
<p><table cellpadding="5" border="1">
|
||||
<p><table cellpadding="4" border="1">
|
||||
<tr>
|
||||
<td><b>Linux/Unix</b></td>
|
||||
<td><i>~/.stella/nvram/atarivox_eeprom.dat<br>
|
||||
|
@ -2995,7 +2995,7 @@
|
|||
reset the EEPROM to a clean state.</p>
|
||||
</blockquote>
|
||||
|
||||
<h2><b><a name="Debugger">8. Developer Options/Integrated Debugger</a></b></h2>
|
||||
<h2><b><a name="Debugger">Developer Options/Integrated Debugger</a></b></h2>
|
||||
<blockquote>
|
||||
|
||||
<p>Several developer related settings can be configured in the 'Developer Settings' dialog.
|
||||
|
@ -3162,7 +3162,7 @@
|
|||
<a href="debugger.html">this page</a> for integrated debugger documentation.</p>
|
||||
</blockquote>
|
||||
|
||||
<h2><b><a name="Settings">9. Settings File</a></b></h2>
|
||||
<h2><b><a name="Settings">Settings File</a></b></h2>
|
||||
<blockquote>
|
||||
|
||||
<p>Stella will remember when you change a setting either at the command line
|
||||
|
@ -3206,7 +3206,7 @@
|
|||
<p>The settings file has a special name/location depending on which version of Stella
|
||||
you use, which is currently not configurable:</p>
|
||||
|
||||
<p><table cellpadding="5" border="1">
|
||||
<p><table cellpadding="4" border="1">
|
||||
<tr>
|
||||
<td><b>Linux/Unix</b></td>
|
||||
<td><i>$HOME/.config/stella/stellarc</i></td>
|
||||
|
@ -3227,7 +3227,7 @@
|
|||
</table>
|
||||
</blockquote>
|
||||
|
||||
<h2><b><a name="Cheats">10. Cheatcode Manager</a></b></h2>
|
||||
<h2><b><a name="Cheats">Cheatcode Manager</a></b></h2>
|
||||
<blockquote>
|
||||
|
||||
<p>Stella contains support for Bob Colbert's Cheetah cheat codes, as
|
||||
|
@ -3305,7 +3305,7 @@ Ms Pac-Man (Stella extended codes):
|
|||
path for this file hasn't been set, the default filename will depend on the
|
||||
version of Stella, as follows:</p>
|
||||
|
||||
<p><table cellpadding="5" border="1">
|
||||
<p><table cellpadding="4" border="1">
|
||||
<tr>
|
||||
<td><b>Linux/Unix</b></td>
|
||||
<td><i>$HOME/.config/stella/stella.cht</i></td>
|
||||
|
@ -3327,7 +3327,7 @@ Ms Pac-Man (Stella extended codes):
|
|||
<p>Stella will require a restart for changes to this file to take effect.</p>
|
||||
</blockquote>
|
||||
|
||||
<h2><b><a name="Logs">11. Viewing the System Log</a></b></h2>
|
||||
<h2><b><a name="Logs">Viewing the System Log</a></b></h2>
|
||||
<blockquote>
|
||||
|
||||
<p>Stella maintains a log of its operations when the program first starts up, and
|
||||
|
@ -3358,7 +3358,7 @@ Ms Pac-Man (Stella extended codes):
|
|||
home directory by clicking the "Save log to disk" button.</p>
|
||||
</blockquote>
|
||||
|
||||
<h2><b><a name="Properties">12. Game Properties</a></b></h2>
|
||||
<h2><b><a name="Properties">Game Properties</a></b></h2>
|
||||
<blockquote>
|
||||
|
||||
<p>Stella uses game properties to specify the "best" emulator settings for a
|
||||
|
@ -3658,7 +3658,7 @@ Ms Pac-Man (Stella extended codes):
|
|||
path for this file hasn't been set, the default filename will depend on the
|
||||
version of Stella, as follows:</p>
|
||||
|
||||
<p><table cellpadding="5" border="1">
|
||||
<p><table cellpadding="4" border="1">
|
||||
<tr>
|
||||
<td><b>Linux/Unix</b></td>
|
||||
<td><i>$HOME/.config/stella/stella.pro</i></td>
|
||||
|
@ -3681,14 +3681,14 @@ Ms Pac-Man (Stella extended codes):
|
|||
<p>Stella will require a restart for changes to this file to take effect.</p>
|
||||
</blockquote>
|
||||
|
||||
<h2><b><a name="Palette">13. Palette Support</a></b></h2>
|
||||
<h2><b><a name="Palette">Palette Support</a></b></h2>
|
||||
<blockquote>
|
||||
|
||||
<p>An Atari 2600 palette consists of 128 colours, which are different
|
||||
for the three major television standards (NTSC, PAL, SECAM).
|
||||
Stella supports two built-in palettes and one user-defined palette for each format.
|
||||
These are set using the '-palette' option, and are described as follows:</p>
|
||||
<p><table cellpadding="5" border="1">
|
||||
<p><table cellpadding="4" border="1">
|
||||
<tr>
|
||||
<td><b>standard</b></td>
|
||||
<td>The default palette from Stella 1.4 onwards.</td>
|
||||
|
@ -3723,7 +3723,7 @@ Ms Pac-Man (Stella extended codes):
|
|||
path for this file hasn't been set, the default filename will depend on the
|
||||
version of Stella, as follows:</p>
|
||||
|
||||
<p><table cellpadding="5" border="1">
|
||||
<p><table cellpadding="4" border="1">
|
||||
<tr>
|
||||
<td><b>Linux/Unix</b></td>
|
||||
<td><i>$HOME/.config/stella/stella.pal</i></td>
|
||||
|
|
Loading…
Reference in New Issue