Apple-2-Tools
/
AppleWin
mirror of https://github.com/AppleWin/AppleWin.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Updated help: 

. Added Uthernet doc as html
. Many mod's reflecting the changes over the last 6 months
. Need to get Michael to update the debugger section
This commit is contained in:
tomch 2006-07-08 17:12:52 +00:00
parent 7eeea8c57d
commit 87327f9ffe
12 changed files with 457 additions and 612 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
AppleWin/help/Table of Contents.hhc
View File

@ -75,8 +75,12 @@
<param name="Local" value="savestate.html">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="Video and Sound">
<param name="Local" value="videosound.html">
<param name="Name" value="Sound">
<param name="Local" value="sound.html">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="Uthernet network card">
<param name="Local" value="uthernet.html">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="AppleWin Configuration">

39
AppleWin/help/acknowledgements.html
View File

@ -1,26 +1,19 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
<title>Acknowledgements</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);">Acknowledgements</h2>
<hr size="4">
<p>I would like to thank the following for their contributions:</p>
<p style="margin-left: 40px;">Thomas Stahl: TV emulation mode</p>
<p style="margin-left: 40px;">Chris Foxwell: SSI263 phoneme samples</p>
<p style="margin-left: 40px;">Robert Hoem: Harddisk card: source module &amp; f/w</p>
</body>
<head>
<title>Acknowledgements</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)">Acknowledgements</h2>
<hr size="4">
<p>The team&nbsp;would like to thank the following people for their contributions:</p>
<p style="MARGIN-LEFT: 40px">Thomas Stahl: TV emulation mode</p>
<p style="MARGIN-LEFT: 40px">Chris Foxwell: SSI263 phoneme samples</p>
<p style="MARGIN-LEFT: 40px">Robert Hoem: Harddisk card: source module &amp; f/w</p>
<P style="MARGIN-LEFT: 40px">Nick Westgate: Floating bus support</P>
<P style="MARGIN-LEFT: 40px">Glenn Jones: Uthernet card (adapted from VICE's TFE by
Spiro Trikaliotis)</P>
</body>
</html>

185
AppleWin/help/cfg-config.html
View File

