Help doc: Add new Appendix, and sub-item about full-speed mode. (Fixes #477)

This commit is contained in:
tomcw 2017-12-18 23:14:11 +00:00
parent e25b490198
commit 9236c6722f
5 changed files with 101 additions and 23 deletions

View File

@ -141,7 +141,7 @@
</OBJECT>
<UL>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="Entering the debugger">
<param name="Name" value="Entering & exiting the debugger">
<param name="Local" value="dbg-entering-debugger.html">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
@ -208,6 +208,17 @@
<param name="Local" value="contact.html">
</OBJECT>
</UL>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="Appendix">
<param name="Local" value="appendix.html">
<param name="ImageNumber" value="2">
</OBJECT>
<UL>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="Full-speed mode">
<param name="Local" value="fullspeed.html">
</OBJECT>
</UL>
</UL>
</UL>
</BODY></HTML>

25
help/appendix.html Normal file
View File

@ -0,0 +1,25 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
<title>Appendix</title>
</head>
<body style="background-color: rgb(255, 255, 255); font-family: verdana;" alink="#008000" link="#008000" vlink="#008000">
<h2 style="color: rgb(0, 128, 0);">Appendix</h2>
<hr size="4">
<ul>
<li><a href="fullspeed.html">Full-speed mode</a></li>
</ul>
</body>
</html>

51
help/fullspeed.html Normal file
View File

@ -0,0 +1,51 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>Full-speed mode</title>
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
</head>
<body style="FONT-FAMILY: verdana; BACKGROUND-COLOR: rgb(255,255,255)" alink="#008000"
link="#008000" vlink="#008000">
<h2 style="COLOR: rgb(0,128,0)">Full-speed mode</h2>
<hr size="4">
<p style="FONT-WEIGHT: bold">Overview:</p>
<p>Emulation can be run in full-speed (aka unthrottled) mode.</p>
<p style="FONT-WEIGHT: bold">Details:</p>
<p>This can be enabled manually or automatically in a variety of ways:</p>
<ul>
<li>Permanently enable by the AppleWin <a href="cfg-config.html">Configuration</a> tab's 'Emulation Speed Control', and setting 'Custom Speed (in MHz)' to 'Fastest'.
<li>Scroll Lock key: can be configured to toggle normal/full-speed mode, or only enable full-speed when pressed.
<ul>
<li>See <a href="cfg-input.html">Input</a> for configuring how Scroll Lock behaves.
</ul>
<li>When 'Disk access speed' is set to 'Enhanced Speed' (the default), then whenever the Disk][ drive motor is on, the emulator will automatically switch to full-speed (and when the motor is switched off, then the emulator will automatically revert to what the 'Emulation Speed Control' has been set to).
<ul>
<li>See <a href="cfg-disk.html">Disk</a> for configuring 'Disk access speed'.
</ul>
<li>From the built-in debugger, single-stepping via the 'gg' command.
</ul>
<p style="FONT-WEIGHT: bold">Limitations and things to bear in mind:</p>
<ul>
<li>Full speed mode favours speed over video accuracy:
<ul>
<li>The Apple II's video is only updated periodically (once a wall-clock 60Hz frame) instead of each opcode.
</ul>
<li>All sound (speaker, Mockingboard, etc) is muted.
<li>Video-based timing/synchronisation loops won't work correctly.
<ul>
<li>The video-scanner won't advance its h/v position, so it will always returns the last value.
<li>Specifically code that does Apple II+ VBlank detection (using the floating bus) will hang, until full-speed mode is disabled. (But Apple //e soft-switch VBlank detection does work.)
</ul>
<li>Card detection routines (that rely on floating bus) won't work correctly.
<li>One of your PC's CPU cores will run at 100%.
<ul>
<li>EG. Simply boot the Apple II (or //e) without a disk in drive-1.
</ul>
</ul>
</body>
</html>

View File

@ -43,15 +43,12 @@
key will pause emulation. Press
<span style="font-style: italic;">Pause</span>
again to resume emulation.</p>
<p><span style="font-weight: bold;">Scroll Lock:</span><br>
Holding down the PC's
<span style="font-style: italic;">Scroll Lock</span>
key temporarily sets the emulation to full speed (i.e. unthrottled).<br>
<p><span style="font-weight: bold;">Scroll Lock:</span><br>
<span style="font-style: italic;">Scroll Lock</span>
key can be configured to toggle normal/full-speed mode, or only enable full-speed when pressed. See <a href="cfg-input.html">Input</a> for configuring how <span style="font-style: italic;">Scroll Lock</span> behaves.
NOTE:&nbsp; The status of the PC's
<span style="font-style: italic;">Scroll Lock</span>
LED is meaningless.&nbsp; The emulator will only run full speed while the
<span style="font-style: italic;">Scroll Lock</span>
key is pressed down.</p>
LED is meaningless.</p>
<p><span style="font-weight: bold;">Shift+Insert:</span><br>
Paste text from Windows' clipboard. Text gets fed a character at a time to the
Apple's keyboard hardware. The 'CR+LF' combination gets converted to CR.</p>

View File

@ -12,7 +12,7 @@
Copyright © 1994-1996, Michael O'Brien<br>
Copyright © 2001, Oliver Schmidt<br>
Copyright © 2002-2005, Tom Charlesworth<BR>
Copyright © 2006-2016, Tom Charlesworth, Michael Pohoreski, Nick Westgate, Linards Ticmanis
Copyright © 2006-2017, Tom Charlesworth, Michael Pohoreski, Nick Westgate, Linards Ticmanis
<br>
<br>
<a href="acknowledgements.html">Acknowledgements</a>
@ -20,20 +20,14 @@
<br>
Select one of the following categories:
<ul>
<li>
<a href="quickstart.html">Quick Start</a>
<li>
<a href="history.html">Historical Information</a>
<li>
<a href="diskimages.html">Disks and Disk Images</a>
<li>
<a href="toolbar.html">Using the Toolbar</a>
<li>
<a href="keyboard.html">Using the Keyboard</a>
<li>
<a href="dbg-toc-intro.html">Using the Debugger</a>
<li>
<a href="resources.html">Resources</a></li>
<li><a href="quickstart.html">Quick Start</a>
<li><a href="history.html">Historical Information</a>
<li><a href="diskimages.html">Disks and Disk Images</a>
<li><a href="toolbar.html">Using the Toolbar</a>
<li><a href="keyboard.html">Using the Keyboard</a>
<li><a href="dbg-toc-intro.html">Using the Debugger</a>
<li><a href="resources.html">Resources</a></li>
<li><a href="appendix.html">Appendix</a></li>
</ul>
</body>
</html>