AppleWin/help/cfg-input.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 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 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 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 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>
Added current help source files 2006-07-08 15:41:03 +00:00			`<!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>`

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 12:57:55 +00:00			`<hr size="4"><img style="width: 354px; height: 497px; float: right;" src="img/input.png" alt="Input settings" hspace="5" vspace="5">`
Added current help source files 2006-07-08 15:41:03 +00:00			`<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:  These controls 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`
			`& keyboard (centering). If you are using an analog PC joystick,`
			`then you should leave these values at 0.</li>`
Update Help. 2013-12-31 23:06:58 +00:00			`<li>Allow cursor keys to be read from keyboard: Applicable only in 'Keyboard (cursors)' mode.</li>`
			`<li>NB.</li>`
			`<ul>`
Tweaks for 1.24.0.0 release 2014-01-11 16:06:32 +00:00			`<li>Be aware that 'cursor-up' = CTRL+K, and 'cursor-down' = CTRL+J.</li>`
Update Help. 2013-12-31 23:06:58 +00:00			`<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>`
Bump version to 1.30.0.0. Update History.txt, and some updates to help doc 2021-04-17 17:15:33 +00:00			`<li>Swap 0/1: Swap buttons 0 and 1 for all input devices.</li>`
Update Help. 2013-12-31 23:06:58 +00:00			`<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>`
Update html-help files 2008-06-21 23:26:47 +00:00			`</ul>`
Added current help source files 2006-07-08 15:41:03 +00:00
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 12:57:55 +00:00			`<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.`
VidHD: Support SHR for Apple II/II+ models (#997, PR #1013) . Support aux writes for II/II+ (6502 emulation, not 65C02) . Extend VidHD save-state for II/II+ aux memory 2021-12-19 14:17:51 +00:00			`<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>`
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 12:57:55 +00:00			`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.`
VidHD: Support SHR for Apple II/II+ models (#997, PR #1013) . Support aux writes for II/II+ (6502 emulation, not 65C02) . Extend VidHD save-state for II/II+ aux memory 2021-12-19 14:17:51 +00:00			`<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>`
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 12:57:55 +00:00			`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>`
Update html-help files 2008-06-21 23:26:47 +00:00
			`<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>`
Added current help source files 2006-07-08 15:41:03 +00:00			`</ul>`


Update html-help files 2008-06-21 23:26:47 +00:00			`<strong>Mouse interface in slot 4:</strong><br>`
			`<ul>`
			`<li>Disables joystick emulation with mouse.</li>`
			`<li>Disables Mockingboard/Phasor in slot 4.</li>`
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 12:57:55 +00:00			`<li>Show cross-hairs in window's frame:</li>`
Update html-help files 2008-06-21 23:26:47 +00:00			`<ul>`
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 12:57:55 +00:00			`<li>Configure whether you want cross-hairs or not</li>`
Update html-help files 2008-06-21 23:26:47 +00:00			`</ul>`
			`<li>Restrict mouse to Apple window:</li>`
			`<ul>`
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 12:57:55 +00:00			`<li>Restricting is useful for paint applications</li>`
Update html-help files 2008-06-21 23:26:47 +00:00			`<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>`


Updated Help (.chm): . Added new page for No-Slot clock . Added info about .2mg & compression for disk image formats . Changed screenshots from XP to Win7 2012-08-12 10:04:44 +00:00			`<strong>Microsoft CP/M SoftCard interface in slot 4 or 5:</strong><br>`
Updates to the .chm help doc, including a new section on the history of Pravets clones (Just missing Michael's updates to the debugger.) 2008-09-08 22:30:41 +00:00			`<ul>`
			`<li>Emulates a CP/M card, complete with full Z80 emulation.</li>`
Updated Help (.chm): . Added new page for No-Slot clock . Added info about .2mg & compression for disk image formats . Changed screenshots from XP to Win7 2012-08-12 10:04:44 +00:00			`<li>Available when Mockingboard or Phasor isn't in slot 4 or 5.</li>`
Updates to the .chm help doc, including a new section on the history of Pravets clones (Just missing Michael's updates to the debugger.) 2008-09-08 22:30:41 +00:00			`</ul>`


Update html-help files 2008-06-21 23:26:47 +00:00			`<strong>Paste from clipboard:</strong><br>`
Added current help source files 2006-07-08 15:41:03 +00:00			`Pressing this button will allow you to paste text from the`
			`Windows' clipboard into the emulated Apple //e.<br>`

			`</body>`
			`</html>`