Help doc: update for new Config UI

This commit is contained in:
tomcw
2026-03-07 23:27:42 +00:00
parent 554e6d3ecc
commit 35467b62b2
15 changed files with 55 additions and 250 deletions
+2 -6
View File
@@ -128,12 +128,8 @@
<param name="Local" value="cfg-input.html">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="Sound Settings">
<param name="Local" value="cfg-sound.html">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="Disk / Drive Settings">
<param name="Local" value="cfg-disk.html">
<param name="Name" value="Slot Settings">
<param name="Local" value="cfg-slots.html">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="Advanced Settings">
+19 -41
View File
@@ -1,9 +1,12 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head>
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252"><title>Advanced Settings</title></head>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
<title>Advanced Settings</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);">Advanced Settings</h2>
<hr size="4"><img style="width: 354px; height: 497px; float: right;" src="img/advanced.png" alt="Advanced settings" hspace="5" vspace="5">
<hr size="4"><img style="width: 340px; height: 491px; float: right;" src="img/cfg-advanced.png" alt="Advanced settings" hspace="5" vspace="5">
<p><strong>Save State Filename:</strong><br>
This is the file name to use for save-state files. The default
@@ -21,44 +24,6 @@ Press this button to load the specified state file into
the emulator. &nbsp;You can also load the system state during
emulation by pressing the F12 key.</p>
<p><strong>Printer settings </strong>(Printer is emulated in slot 1)
</p>
<p style="margin-left: 40px;"><strong>Printer dump filename:<br>
</strong>
Data sent to the printer is stored in a text file. Use
this setting to select its location.<br>
</p>
<p style="margin-left: 40px;"><strong>Dump to printer:<br>
</strong><span style="font-weight: bold; font-style: italic;">Use
with caution!</span> Enables dumping to a real printer. If
disabled, the printout is stored only in printer.txt file in the AppleWin folder.
It's recommended to use a printer compatible with the printer selected in the Apple II applications.
With modern printers trying to print images will result in printing tens of
pages of nonsense. Requires command line switch -use-real-printer.<br>
</p>
<p style="margin-left: 40px;"><strong>Encoding conversion for clones:<br>
</strong>Characters are encoded from the character set used in
the real hardware to ASCII. For Pravets 8 this converts MIK to ASCII.
Enabling this could cause problems when printing images.
</p>
<p style="margin-left: 40px;"><strong>Filter unprintable characters:<br>
</strong>Some characters represent commands for the printer and
shall not be printed. When saving them to the printer dump file they
may appear as some strange symbols. (You will want to disable filtering
when dumping to a real printer.)
</p>
<p style="margin-left: 40px;"><strong>Append to print-file:<br>
</strong>When disabled, the previous print file is replaced (unless it has a
different name) by the newly created print file. Otherwise the newly
printed data is added to the existing print file. (You will want to
disable appending when dumping to a real printer.)
</p>
<p style="margin-left: 40px;"><strong>Terminate printing after idle:<br>
</strong>When printing is started, a printer file is created and it is
closed either after the specified time expires, or when
the emulator is reset. This setting is emulation speed dependent.
</p>
<p><strong>Clone:</strong><br>
If you have specified Computer as 'Clone' on the main Configuration
page, then this drop-down menu can be used to specify the clone type.<br>
@@ -95,4 +60,17 @@ NB. Copy protection dongles can interfere with RGB cards (eg. unexpected video m
NB. For Apple II/II+ models, when a joystick is selected (from the <a href="cfg-input.html">Input</a> tab), then there is also an implicit joystick connected at the same time as the device selected here (and some dongles even allowed 16-pin game connectors to be plugged in on top, eg. SDS and Robocom devices).
</p>
<strong>Benchmark Emulator:</strong><br>
This will run a benchmark test that will show how fast your PC can emulate an
Apple //e system with this emulator. In order to run the benchmark, the
emulated machine must be reset and you will lose any unsaved work. You will be
prompted before you continue this action. The results given are:<br>
<ul>
<li> Pure Video FPS
<li> Pure CPU MHz (video update)
<li> Pure CPU MHz (full-speed)
<li> Expected average video game performance (in FPS)
</ul>
Use Ctrl+C to copy the results to the clipboard.
</body></html>
+33 -32
View File
@@ -8,8 +8,7 @@
link="#008000" vlink="#008000">
<h2 style="COLOR: rgb(0,128,0)">Configuration Settings</h2>
<hr size="4">
<img style="FLOAT: right; WIDTH: 354px; HEIGHT: 497px" src="img/config.png" alt="Configuration settings"
hspace="5" vspace="5">
<img style="FLOAT: right; WIDTH: 340px; HEIGHT: 491px" src="img/cfg-config.png" alt="Configuration settings" hspace="5" vspace="5">
<strong>Model:</strong><br>
This describes the mode of emulation. &nbsp;You have the option of emulating
@@ -28,6 +27,12 @@
Show "Confirm reboot" message box when F2 is pressed.<br>
<br>
<strong>Master Volume:</strong><br>
Set the volume for the speaker and any sound cards.<br>
<br>
<hr>
<strong>Video:</strong><br>
AppleWin can display Apple video in a variety of modes. The display can also be
run in a standard window or full-screen. This option describes the type of
@@ -60,51 +65,47 @@
When video mode is 'Color (Composite Idealized)' then vertically blend the hi-res screen.<br>
<br>
<strong>50Hz video:</strong><br>
When checked, this option will run the emulated machine with a 50Hz(PAL) video refresh rate.
The default is unchecked, for 60Hz(NTSC).<br>
<br>
<strong>Full-Screen: Show drive/keyboard status:</strong><br>
When in full-screen mode, show floppy (activity and track) and harddisk status (activity); keyboard caps-lock status and if emulation is paused.<br>
<br>
<strong>VidHD in slot 3</strong><br>
Insert a VidHD card into slot 3 (which can co-exist with an 80-column card in the Apple //e's AUX slot).<br>
Allows all Apple II models to support the IIgs' Super Hi-Res (SHR) video modes and is supported by eg. <a target="_blank" href="https://archive.org/details/TotalReplay">Total Replay</a>.<br>
<br>
<hr>
<strong>Serial Port:</strong><br>
This option will remap the emulated Apple's serial port to your PC's serial port (or TCP port 1977).<br>
See <a href="card-ssc.html">Super Serial Card</a> for more details.<br>
<strong>Emulation Speed Control:</strong><br><br>
<strong>Enhanced disk access speed:</strong><br>
Here you can choose the speed at which the system can access
an emulated floppy disk drive.
By default, you would want "Enhanced Speed" so that data can
be accessed as fast as possible. However, it is also possible that
certain programs might depend on the "Authentic Speed" to function
properly. This is the speed at which the real hardware
would access data from your drives.
<br>
<br>
<strong>Ethernet Settings...:</strong><br>
This allows to choose which network interface card (NIC) you want to
use with the Uthernet or Uthernet II card.<br>
<br>
<strong>Scroll Lock acts as toggle for full-speed CPU:</strong><br>
<ul>
<li>When checked, you can permanently enable full-speed CPU when Scroll Lock is on.</li>
<li>When unchecked, only when Scroll Lock is depressed will you get full-speed CPU.</li>
</ul>
<strong>Emulation Speed Control:</strong><br>
<strong>Select Custom Speed (in MHz):</strong><br>
This option let's you control the processor speed of the emulated system. You
may choose to use an authentic speed (matching the speed of the original
processor from the system) or you can underclock or overclock the emulated
processor speed from half-speed to as fast as your PC can emulate.<br>
<br>
<strong>50Hz video:</strong><br>
When checked, this option will run the emulated machine with a 50Hz(PAL) video refresh rate.
The default is unchecked, for 60Hz(NTSC).<br>
<br>
<hr>
<strong>Reset all to Default:</strong><br>
Reset all configuration across all configuration pages to the default values.
<strong>Benchmark Emulator:</strong><br>
This will run a benchmark test that will show how fast your PC can emulate an
Apple //e system with this emulator. In order to run the benchmark, the
emulated machine must be reset and you will lose any unsaved work. You will be
prompted before you continue this action. The results given are:<br>
<ul>
<li> Pure Video FPS
<li> Pure CPU MHz (video update)
<li> Pure CPU MHz (full-speed)
<li> Expected average video game performance (in FPS)
</ul>
Use Ctrl+C to copy the results to the clipboard.
</li>
</body>
</html>
-66
View File
@@ -1,66 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
<title>Disk Settings</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);">Disk Settings</h2>
<hr size="4"><img style="width: 354px; height: 497px; float: right;" src="img/disk.png" alt="Disk settings" hspace="5" vspace="5">
<h3>Floppy Controller Settings:</h3>
<p><strong>Enhanced disk access speed:</strong><br>
Here you can choose the speed at which the system can access
an emulated floppy disk drive.
By default, you would want "Enhanced Speed" so that data can
be accessed as fast as possible. However, it is also possible that
certain programs might depend on the "Authentic Speed" to function
properly. This is the speed at which the real hardware
would access data from your drives.
</p>
<p><strong>Show status:</strong><br>
In 2x windowed-mode, optionally show the Track and Sector values for Drives 1 and 2 (for any Disk II cards in slots 5 and/or 6).
Hovering over this status will show a tooltip with both decimal and hexadecimal values, and the track includes the full fractional quarter track value too.
<p><strong>Disk 1/2 drop-down menus (slot 6):</strong><br>
These menus allow you to select floppy disk images to 'insert' into the
emulated floppy drives 1 and 2. This can also be done during emulation by <a href="toolbar.html">using the toolbar</a> or using the F3/F4 keys. Diskettes can be swapped by pressing F5 during emulation. You can also eject images from this menu.
</p>
<p><strong>Enable Disk II controller in slot 5:</strong><br>
A floppy controller card can be plugged into slot 5 by checking this box.
</p>
<p><strong>Disk 1/2 drop-down menus (slot 5):</strong><br>
You can select floppy disk images to 'insert' into the
emulated floppy drives 1 and 2.
</p>
<br>
<h3>Hard disk Controller Settings:</h3>
<p><strong>Enable hard disk controller in slot 7:</strong><br>
A hard disk controller (or interface) card can be plugged into slot 7 by checking this box.
See <a href="ddi-harddisk.html">Hard disk Images</a> for more details.
</p>
<p><strong>Swap:</strong><br>
Swap the hard disk images.<br>
WARNING! If done during image access this could result in undefined behavior (eg. Apple II program crash) or data corruption on the image.
</p>
<p><strong>HDD 1/2 drop-down menus:</strong><br>
These menus allow you to select hard disk images (eg. .hdv files) to
connect to the emulated hard disk controller card. You can also unplug images from this menu.
</p>
<br>
<p><strong>CiderPress path:</strong><br>
Use this to specify where CiderPress is installed.<br>
The right mouse button context menu on either of the drive icons allows you to open CiderPress with the image in the drive.
</p>
</body>
</html>
+1 -59
View File
@@ -1,19 +1,13 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
<title>Input Settings</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);">Input Settings</h2>
<hr size="4"><img style="width: 340px; height: 491px; float: right;" src="img/cfg-input.png" alt="Input settings" hspace="5" vspace="5">
<hr size="4"><img style="width: 354px; height: 497px; float: right;" src="img/input.png" alt="Input settings" hspace="5" vspace="5">
<strong>Joystick Control:</strong><br>
These options allow you to configure up to two joysticks attached to
@@ -38,58 +32,6 @@ then you should leave these values at 0.</li>
<li>Keyboard auto-centering: When keys used for joystick emulation are released then the joystick will return to the central position.</li>
</ul>
<strong>4Play Joystick card:</strong><br>
On real hardware this card allows up to 4 Atari 9-pin joysticks to be connected.<br>
Under emulation, the first 2 Windows-detected controllers will be used, and then for joysticks 3 and 4, use keys: ESDF+ZX and IJKL+NM. Note these keys will also be readable from the keyboard.<br>
<li>The card can be configured in slots 3, 4 or 5.
<li>Since it only uses the slot's DEVICE SELECT space ($C0Bx for slot 3) then it can co-exist with an 80-column card in the Apple //e's AUX slot. NB. For a real PAL Apple //e, then a slot riser card is required for it to fit.<br>
See Lukazi's <a target="_blank" href="https://lukazi.blogspot.com/2016/04/apple-ii-4play-joystick-card.html">4Play card</a> and <a target="_blank" href="https://lukazi.blogspot.com/2017/08/apple-ii-4play-joystick-card-software.html">4Play card software</a> blogs for more information.<br>
<br>
<strong>SNES MAX card:</strong><br>
On real hardware this card allows up to 2 SNES controllers to be connected and all 12 buttons can be read.<br>
Under emulation, the first 2 Windows-detected controllers will be used, ideally with 12 (or more) buttons eg. Logitech F310, PlayStation Dualshock 4, DualSense. Note that for some controllers (eg. 8BitDo NES30 Pro) the buttons need remapping, so use the command line switches -snes-max-alt-joy1 or -snes-max-alt-joy2 to remap.<br>
<li>The card can be configured in slots 3, 4 or 5.
<li>Since it only uses the slot's DEVICE SELECT space ($C0Bx for slot 3) then it can co-exist with an 80-column card in the Apple //e's AUX slot. NB. This card is small, so no slot riser card is required.<br>
See Lukazi's <a target="_blank" href="https://lukazi.blogspot.com/2021/06/game-controller-snes-max-snes.html">SNES MAX</a> blog for more information.<br>
<br>
<br>
<hr>
<strong>Scroll Lock acts as toggle for full-speed CPU:</strong><br>
<ul>
<li>When checked, you can permanently enable full-speed CPU when Scroll Lock is on.</li>
<li>When unchecked, only when Scroll Lock is depressed will you get full-speed CPU.</li>
</ul>
<strong>Mouse interface in slot 4:</strong><br>
<ul>
<li>Disables joystick emulation with mouse.</li>
<li>Disables Mockingboard/Phasor in slot 4.</li>
<li>Show cross-hairs in window's frame:</li>
<ul>
<li>Configure whether you want cross-hairs or not</li>
</ul>
<li>Restrict mouse to Apple window:</li>
<ul>
<li>Restricting is useful for paint applications</li>
<li>When unrestricted, the emulated mouse is fully integrated with the Window desktop:
moving in and out of the AppleWin window will switch between Windows' and the Apple's mouse cursor.</li>
<li>NB. Even when unrestricted, you won't be able to move the mouse outside the Apple window for GEOS. This is not a bug.</li>
<li>Tip: Use Ctrl+Left Mouse Button to show the Windows mouse cursor (eg. essential for GEOS).</li>
</ul>
</ul>
<strong>Microsoft CP/M SoftCard interface in slot 4 or 5:</strong><br>
<ul>
<li>Emulates a CP/M card, complete with full Z80 emulation.</li>
<li>Available when Mockingboard or Phasor isn't in slot 4 or 5.</li>
</ul>
<strong>Paste from clipboard:</strong><br>
Pressing this button will allow you to paste text from the
Windows' clipboard into the emulated Apple //e.<br>
-46
View File
@@ -1,46 +0,0 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
<title>Sound Settings</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);">Sound Settings</h2>
<hr size="4"><img style="width: 354px; height: 497px; float: right;" src="img/sound.png" alt="Sound settings" hspace="5" vspace="5"><strong>Sound:</strong><br>
This option allows you to choose how sound is output for the
system.&nbsp;Your choices are:<br>
<ul>
<li>Disabled</li>
<li>Sound Card (recommended)</li>
</ul>
<br>
<strong>Volume Control:</strong><br>
These slider controls allow you to control the sound
levels of the built-in Apple //e speaker and/or an optional
Mockingboard or Phasor speaker.<br>
<br>
<strong>Sound card selection:</strong><br>
These options allow you to select the type of Apple II sound card in either slot 4 and/or slot 5.
Available sound cards are:
<ul>
<li>Mockingboard C
<li>Phasor
<li>SAM (Software Automatic Mouth) - an 8-bit DAC card
</ul>
</body>
</html>
Binary file not shown.

Before

Width:  |  Height:  |  Size: 35 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 24 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 23 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 21 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 22 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 35 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 34 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 37 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 28 KiB