@ -1,106 +1,85 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
<title>Configuration 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);">Configuration Settings</h2>
<hr size="4"><img style="width: 344px; height: 460px; float: right;" src="img/config.png" alt="Configuration settings" hspace="5" vspace="5"><strong>Computer:</strong><br>
This describes the mode of emulation. &nbsp;You have the option of
emulating the predecessor of the Apple //e, the Apple ][+.
Besides running with a different Apple system ROM, some
differences are discussed below.<br>
<ul>
<li>Apple ][+ : 64K machine, no lower-case, no 80-column, 6502
CPU</li>
<li>Apple //e : 128K machine, lower-case, 80-column, 65C02 CPU</li>
</ul>
<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 video emulation to be
used for the emulator. Some differences might be
discussed below.<br>
<ul>
<li><strong>Monochrome :</strong>&nbsp;This
mode emulates a monochrome monitor. You can choose your monochrome
color from the <em>Monochrome Color</em> button described
below.</li>
<li><strong>Color (standard) :</strong>&nbsp;This
mode emulates a standard color monitor.</li>
<li><strong>Color (text optimized) :</strong>&nbsp;This
mode does a bit of image processing to make text more readable on the
hires screen.</li>
<li><strong>Color (TV emulation) :</strong>&nbsp;This
mode emulates how colors would bleed into one another on a
TV. On the hires screen, alternating horizontal lines of color
are bled together to form new colors like grey, purple, pink, yellow
and aquamarine. This effect was used in commercial games like Karateka
and many hires adventures (eg. Mindshadow).
</li>
</ul>
<strong>Serial Port:<br>
</strong>This option will remap the emulated Apple's serial port
to your PC's serial port.<br>
<br>
<strong>Monochrome Color:</strong><br>
This is the color to use when you choose a monochrome video mode.<br>
<br>
<strong>Emulation Speed Control:</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>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. &nbsp;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>
<li>Pure CPU MHz</li>
<li>Expected average video game performance (in FPS)</li>
</ul>
</body>
<head>
<title>Configuration Settings</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)">Configuration Settings</h2>
<hr size="4">
<img style="FLOAT: right; WIDTH: 344px; HEIGHT: 460px" src="img/config.png" alt="Configuration settings"
hspace="5" vspace="5"><strong>Computer:</strong><br>
This describes the mode of emulation. &nbsp;You have the option of emulating
the predecessors of the Apple //e: the Apple ][ and Apple ][+. Besides running
with a different Apple system ROM, some differences are discussed below.<br>
<ul>
<li>
Apple ][ : Non-autobooting, 64K machine, no lower-case, no 80-column, 6502 CPU
<LI>
Apple ][+ :&nbsp;Autobooting version of the Apple ][&nbsp;
<li>
Apple //e : 128K machine, lower-case, 80-column, 65C02 CPU</li>
</ul>
<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
video emulation to be used for the emulator. Some differences might be
discussed below.<br>
<ul>
<li>
<strong>Monochrome (custom) :</strong>&nbsp;This mode emulates a monochrome
monitor. You can choose your monochrome color from the <em>Monochrome Color</em>
button described below.
<LI>
<STRONG>Monochrome (amber/green/white) :</STRONG>&nbsp;Monochrome with
specified color.
<li>
<strong>Color (standard) :</strong>&nbsp;This mode emulates a standard
color monitor.
<li>
<strong>Color (text optimized) :</strong>&nbsp;This mode does a bit of
image processing to make text more readable on the hires screen.
<li>
<strong>Color (TV emulation) :</strong>&nbsp;This mode emulates how colors
would bleed into one another on a TV. On the hires screen, alternating
horizontal lines of color are bled together to form new colors like grey,
purple, pink, yellow and aquamarine. This effect was used in commercial games
like Karateka and many hires adventures (eg. Mindshadow).
</li>
</ul>
<P>
<strong>Serial Port:<br>
</strong>This option will remap the emulated Apple's serial port to your PC's
serial port. The Apple Super Serial Card is partially emulated in slot-2.<br>
<STRONG>
<BR>
Ethernet Settings...:</STRONG>
<br>
This allows to choose which network interface card (NIC) you want to
use&nbsp;with the Uthernet card.</P>
<P><STRONG>Monochrome Color:</STRONG><br>
This is the color to use when you choose a monochrome video mode.<br>
<br>
<strong>Emulation Speed Control:</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>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. &nbsp;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>
</P>
<ul>
<li>
Pure Video FPS
<li>
Pure CPU MHz
<li>
Expected average video game performance (in FPS)</li>
</ul>
</body>
</html>

58
AppleWin/help/contact.html
View File

@ -1,34 +1,30 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
<title>Contacting the Author</title>
</head>
<body style="background-color: rgb(255, 255, 255); font-family: verdana;" alink="#008000" link="#008000" vlink="#008000">
<h2><font color="#008000">Contacting
the Author</font></h2>
<hr size="4"><br>
To contact the author of this program, email:<br>
<div style="margin-left: 40px;"><a href="mailto:tomcharlesworth@blueyonder.co.uk">Tom
Charlesworth (tomcharlesworth@blueyonder.co.uk)</a></div>
<br>
<br>
To contact the author of this help file, email:
<br>
<div style="margin-left: 40px;"><a href="mailto:brian_broker@yahoo.com">Brian Broker
(brian_broker@yahoo.com)</a></div>
</body>
<head>
<title>Contacting the Author</title>
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
</head>
<body style="FONT-FAMILY: verdana; BACKGROUND-COLOR: rgb(255,255,255)" vLink="#008000"
aLink="#008000" link="#008000">
<h2><font color="#008000">Contacting the developers</font></h2>
<P>
<hr SIZE="4">
<P></P>
<P><br>
To contact the&nbsp;project administrators, email:<br>
<A href="mailto:tomch@users.berlios.de">Tom Charlesworth</A><br>
<A href="mailto:mpohoreski@users.berlios.de">Michael&nbsp;Pohoreski</A></P>
<br>
<P>Bug reports should be submitted here:<br>
<A href="https://developer.berlios.de/bugs/?func=addbug&amp;group_id=6117">https://developer.berlios.de/bugs/?func=addbug&amp;group_id=6117</A>
</P>
<P>Feature requests should be submitted here:<br>
<A href="https://developer.berlios.de/feature/?func=addfeature&amp;group_id=6117">https://developer.berlios.de/feature/?func=addfeature&amp;group_id=6117</A>
</P>
<P>
<br>
To contact the author of this help file, email:
<br>
<a href="mailto:brian_broker@yahoo.com">Brian Broker</a></P>
</body>
</html>

BIN
AppleWin/help/img/config.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 15 KiB

After

Width:  |  Height:  |  Size: 11 KiB

198
AppleWin/help/keyboard.html
View File

@ -1,132 +1,78 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
<title>Using the Keyboard</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);">Using
the Keyboard</h2>
<hr size="4">
<p>The Apple //e keyboard was
very similar to
the PC keyboard, and most keys correspond directly between the
two keyboards. However, there were a few keys on the Apple //e
that are not on the PC; these are described below:</p>
<p><span style="font-weight: bold;">Reset</span>:<br>
On the Apple //e, you could usually press Control+Reset to
interrupt a running program. With the Apple //e Emulator, you may
emulate this key sequence with <span style="font-style: italic;">Ctrl+Break</span>.
</p>
<p><span style="font-weight: bold;">Open Apple:</span><br>
The Open Apple key was first introduced in the Apple
//e, and was later renamed to the Apple key. It was similar to <span style="font-style: italic;">Ctrl</span>
and <span style="font-style: italic;">Alt</span> on
a PC, in that it was used in
conjunction with
other keys. This key is emulated with the PC's left <span style="font-style: italic;">Alt</span>
key, which is in the same position as the Open Apple key on the
original //e. </p>
<p><span style="font-weight: bold;">Solid Apple:</span><br>
The Solid Apple key was introduced on the Apple //e and later
renamed to the Option key. This key is emulated with the PC's
right <span style="font-style: italic;">Alt</span>
key, which is in the same position as
the
Solid Apple key on the original //e. </p>
<p><span style="font-weight: bold;">Numeric Keypad:</span><br>
The numeric keypad, introduced on the Extended Keyboard //e, is
emulated through the PC's numeric keypad. To enable this feature,
turn on <span style="font-style: italic;">Num Lock </span>and
make sure the joystick
emulation is
configured to use something other than the keyboard. </p>
<p><span style="font-weight: bold;">Pause:</span><br>
Pressing the PC's <span style="font-style: italic;">Pause</span>
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>
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>
<p><span style="font-weight: bold;">Function Keys
<head>
<title>Using the Keyboard</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)">Using the Keyboard</h2>
<hr size="4">
<p>The Apple //e keyboard was very similar to the PC keyboard, and most keys
correspond directly between the two keyboards. However, there were a few keys
on the Apple //e that are not on the PC; these are described below:</p>
<p><span style="FONT-WEIGHT: bold">Reset</span>:<br>
On the Apple //e, you could usually press Control+Reset to interrupt a running
program. With the Apple //e Emulator, you may emulate this key sequence with
<span style="FONT-STYLE: italic">Ctrl+Break</span>.
</p>
<p><span style="FONT-WEIGHT: bold">Open Apple:</span><br>
The Open Apple key was first introduced in the Apple //e, and was later renamed
to the Apple key. It was similar to
<span style="FONT-STYLE: italic">Ctrl</span>
and
<span style="FONT-STYLE: italic">Alt</span>
on a PC, in that it was used in conjunction with other keys. This key is
emulated with the PC's left
<span style="FONT-STYLE: italic">Alt</span>
key, which is in the same position as the Open Apple key on the original //e.
</p>
<p><span style="FONT-WEIGHT: bold">Solid Apple:</span><br>
The Solid Apple key was introduced on the Apple //e and later renamed to the
Option key. This key is emulated with the PC's right
<span style="FONT-STYLE: italic">Alt</span>
key, which is in the same position as the Solid Apple key on the original //e.
</p>
<p><span style="FONT-WEIGHT: bold">Numeric Keypad:</span><br>
The numeric keypad, introduced on the Extended Keyboard //e, is emulated
through the PC's numeric keypad. To enable this feature, turn on
<span style="FONT-STYLE: italic">Num Lock </span>and make sure the joystick
emulation is configured to use something other than the keyboard.
</p>
<p><span style="FONT-WEIGHT: bold">Pause:</span><br>
Pressing the PC's
<span style="FONT-STYLE: italic">Pause</span>
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>
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>
<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&nbsp;gets converted to CR.</P>
<P>
<span style="FONT-WEIGHT: bold">Function Keys
F1-F8:</span><br>
These PC function keys correspond to buttons on the <a href="toolbar.html">
toolbar</a>.</p>
<p><span style="font-weight: bold;">Function Key F9:</span><br>
This PC function key will cycle through AppleWin's display
modes:&nbsp; monochrome, color (normal), color (text optimized) and
color (TV emulation). This shortcut allows you to switch display modes
without going through the configuration dialog.</p>
<p><span style="font-weight: bold;">Function Key F10 (or
These PC function keys correspond to buttons on the <a href="toolbar.html">toolbar</a>.</P>
<p><span style="FONT-WEIGHT: bold">Function Key F9:</span><br>
This PC function key will cycle through AppleWin's display modes:&nbsp;
monochrome (custom), color (normal), color (text optimized), color (TV
emulation), etc. This shortcut allows you to switch display modes without going
through the configuration dialog.</p>
<p><span style="FONT-WEIGHT: bold">Function Key F10 (or
Ctrl+left mouse button):</span><br>
This PC function key will stop emulating an Apple joystick
with the PC's mouse.</p>
<p><span style="font-weight: bold;">Function Keys
This PC function key will stop emulating an Apple joystick with the PC's mouse.</p>
<p><span style="FONT-WEIGHT: bold">Function Keys
F11-F12:</span><br>
These PC function keys correspond to saving/loading a <a href="savestate.html">save-state</a> file.</p>
</body>
These PC function keys correspond to saving/loading a <a href="savestate.html">save-state</a>
file.</p>
</body>
</html>

60
AppleWin/help/newsgroups.html
View File

@ -1,43 +1,23 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
<title>Internet Newsgroups</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);">Internet
Newsgroups</h2>
<hr size="4">
<p><span style="font-weight: bold;">comp.emulators.apple2</span><br>
This newsgroup is an excellent source of information about Apple
II emulation, and the best place to post questions, requests, and
suggestions.</p>
<p><span style="font-weight: bold;">comp.emulators.announce</span><br>
If you are only interested in hearing announcements of new
emulator products and new versions of AppleWin and other
emulators, you may want to subscribe to this newsgroup instead of
comp.emulators.apple2. This newsgroup is also a good place to
look for answers to frequently asked questions.</p>
<p><span style="font-weight: bold;">comp.sys.apple2</span><br>
This newsgroup is for general discussion and questions about the
Apple II series of computers.</p>
<p><span style="font-weight: bold;">comp.sys.apple2.programmer</span><br>
This newsgroup is a good source of information about programming
the Apple II series of computers. </p>
</body>
<head>
<title>Internet Newsgroups</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)">Internet Newsgroups</h2>
<hr size="4">
<p><span style="FONT-WEIGHT: bold">comp.emulators.apple2</span><br>
This newsgroup is an excellent source of information about Apple II emulation,
and the best place to post questions, requests, and suggestions. New releases
are also announced here.</p>
<p><span style="FONT-WEIGHT: bold">comp.sys.apple2</span><br>
This newsgroup is for general discussion and questions about the Apple II
series of computers.</p>
<p><span style="FONT-WEIGHT: bold">comp.sys.apple2.programmer</span><br>
This newsgroup is a good source of information about programming the Apple II
series of computers.
</p>
</body>
</html>

