2006-10-22 15:44:38 +00:00
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
< html >
< head >
2017-12-18 23:46:48 +00:00
< title > Command line< / title >
2006-10-22 15:44:38 +00:00
< 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)" > Command line< / h2 >
< hr size = "4" >
< p style = "FONT-WEIGHT: bold" > AppleWin can be driven from the command line as
follows:
< / p >
2020-02-10 02:18:31 +00:00
-conf < pathname> < br >
2020-11-02 20:50:53 +00:00
Use an INI file for configuration instead of the Registry.< br >
Use this switch if you want to have multiple copies of AppleWin with different configurations, or don't want to use the Registry.< br > < br >
2020-08-17 20:49:10 +00:00
-current-dir < path> < br >
This is guaranteed to be processed after all the image loading switches (eg. -d1, -h1, etc).< br >
Use this switch if you have a mix of (eg) -d1 and -h1 loading images from different folders, and you want to guarantee the current dir.< br > < br >
2006-10-22 15:44:38 +00:00
-d1 < pathname> < br >
2019-12-20 15:23:54 +00:00
Start with a floppy disk in slot 6 drive-1 (and auto power-on the Apple II).< br >
NB. -s6d1 has the meaning same as -d1.< br > < br >
2006-10-22 15:44:38 +00:00
-d2 < pathname> < br >
2019-12-20 15:23:54 +00:00
Start with a floppy disk in slot 6 drive-2.< br >
NB. -s6d2 has the meaning same as -d2.< br > < br >
-s5d1 < pathname> < br >
2022-10-06 20:53:54 +00:00
Start with a floppy disk in slot 5 drive-1 (must be used with '-s5 diskii' or '-s5 diskii13').< br > < br >
2019-12-20 15:23:54 +00:00
-s5d2 < pathname> < br >
2022-10-06 20:53:54 +00:00
Start with a floppy disk in slot 5 drive-2 (must be used with '-s5 diskii' or '-s5 diskii13').< br > < br >
2018-04-02 11:38:05 +00:00
-h1 < pathname> < br >
Start with hard disk 1 plugged-in (and auto power-on the Apple II). NB. Hard disk controller card gets enabled.< br > < br >
-h2 < pathname> < br >
Start with hard disk 2 plugged-in. NB. Hard disk controller card gets enabled.< br > < br >
2020-10-25 18:41:22 +00:00
NB. For -d1,-d2,-s5d1,-s5d2,-h1,-h2, if pathname is "", then the disk is ejected or the harddisk is unplugged.< br > < br >
2020-04-03 19:39:07 +00:00
-model < apple2|apple2p|apple2jp|apple2e|apple2ee> < br >
Select the machine model: Apple II, Apple II+, Apple II J-Plus, Apple //e, Enhanced Apple //e.< br > < br >
2019-10-12 17:50:14 +00:00
-clock-multiplier < value> < br >
Where value is between 0.5 and 3.9, and is a base-clock multiplier, roughly mapping to 0.5MHz - 3.9MHz< br > < br >
2018-10-31 22:04:42 +00:00
-s0 < saturn|saturn64|saturn128> < br >
2018-12-08 13:29:48 +00:00
Insert a Saturn 64K or Saturn 128K card into slot 0 in the Apple II or II+ machines (or similar clone).< br >
2018-10-31 22:04:42 +00:00
Where -s0 saturn is an alias for -s0 saturn128.< br > < br >
2018-11-04 15:39:14 +00:00
-s0 < languagecard|lc> < br >
2018-12-08 13:29:48 +00:00
Insert an Apple 16K Language Card into slot 0 in the original Apple II and use the F8 auto-start ROM.< br >
2018-11-04 15:39:14 +00:00
NB. The Apple II+ already defaults to having a Language Card, so this switch is not required.< br > < br >
2019-10-11 21:42:06 +00:00
-s1 empty< br >
2022-03-18 22:04:34 +00:00
Remove the parallel printer card from slot 1.< br > < br >
-s1 parallel< br >
Insert a parallel printer card into slot 1.< br > < br >
2019-10-11 21:42:06 +00:00
-s2 empty< br >
Remove the SSC card from slot 2.< br > < br >
2022-06-26 18:06:39 +00:00
-s2 ssc< br >
Insert a SSC into slot 2.< br > < br >
2019-10-11 21:42:06 +00:00
-s3 empty< br >
2022-06-26 18:06:39 +00:00
Remove any card from slot 3.< br > < br >
2021-12-19 14:17:51 +00:00
-s3 vidhd< br >
Insert a VidHD card into slot 3.< br > < br >
2019-12-20 15:23:54 +00:00
-s5 diskii< br >
2022-10-06 20:53:54 +00:00
-s6 diskii< br >
Insert a Disk II controller card into slot 5 or 6.< br > < br >
-s5 diskii13< br >
-s6 diskii13< br >
Insert a Disk II controller card (with 13-sector firmware) into slot 5 or 6.< br > < br >
2019-10-11 21:42:06 +00:00
-s6 empty< br >
Remove the Disk II controller card from slot 6.< br > < br >
2018-04-05 20:33:36 +00:00
-s7 empty< br >
Remove the hard disk controller card from slot 7.< br >
Useful to allow a floppy disk to boot from slot 6, drive 1. Use in combination with -d1.< br > < br >
2019-10-12 17:50:14 +00:00
-s7-empty-on-exit< br >
Remove the hard disk controller card from slot 7 on AppleWin exit.< br > < br >
2021-04-17 17:15:33 +00:00
-d1-disconnected, -d2-disconnected< br >
Disconnect drive-1 and/or drive-2 from the Disk II controller card in slot 6.< br > < br >
2020-06-10 20:45:19 +00:00
-no-nsc< br >
Remove the No-Slot clock (NSC).< br > < br >
2018-04-05 20:33:36 +00:00
-r < number of pages> < br >
2018-12-08 13:29:48 +00:00
Emulate a RamWorks III card with 1 to 127 pages (each page is 64K, giving a max of 8MB) in the auxiliary slot in an Apple //e machine.< br > < br >
2018-04-05 20:33:36 +00:00
-load-state < savestate> < br >
2020-05-26 20:37:56 +00:00
Load a save-state file (and auto power-on the Apple II).< br >
2020-10-25 17:14:23 +00:00
NB. This takes precedent over the -d1, -d2, -s#d#, -h1, -h2, s0-7, -model and -r switches.< br > < br >
2020-12-12 18:23:23 +00:00
-f or -full-screen< br >
Start in full-screen mode.< br > < br >
-no-full-screen< br >
Start in Windowed mode (default).< br > < br >
2017-10-06 20:17:31 +00:00
-fs-height=< best|nnnn> < br >
2021-05-31 15:28:33 +00:00
Use to select a better resolution for full-screen mode.< br >
2017-10-06 20:17:31 +00:00
< ul >
< li > best: picks the highest resolution where the height is an integer multiple of (192*2)< / li >
< li > nnnn: select a specific resolution with height=nnnn pixels< / li >
< / ul >
2022-07-02 10:33:29 +00:00
-fs-width=< nnnn> < br >
Use in conjunction with -fs-height to select a better aspect ratio for full-screen mode.< br >
EG. for 4:3 aspect ratio on monitors that support it: -no-full-screen -fs-width=1600 -fs-height=1200< br > < br >
2021-05-31 15:28:33 +00:00
NB. Combine with < em > -no-full-screen< / em > to start in Windowed mode. Without this it'll just default to full-screen.< br >
NB. When switching to Windowed mode the default desktop resolution will be restored, and when switching back to full-screen mode this better resolution will again be used.< br > < br >
2020-03-26 23:07:11 +00:00
-rom < file> < br >
Use custom 12K ROM (at $D000) for Apple II machine, or 16K ROM (at $C000) for Apple //e machine.< br > < br >
2018-12-08 13:29:48 +00:00
-f8rom < file> < br >
2020-03-26 23:07:11 +00:00
Use custom 2K ROM for any Apple II machine at [$F800..$FFFF]. < file> must be 2048 bytes long.< br > < br >
2018-11-17 17:02:09 +00:00
-videorom < file> < br >
2018-12-08 13:29:48 +00:00
Use an alternate custom 2K video ROM for Apple II or II+ machines (but not clones).< br >
2019-01-10 21:49:24 +00:00
Use an alternate European or custom 4K, 8K or 16K (top 8K only) video ROM for the original or Enhanced //e (but not clones).< br > < br >
2008-09-08 22:30:41 +00:00
-printscreen< br >
2009-01-17 15:10:00 +00:00
Enable the dialog box to display the last file saved to< br > < br >
2017-10-06 20:17:31 +00:00
-no-printscreen-key< br >
Prevent the PrintScreen key from being registered< br > < br >
2018-06-16 09:24:05 +00:00
-no-hook-system-key< br >
2018-08-06 20:40:20 +00:00
Prevent certain system key combinations from being hooked (to prevent the emulator from trapping ALT+ESC, ALT+SPACE, ALT+TAB and CTRL+ESC). This means that the equivalent Open Apple+< key> combinations won't work within the emulator.< br >
NB. This switch takes precedence over -hook-alt-tab and -hook-altgr-control.< br > < br >
2018-11-17 17:02:09 +00:00
-no-hook-alt< br >
Prevent the left and right ALT keys from being hooked (eg. to prevent emulation of Open/Solid Apple keys via the ALT keys).< br > < br >
2018-08-06 20:40:20 +00:00
-hook-alt-tab< br >
By default the emulator doesn't hook ALT+TAB. Use this to allow Open Apple+TAB to be readable by the emulated machine.< br > < br >
-hook-altgr-control< br >
2019-03-03 14:32:19 +00:00
By default the emulator doesn't suppress AltGr's (Right Alt's) fake LEFT CONTROL. Use this to suppress this fake LEFT CONTROL to allow Solid Apple+CTRL+< key> to be readable by the emulated machine.< br >
NB. Suppressing this fake LEFT CONTROL seems to prevent international keyboards from being able to type certain keys.< br > < br >
-altgr-sends-wmchar< br >
Use this switch to allow Solid Apple (AltGr) to be used in combination with regular keys.< br >
When AltGr is pressed, Windows only sends a WM_CHAR message for (eg) international key codes; and so by default the emulator doesn't explicitly send a WM_CHAR message for regular keys when AltGr is being pressed.< br >
NB. Using this switch may prevent international keyboards from being able to type certain keys.< br > < br >
2020-01-18 17:02:01 +00:00
-left-alt-control-buttons< br >
2020-02-21 15:33:23 +00:00
Use Left Control & Left Alt for Open Apple & Solid Apple keys respectively.< br >
Caveat: Left Control + F2 will do the //e Ctrl+Open Apple+RESET (as Left Control is now both Ctrl and Open Apple!). A workaround is just to use the Right Control key.< br > < br >
2020-01-18 17:02:01 +00:00
-right-alt-control-buttons< br >
2020-02-21 15:33:23 +00:00
Use Right Alt (AltGr) & Right Control for Open Apple & Solid Apple keys respectively.< br >
Caveat: Right Control + F2 will do the //e self test (as Right Control is now both Ctrl and Solid Apple!). A workaround is just to use the Left Control key.< br > < br >
2020-01-18 17:02:01 +00:00
-swap-buttons< br >
2021-04-17 17:15:33 +00:00
Swap buttons 0 and 1 for all input devices.< br >
2021-04-10 18:09:36 +00:00
EG. the Windows keys used for Open Apple & Solid Apple keys, and the current device being used to emulate a joystick (keyboard, real joystick or mouse)< br > < br >
2020-01-18 17:02:01 +00:00
2009-02-01 20:32:05 +00:00
-use-real-printer< br >
2009-04-21 21:57:48 +00:00
Enables Advanced configuration control to allow dumping to a real printer< br > < br >
-noreg< br >
2020-02-21 15:33:23 +00:00
Disable registration of file extensions (.do/.dsk/.nib/.po/.woz)< br > < br >
2014-08-28 21:08:15 +00:00
-memclear < n> < br >
Where n is [0..7]:
< ul >
< li > 0 Initialize memory to zero< / li >
< li > 1 Initialize memory to random values< / li >
< li > 2 Initialize memory to 4 byte pattern: FF FF 00 00< / li >
< li > 3 Initialize memory to even pages FF, odd pages 00< / li >
< li > 4 Initialize memory to first half page 00, last half page FF< / li >
< li > 5 Initialize memory to first half page FF, last half page 00< / li >
< li > 6 Initialize memory to byte offset of that page
(current memory address low byte)
i.e. 00:00 01 02 03 ... for page $20< / li >
< li > 7 Initialize memory to page address
(current memory address high byte)
i.e. 00:20 20 20 20 ... for page $20< / li >
< / ul >
2017-04-25 21:31:04 +00:00
-modem< br >
2018-04-22 14:22:05 +00:00
Shorthand for passing -dcd< br >
2017-12-18 23:46:48 +00:00
Use with GBBS Pro (or any other BBS package). See the < a href = "http://www.callapple.org/documentation/books/gbbs-pro-2-2/" > GBBS Pro 2.2< / a > book from Call-A.P.P.L.E.
< br > < br >
2017-04-25 21:31:04 +00:00
-dcd< br >
2018-04-22 14:22:05 +00:00
For the SSC's 6551's Status register's DCD bit, use this switch to force AppleWin to use the state of the MS_RLSD_ON bit from GetCommModemStatus().< br > < br >
2018-06-10 17:14:34 +00:00
-alt-enter=< toggle-full-screen|open-apple-enter> < br >
Define the behavior of Alt+Enter:
< ul >
2020-10-15 20:41:14 +00:00
< li > Either: Toggle between windowed and full screen video modes (default).< / li >
< li > Or: Allow the emulated Apple II to read the Enter key state when Alt (Open Apple key) is pressed.< / li >
2018-06-10 17:14:34 +00:00
< / ul >
2020-10-15 20:41:14 +00:00
-rgb-card-type < apple|sl7|eve|feline> < br >
< ul >
2020-11-01 17:15:16 +00:00
< li > < i > apple< / i > is Apple's Extended 80-Column Text/AppleColor Adaptor Card (default).< / li >
2020-10-15 20:41:14 +00:00
< li > < i > sl7< / i > is Video-7's RGB-SL7 card.< / li >
< ul >
2020-11-01 17:15:16 +00:00
< li > NB. Both these apple/sl7 cards support an extra foreground/background hi-res mode that can be triggered by AN3 switching, resulting in corrupt color graphics! See < a href = "Troubleshooting.html" > troubleshooting< / a > .
2020-10-15 20:41:14 +00:00
< / ul >
< li > < i > eve/feline< / i > are Le Chat Mauve variants.< / li >
2022-12-11 13:28:39 +00:00
< ul >
< li > Eve is currently unsupported, so the behavior just defaults to 'apple' RGB card type.
< li > Feline differs from 'apple' card type in that it doesn't support the 160 color pixel mode (so falls back to 140 mode) and has a slightly different color palette.
< / ul >
2020-10-15 20:41:14 +00:00
< / ul >
Use in conjunction with the 'Color (RGB Card/Monitor)' video mode.< br > < br >
-rgb-card-foreground < n> < br >
-rgb-card-background < n> < br >
Where n is [0..15]. Defaults are foreground=15(White) and background=0(Black).< br >
The only supported DIPSW colors are: Black=0, Blue=6, Orange=9, Green=12, White=15< br >
2020-11-01 17:15:16 +00:00
NB. Only supported by '-rgb-card-type < apple|sl7> '.< br >
2020-10-15 20:41:14 +00:00
Use in conjunction with the 'Color (RGB Card/Monitor)' video mode.< br > < br >
2019-04-06 16:31:26 +00:00
-rgb-card-invert-bit7< br >
2020-10-15 20:41:14 +00:00
Force the RGB card to invert bit7 in MIX mode. Enables the correct rendering for Dragon Wars.< br >
Use in conjunction with the 'Color (RGB Card/Monitor)' video mode.< br > < br >
2019-07-08 20:46:52 +00:00
-50hz< br >
2019-07-09 06:49:20 +00:00
Support 50Hz(PAL) video refresh rate and PAL 1.016MHz base CPU clock.< br > < br >
2019-07-08 20:46:52 +00:00
-60hz< br >
2020-05-26 20:37:56 +00:00
Support 60Hz(NTSC) video refresh rate and NTSC 1.020MHz base CPU clock (default).< br > < br >
-power-on< br >
Force a power-on.< br >
2021-09-10 12:57:55 +00:00
Use to auto power-on when not using -d1, -h1 or -load-state.< br > < br >
-snes-max-alt-joy1 or -snes-max-alt-joy2< br >
2023-01-01 21:05:45 +00:00
Use alternate button mappings for the SNES MAX card. See < a href = "cfg-input.html" > Input Settings< / a > .< br > < br >
-snes-max-user-joy1 < file.yaml> or -snes-max-user-joy2 < file.yaml> < br >
Use a user specified button mappings file for the SNES MAX card.< br >
For some examples, see the supplied < i > controller_*.yaml< / i > files in the < i > snesmax< / i > folder.< br >
2022-04-18 09:45:13 +00:00
< br >
-wav-speaker < file.wav> < br >
Save the speaker audio to a .wav file.< br >
Warning: there's no file size limit, so it just keeps saving until AppleWin exits (~5MB per minute).< br >
< br >
Save the Mockingboard audio to a .wav file.< br >
-wav-mockingboard < file.wav> < br >
Warning: there's no file size limit, so it just keeps saving until AppleWin exits (~10MB per minute).< br >
< br >
2017-04-25 21:31:04 +00:00
< br >
2006-10-22 15:44:38 +00:00
< P style = "FONT-WEIGHT: bold" > Debug arguments:
< / P >
2017-10-29 19:55:53 +00:00
-l or -log< br >
2019-04-06 16:31:26 +00:00
Enable logging. Creates an AppleWin.log file.< br > < br >
2006-10-22 15:44:38 +00:00
-m< br >
2019-04-06 16:31:26 +00:00
Disable DirectSound support.< br > < br >
2013-12-31 23:06:58 +00:00
-no-printscreen-dlg< br >
2021-04-17 17:15:33 +00:00
Suppress the warning message-box if AppleWin fails to capture the PrintScreen key.< br >
NB. There's now a "Don't show this message again" option on this message-box.
< br > < br >
2019-04-06 16:31:26 +00:00
-screenshot-and-exit< br >
For testing. Use in combination with -load-state.< br > < br >
2006-10-22 15:44:38 +00:00
< / body >
< / html >
