<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
	<head>
		<title>Troubleshooting</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)">Troubleshooting</h2>
		<hr size="4">
		<p style="FONT-WEIGHT: bold">Here is a list of issues and possible solutions:</p>

		Uthernet network card not working.
		<ul>
		<li>There are problems when running with certain firewalls (eg. ZoneAlarm).
			<ul>
			<li>See the Uthernet network card section for details.</li>
			</ul>
		</li>
		</ul>

		AppleWin doesn't startup.
		<ul>
		<li>It could be being blocked by your anti-virus software. There is a known problem with Constant Guard Protection Suite.
			<ul>
			<li>From your anti-virus software, unblock AppleWin to allow it to run.</li>
			</ul>
		</li>
		</ul>

		When using a non-US (or UK) keyboard, certain keys can't be typed.
		<ul>
		<li>AltGr (or right Alt) needs to be used to type certain keys, eg:
			<ul>
			<li>'@' is AltGr+2 (for a Canadian-French keyboard).</li>
			<li>'[' is AltGr+� (for an Italian keyboard).</li>
			</ul>
		</li>
		<li>Some games or productivity software have an action based on the Open Apple (Alt) or Solid Apple (AltGr) keys, eg:
			<ul>
			<li>Lode Runner uses CTRL+@ to increase the lives.</li>
			<li>AppleLogo // and AppleWorks 5.1 have problems when using an Italian keyboard.</li>
			</ul>
		</li>
		<li>This dual function for AltGr (to both type a key and emulate Solid Apple) can cause problems such that the key (eg. '@') can never be typed.</li>
		<li>The workaround is to use the `-no-hook-alt` command line switch and configure Joystick 1 = "Keyboard (numpad)"; and then use the '0' and '.' keys for Open/Solid Apple.</li>
		</ul>

		No Apple II speaker sound, but Mockingboard sound is working!
		<ul>
		<li>Check the Volume Control for the Speaker, under the <a href="cfg-sound.html">Configuration->Sound tab</a>.</li>
		<li>Try installing the Realtek-specific audio driver supplied by ASUS (as opposed to the default Win10 driver).</li>
		</ul>

		Color (RGB Card/Monitor) and title compatibility issues:
		<ul>
		<li>Dragon Wars: double hi-res bit7 needs inverting, so use the -rgb-card-invert-bit7 command line switch.</li>
		<li>Renegade: switches to 160x192 mode at the title screen and then B&W (at the title screen) after game play.</li>
		<li>Apple's AppleColor card or Video7's RGB-SL7 card: corruption for titles/demos that accidentally switch to foreground/background hi-res mode, eg. French Touch DIGIDREAM demo.</li>
		</ul>

		Can't switch to 2x windowed mode:
		<ul>
		<li>If the resolution isn't high enough to support 2x windowed mode, then AppleWin will refuse to switch.</li>
		<li>For different versions of Windows this is slightly different:</li>
			<ul>
			<li>Windows 7 requires: 1181 x 808</li>
			<li>Windows 10 (1909) requires: 1181 x 818</li>
			</ul>
		</ul>
		
		Can't set bookmark 0 in the debugger / CTRL+SHIFT+0 not working:
		<img style="FLOAT: right;" src="img/Change Key Sequence.png" alt="Configuration settings" hspace="5" vspace="5">		
		<ul>
		<li>From Control Panel...".</li>
		<ul>
			<li>Windows 7: Change keyboards or other input methods -> 'Keyboards and Languages' tab -> Change Keyboards -> 'Advanced Key Settings' -> Change Key Sequence...</li>
			<li>Windows 10: Typing -> Advanced Keyboard Settings -> Input language hot keys -> Change Key Sequence...</li>
		</ul>
		<li>Finally set "Switch Keyboard Layout" to "Not Assigned".</li>
		</ul>
	</body>
</html>