97
AppleWin/help/savestate.html
View File

@ -1,74 +1,29 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
<title>Save-State Files</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);">Save-state
Files</h2>
<hr size="4">
<p style="font-weight: bold;">Overview:
</p>
<p>The complete<sub style="font-weight: bold;">1</sub>
Apple //e state can be saved to a
PC file at any time. This can be useful for continuity across AppleWin
sessions or to help with games that don't have a save option.</p>
<p>This is controlled by the AppleWin Configuration tab
labelled <em>Save State</em>.</p>
<p style="font-weight: bold;">Details:</p>
<p>The entire Apple //e state is saved to a file (.aws). This
includes Disk][ (even during r/w operation) and Mockingboards.</p>
<p><span style="font-weight: bold;">1</span>
Currently the harddisk state is not persisted
to the .aws file.</p>
<p>Note: Only the file names of the disk images are stored in
the .aws (not the full path). This allows you to move your disk image
around or distribute them. If AppleWin can't locate the disk image(s),
then it will prompt for the new location.</p>
<p>For the file format of the
.aws file, see the source file:
AW_Structs.h</p>
<p style="font-weight: bold;">Configuration: Save
State:</p>
<p>From the <em>Save
State</em>
page:</p>
<p><span style="font-weight: bold;">Save state file
name</span><br>
This is the current save state file which is used for all save state
operations.</p>
<p><span style="font-weight: bold;">Save state on
exit</span><br>
Checking this means the Apple's state is automatically saved when you
quit AppleWin. Additionally the Apple's state is automatically restored
from this file when you re-start AppleWin.</p>
<p><span style="font-weight: bold;">Save State / F11</span><br>
Save to a save-state file.</p>
<p><span style="font-weight: bold;">Load State / F12</span><br>
Load from a save-state file.</p>
</body>
<head>
<title>Save-State Files</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)">Save-state Files</h2>
<hr size="4">
<p style="FONT-WEIGHT: bold">Overview:
</p>
<p>The complete<sub style="FONT-WEIGHT: bold">1</sub> Apple //e state can be saved
to a PC file at any time. This can be useful for continuity across AppleWin
sessions or to help with games that don't have a save option.</p>
<p>This is controlled by the AppleWin Configuration tab labelled <em>Save State</em>.</p>
<p style="FONT-WEIGHT: bold">Details:</p>
<p>The entire Apple //e state is saved to a file (.aws). This includes Disk][ (even
during r/w operation) and Mockingboards.</p>
<p><span style="FONT-WEIGHT: bold">1</span>
Currently the harddisk state is not persisted to the .aws file. Phasor and
Uthernet cards are not persisted either.</p>
<p>Note: Only the file names of the disk images are stored in the .aws (not the
full path). This allows you to move your disk image around or distribute them.
If AppleWin can't locate the disk image(s), then it will prompt for the new
location.</p>
<p>For the file format of the .aws file, see the source file: AW_Structs.h</p>
</body>
</html>

