AppleWin/help/cfg-input.html
TomCh 685b93f387
Add 4Play & SNES MAX card support (#946, #972, PR #982)
Support these new cards in slots 3, 4 or 5; based on code from Lukazi.
- extend Configuration's Input prop sheet page.
- add save/load snapshot for both cards.
- add command line switch for alt controller type (for SNES MAX card).
Change to using Registry's 'Configuration\Slot 3' for slot 3 cards (Uthernet, 4Play & SNES MAX).
Update help doc.
2021-09-10 13:57:55 +01:00

99 lines
5.1 KiB
HTML

<!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: 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
the emulated Apple //e system.<br>
<ul>
<li>Joystick 1/2: Choose the emulation method for joysticks 1 and 2.</li>
<li>X/Y-trim: &nbsp;These controls&nbsp;add a trim value to the
joystick X/Y offsets when the joystick is centered. Normally central
position is X=127, Y=127 so this adds the trim value for PC joysticks
&amp; keyboard (centering). If you are using an analog PC joystick,
then you should leave these values at 0.</li>
<li>Allow cursor keys to be read from keyboard: Applicable only in 'Keyboard (cursors)' mode.</li>
<li>NB.</li>
<ul>
<li>Be aware that 'cursor-up' = CTRL+K, and 'cursor-down' = CTRL+J.</li>
<li>When cursor keys are used for joystick emulation <strong>and</strong> are allowed to be read from the keyboard, then some games won't work correctly (eg. Lode Runner).</li>
<li>When cursor keys are blocked from being read from the keyboard, then simple command-line cursor editing in AppleSoft won't work.</li>
</ul>
<li>Swap 0/1: Swap buttons 0 and 1 for all input devices.</li>
<li>Auto-fire (all 3 buttons): For each button pressed, the button's state will be toggled when read.</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 80-column cards 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 href="https://lukazi.blogspot.com/2016/04/apple-ii-4play-joystick-card.html">4Play card</a> and <a 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 80-column cards in the Apple //e's AUX slot. NB. This card is small, so no slot riser card is required.<br>
See Lukazi's <a 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>
</body>
</html>