79
AppleWin/help/sound.html Normal file
View File

@ -0,0 +1,79 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>Quick Start</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)">
Sound</h2>
<hr size="4">
<h3>Sound:</h3>
<p>AppleWin emulates both the internal speaker (using the PC speaker or sound card)
and also the Mockingboard sound card (using a PC sound card).</p>
<p>Use the AppleWin Configuration tab labelled <em>Sound</em>.</p>
<p>If you are using a sound card, then use at least DirectX-9.</p>
<h4>Speaker:</h4>
<p>You can select PC speaker or sound card:</p>
<ul>
<li>
PC speaker: This is not recommended as the quality is poor. It is not usable on
Windows 2000 or XP.
<li>
Sound card: Recommended</li>
</ul>
<h4>Mockingboard:</h4>
<p>When the Mockingboards are enabled, the cards are physically plugged into slots
4 and 5 of the Apple //e.</p>
<p>Each Mockingboard is a type 'C': 2x AY8910 (3-channel sound generator) &amp; 1x
SSI263 (speech chip)<font face="Tahoma"><br>
</font>Each AY8910 is fully emulated (tone, noise &amp; envelope).<font face="Tahoma"><br>
</font>Each SY6522 (that controls an AY8910) can generate precise timer
interrupts or phoneme-complete interrupts.<font face="Tahoma"><br>
</font>Emulation of the SSI263 is basic at the moment and only plays back
phonemes at a fixed rate without any support for inflection or filters.<font face="Tahoma"><br>
</font>Additionally the Votrax/SC-01 (predecessor to the SSI263) is emulated by
remapping Votrax phonemes to the SSI263's.</p>
<H4>Phasor:</H4>
<P>When Phasor is enabled, the card is phyically plugged into slot 4 of the Apple
//e.</P>
<P>Phasor is equivalent to 2 Mockingboards: so has 4x AY8910 &amp; 1x SSI263.</P>
<P>&nbsp;</P>
<P>There are a number of games and demos that support Mockingboard (or Phasor), eg:</P>
<ul>
<li>
Adventure Construction Set
<LI>
Crimewave (Votrax speech)
<li>
Lady Tut (Mockingboard version)
<li>
Mockingboard software (Sweet Micro Systems)
<li>
Music Construction Set
<li>
Night Flight
<LI>
Phasor software (Applied Engineering)
<li>
Popeye
<li>
Rescue Raiders v1.3 (Speech only)
<li>
Skyfox
<li>
Spy Strikes Back
<li>
Ultima III (Mockingboard version)
<li>
Ultima IV
<li>
Ultima V
<li>
Willy Byte
<li>
Zaxxon (Mockingboard version)</li>
</ul>
</body>
</html>

98
AppleWin/help/toc.html
View File

@ -1,65 +1,39 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=windows-1252">
<title>Table of Contents</title>
</head>
<body style="background-color: rgb(255, 255, 255); font-family: verdana;" alink="#008000" link="#008000" vlink="#008000">
<img style="width: 278px; height: 18px;" alt="AppleWin Apple //e Emulator" src="img/title.gif">
<hr size="4"><br>
Copyright &copy; 1994-1996, Michael O'Brien<br>
Copyright &copy; 2001, Oliver Schmidt<br>
Copyright &copy; 2002-2005, Tom Charlesworth
<br>
<br>
<a href="acknowledgements.html">Acknowledgements</a>
<br>
<br>
Select one of the following categories:
<ul>
<li><a href="quickstart.html">Quick Start</a></li>
<li><a href="history.html">Historical Information</a></li>
<li><a href="diskimages.html">Disks and Disk Images</a></li>
<li><a href="toolbar.html">Using the Toolbar</a></li>
<li><a href="keyboard.html">Using the Keyboard</a></li>
<li><a href="debug.html">Using the Debugger</a></li>
<li><a href="resources.html">Resources</a></li>
</ul>
</body>
<head>
<title>Table of Contents</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">
<img style="WIDTH: 278px; HEIGHT: 18px" alt="AppleWin Apple //e Emulator" src="img/title.gif">
<hr size="4">
<br>
Copyright © 1994-1996, Michael O'Brien<br>
Copyright © 2001, Oliver Schmidt<br>
Copyright © 2002-2005, Tom Charlesworth<BR>
Copyright © 2006, Tom Charlesworth, Michael Pohoreski
<br>
<br>
<a href="acknowledgements.html">Acknowledgements</a>
<br>
<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="debug.html">Using the Debugger</a>
<li>
<a href="resources.html">Resources</a></li>
</ul>
</body>
</html>

93
AppleWin/help/uthernet.html Normal file
View File

@ -0,0 +1,93 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>Save-State Files</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)">Uthernet network card</h2>
<hr size="4">
<p style="FONT-WEIGHT: bold">Overview:
</p>
<P>The Uthernet network card coupled with the Contiki OS allows you to browse the
internet on your Apple.</P>
<P style="FONT-WEIGHT: bold">Acknowledgment:
</P>
<P>Uthernet (TFE) support in Applewin was made possible by implementing the GPL
source written by Spiro Trikaliotis for the Vice emulator - <A href="http://www.viceteam.org/">
http://www.viceteam.org/</A></P>
<P style="FONT-WEIGHT: bold">Details:
</P>
<P>To enable Ethernet support in AppleWin you must first download and install
WinPcap.
</P>
<P>An Alternative to downloading WinPcap is to get the Ethereal package which
includes WinPcap along with Ethereal network analyzer code. To use Ethereal to
capture traffic (other then your own) you must be plugged into a shared hub vs
a switch. If you plan on doing any network programming ethereal is a definite
must have.
</P>
<P>WinPcap: <A href="http://www.WinPcap.org/install/default.htm">http://www.WinPcap.org/install/default.htm</A>
or Ethereal:
</P>
<P><A href="http://www.ethereal.com/download.html">http://www.ethereal.com/download.html</A>
</P>
<P>After AppleWin starts, select the settings ICON and then select the Ethernet
settings button.
</P>
<P>Uthernet will be disabled. Select Uthernet from the list of available ethernet
emulations (currently the only one).
</P>
<P>Select the ethernet interface you want to work with. This must be a physical
ethernet interface.
</P>
<P>If you have more then one interface you may need to select them in turn in order
to get the text description for each interface vs what WinPcap likes to use for
a reference. Select Ok. and then close AppleWin. *Note:* Wireless does not work
with WinPcap.
</P>
<P>NOTE: Due to a current limitation you must exit AppleWin and re-run AppleWin for
'a' ethernet interface change to take effect.
</P>
<P>In order to test the Ethernet emulation out you should grab a copy of Contiki
for the Apple II here - <A href="http://www.a2retrosystems.com/downloads.htm">http://www.a2retrosystems.com/downloads.htm</A>
</P>
<P>Grab the 80 Col. Primary Disk and Supplementary Disk images if using Apple //e
emulation or the 40 Col versions if running Apple II+ emulation. You should
also grab a copy of the Uthernet/Contiki getting started guide <A href="http://www.a2retrosystems.com/a2UtherManual.pdf">
http://www.a2retrosystems.com/a2UtherManual.pdf</A>
</P>
<P>When you run AppleWin again, select the contiki80pri.dsk image. Boot AppleWin.
</P>
<P>Once Contiki is loaded then press Enter to clear the welcome screen and press
ESC for a menu.
</P>
<P>Choose Directory Application and then select configuration edit program. Tab
down to the Slot param and change it to '3'. The emulation only works in slot
3.
</P>
<P>If you do not have DHCP support in your local Lan then setup your static IP
address information here as well. Save and exit. If you have DHCP support in
your local lan then press ESC and choose Directory Application again, and then
select DHCP client.
</P>
<P>Hit enter on request Address and you should see the IP information updated.
Close the window and then press ESC again.
</P>
<P>Select the web browser and hit Enter a couple of times. Adam Dunkels web site
should show up if things are working properly.
</P>
<P>Try a few other web sites if the first one isn't working in case it is
temporarily down.
</P>
<P>You may also need to configure/disable your firewall if you are having problems.
</P>
<P style="FONT-WEIGHT: bold">Troubleshooting:
</P>
<P>If you have ZoneAlarm running then try disabling it inorder to access the web.
if you are still having difficulty then you should refer to the VICE network
support page for additional information - <A href="http://vicekb.trikaliotis.net/13-005.shtml">
http://vicekb.trikaliotis.net/13-005.shtml</A></P>
</body>
</html>

154
AppleWin/help/videosound.html
View File

@ -1,154 +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>Quick Start</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);">Video
&amp; Sound</h2>
<hr size="4">
<h3>Video:</h3>
<p>AppleWin can display Apple
video in a variety of modes.
The display can also be run in a standard window or full-screen.</p>
<h4>Monochrome:</h4>
<p>This mode emulates a
monochrome monitor. You can choose
your monochrome color from AppleWin Configuration.</p>
<h4>Color (standard):</h4>
<p>This mode emulates a standard
color monitor.</p>
<h4>Color (text
optimized):</h4>
<p>This mode does a bit of image
processing to make text more
readable on the hires screen.</p>
<h4>Color (TV emulation):</h4>
<p>This mode emulates how colors
bleed into one another on a
TV.</p>
<p>On the hires screen,
alternating horizontal lines of color
are bled together to form new colors like grey, purple, pink, yellow
and
aquamarine. This effect was used in commercial games like Karateka and
many
hires adventures (eg. Mindshadow).</p>
<p>&nbsp;</p>
<h3>Sound:</h3>
<p>AppleWin emulates both the
internal speaker (using the PC
speaker or sound card) and also the Mockingboard sound card (using a PC
sound
card).</p>
<p>Use the AppleWin Configuration
tab labelled <em>Sound</em>.</p>
<p>If you are using a sound card,
then use at least
DirectX-9.</p>
<h4>Speaker:</h4>
<p>You can select PC speaker or
sound card:</p>
<ul>
<li>PC speaker: This is not
recommended as the quality is poor. It is not usable on Windows 2000 or
XP.</li>
<li>Sound card: Recommended</li>
</ul>
<h4>Mockingboard:</h4>
<p>When the Mockingboards are
enabled, the cards are
physically plugged into slots 4 and 5 of the Apple //e.</p>
<p>Each Mockingboard is a type
'C': 2x AY8910 (3-channel
sound generator) &amp; 1x SSI263 (speech chip)<font face="Tahoma"><br>
</font>Each AY8910 is fully
emulated (tone, noise &amp;
envelope).<font face="Tahoma"><br>
</font>Each SY6522 (that controls
an AY8910) can generate
precise timer interrupts or phoneme-complete interrupts.<font face="Tahoma"><br>
</font>Emulation of the SSI263 is
basic at the moment and
only plays back phonemes at a fixed rate without any support for
inflection or
filters.</p>
<p>There are a number of games
and demos that support
Mockingboard, eg:</p>
<ul>
<li>Adventure Construction Set</li>
<li>Lady Tut (Mockingboard
version)</li>
<li>Mockingboard Software
(Sweet Micro Systems)</li>
<li>Music Construction Set</li>
<li>Night Flight</li>
<li>Popeye</li>
<li>Rescue Raiders v1.3
(Speech only)</li>
<li>Skyfox</li>
<li>Spy Strikes Back</li>
<li>Ultima III (Mockingboard
version)</li>
<li>Ultima IV</li>
<li>Ultima V</li>
<li>Willy Byte</li>
<li>Zaxxon (Mockingboard
version)</li>
</ul>
</body>
</html>