mirror of
https://github.com/digarok/gsplus.git
synced 2024-11-24 06:34:02 +00:00
doc updates for forthcoming release
This commit is contained in:
parent
03438cdb39
commit
f13461190a
@ -130,7 +130,7 @@ package-win32:
|
|||||||
- cp /bin/cygstdc++-6.dll .
|
- cp /bin/cygstdc++-6.dll .
|
||||||
- cp /bin/cygwin1.dll .
|
- cp /bin/cygwin1.dll .
|
||||||
- cp /bin/cygfreetype-6.dll .
|
- cp /bin/cygfreetype-6.dll .
|
||||||
|
|
||||||
artifacts:
|
artifacts:
|
||||||
paths:
|
paths:
|
||||||
- gsplus32.exe
|
- gsplus32.exe
|
||||||
@ -142,7 +142,7 @@ package-win32:
|
|||||||
- cyggcc_s-1.dll
|
- cyggcc_s-1.dll
|
||||||
- cygstdc++-6.dll
|
- cygstdc++-6.dll
|
||||||
- cygwin1.dll
|
- cygwin1.dll
|
||||||
- cygfreetype-6.dll
|
- cygfreetype-6.dll
|
||||||
|
|
||||||
build-win-sdl:
|
build-win-sdl:
|
||||||
tags:
|
tags:
|
||||||
@ -171,7 +171,8 @@ package-win-sdl:
|
|||||||
- cp /bin/cygfreetype-6.dll .
|
- cp /bin/cygfreetype-6.dll .
|
||||||
- cp /bin/cygbz2-1.dll .
|
- cp /bin/cygbz2-1.dll .
|
||||||
- cp /bin/cygpng16-16.dll .
|
- cp /bin/cygpng16-16.dll .
|
||||||
|
- cp /bin/cygz.dll .
|
||||||
|
|
||||||
artifacts:
|
artifacts:
|
||||||
paths:
|
paths:
|
||||||
- gsplus.exe
|
- gsplus.exe
|
||||||
@ -183,6 +184,7 @@ package-win-sdl:
|
|||||||
- cyggcc_s-1.dll
|
- cyggcc_s-1.dll
|
||||||
- cygstdc++-6.dll
|
- cygstdc++-6.dll
|
||||||
- cygwin1.dll
|
- cygwin1.dll
|
||||||
- cygfreetype-6.dll
|
- cygfreetype-6.dll
|
||||||
- cygbz2-1.dll
|
- cygbz2-1.dll
|
||||||
- cygpng16-16.dll
|
- cygpng16-16.dll
|
||||||
|
- cygz.dll
|
||||||
|
Binary file not shown.
@ -1,8 +1,9 @@
|
|||||||
gsp_icon_512.png
|
doc/gsplusmanual.pdfgsp_icon_512.png
|
||||||
|
|
||||||
GSplus
|
GSplus
|
||||||
Modern cross-platform Apple IIgs emulator and tools based on KEGS & GSPort
|
Modern cross-platform Apple IIgs emulator and tools based on KEGS & GSPort
|
||||||
Manual Versions:
|
Manual Versions:
|
||||||
|
Beta Release: 2017-01-21
|
||||||
Alpha Release: 2016-11-02
|
Alpha Release: 2016-11-02
|
||||||
Alpha Draft: 2016-10-27
|
Alpha Draft: 2016-10-27
|
||||||
Initial Draft: 2016-05-01
|
Initial Draft: 2016-05-01
|
||||||
@ -36,26 +37,29 @@ ________________
|
|||||||
|
|
||||||
Emulator Hot-Keys
|
Emulator Hot-Keys
|
||||||
There are several keys used to interact with the emulator while it is running. Here’s a quick list of the main hot-keys and what they do.
|
There are several keys used to interact with the emulator while it is running. Here’s a quick list of the main hot-keys and what they do.
|
||||||
F4 - Configuration menu
|
F4 - configuration menu - set lots of options here!
|
||||||
F5 - Paste from host OS into emulator
|
F5 - paste from host OS into emulator
|
||||||
Shift-F5 - Screenshot
|
F6 - toggle system speed (1, 2.8, 8, ∞ MHz )
|
||||||
F6 - Toggle System Speed (1, 2.8, 8, ∞ MHz )
|
F7 - toggle fast disk emulation
|
||||||
F7 - Toggle Fast Disk Emulation
|
F9 - invert paddles
|
||||||
F9 - Invert Paddles
|
F10 - toggle a2vid_palette (?)
|
||||||
F10 - Toggle a2vid_palette (?)
|
F11 - toggle fullscreen mode *
|
||||||
F11 - Toggle Fullscreen Mode
|
F12 - hit RESET (e.g. - to do “Ctrl-Reset” on an Apple II, you hit “Ctrl-F12”)
|
||||||
F12 - RESET Key (so to hit “Ctrl-Reset” on an Apple II, you hit “Ctrl-F12”)
|
Shift-F5 - take a screenshot *
|
||||||
|
Shift-F10 - toggle status line *
|
||||||
|
Shift-F11 - toggle simulated scanlines *
|
||||||
|
* not available on all platforms
|
||||||
Other Input/Output
|
Other Input/Output
|
||||||
1. Mouse and keyboard should automatically work
|
1. Mouse and keyboard should automatically work
|
||||||
2. Joystick with SDL2 driver is known to be working. It simply uses the “first” joystick and the first analog pad on that stick plus the first two buttons. The axes and buttons are not yet configurable. Better info forthcoming.
|
2. Joystick with SDL2 driver is known to be working. It simply uses the “first” joystick and the first analog pad on that stick plus the first two buttons. The axes and buttons are not yet configurable. Better info forthcoming.
|
||||||
3. There are drivers for serial controller, ImageWriter (II?) printer, and networking. I may have broken some of this functionality to get builds working. I’m not currently familiar with the state of these drivers or their usage. More info will be added as I take time to research more of the modules.
|
3. There are drivers for serial controller, ImageWriter (II?) printer, and networking. I may have broken some of this functionality to get builds working. I’m not currently familiar with the state of these drivers or their usage. More info will be added as I take time to research more of the modules.
|
||||||
|
4. You can also drag-and-drop disk images onto the emulator window and it will try to automount the disk! (SDL versions)
|
||||||
Configuration Menu
|
Configuration Menu
|
||||||
Configuration options are loaded from, and saved to, a configuration text file. The default configuration file is config.txt. If you are just starting out, it’s recommended to use the configuration menu versus editing the file yourself.
|
Configuration options are loaded from, and saved to, a configuration text file. The default configuration file is config.txt. If you are just starting out, it’s recommended to use the configuration menu versus editing the file yourself.
|
||||||
Enter the configuration menu at any time while running GSplus by hitting <F4>.
|
Enter the configuration menu at any time while running GSplus by hitting <F4>.
|
||||||
Screen Shot 2016-05-01 at 9.10.00 AM.png
|
Screen Shot 2016-05-01 at 9.10.00 AM.png
|
||||||
|
|
||||||
Most importantly, you can use the Disk Configuration menu option to “mount” and “eject” disks.
|
Most importantly, you can use the Disk Configuration menu option to “mount” and “eject” disks. There is also
|
||||||
Command-line Options
|
Command-line Options
|
||||||
This is from source, some are experimental and not all may be built on your system.
|
This is from source, some are experimental and not all may be built on your system.
|
||||||
-badrd Halt on bad reads
|
-badrd Halt on bad reads
|
||||||
@ -81,13 +85,11 @@ This is from source, some are experimental and not all may be built on your syst
|
|||||||
-config value Set config file to value
|
-config value Set config file to value
|
||||||
-debugport value Set debugport to value
|
-debugport value Set debugport to value
|
||||||
-ssdir value Set screenshot save directory to value
|
-ssdir value Set screenshot save directory to value
|
||||||
|
-scanline Enable scanline simulator
|
||||||
|
-noscanline Disable scanline simulator (default)
|
||||||
Note: The final argument, if not a flag, will be tried as a mountable device.
|
Note: The final argument, if not a flag, will be tried as a mountable device.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Debugger Commands - BROKEN!!!
|
Debugger Commands - BROKEN!!!
|
||||||
Sorry, the debugger is currently broken due to a change in debugging frameworks.
|
Sorry, the debugger is currently broken due to a change in debugging frameworks.
|
||||||
The documentation below is accurate, but does not currently work.
|
The documentation below is accurate, but does not currently work.
|
||||||
@ -96,8 +98,6 @@ GSplus CLI Debugger help (courtesy Fredric Devernay)
|
|||||||
General command syntax: [bank]/[address][command]
|
General command syntax: [bank]/[address][command]
|
||||||
e.g. 'e1/0010B' to set a breakpoint at the interrupt jump pt
|
e.g. 'e1/0010B' to set a breakpoint at the interrupt jump pt
|
||||||
Enter all addresses using lower-case. As with the IIgs monitor, you can omit the bank number after having set it: 'e1/0010B' followed by '14B' will set breakpoints at e1/0010 and e1/0014
|
Enter all addresses using lower-case. As with the IIgs monitor, you can omit the bank number after having set it: 'e1/0010B' followed by '14B' will set breakpoints at e1/0010 and e1/0014
|
||||||
|
|
||||||
|
|
||||||
g Go
|
g Go
|
||||||
[bank]/[addr]g Go from [bank]/[address]
|
[bank]/[addr]g Go from [bank]/[address]
|
||||||
s Step one instruction
|
s Step one instruction
|
||||||
@ -136,4 +136,24 @@ Project Info
|
|||||||
Developers inquire within :P
|
Developers inquire within :P
|
||||||
Main page and full source code repository: https://github.com/digarok/gsplus
|
Main page and full source code repository: https://github.com/digarok/gsplus
|
||||||
This project has a homepage at http://apple2.gs/plus/
|
This project has a homepage at http://apple2.gs/plus/
|
||||||
The homepage hosts the latest build for a variety of OSes.
|
The homepage hosts the latest build for a variety of OSes.
|
||||||
|
|
||||||
|
|
||||||
|
Release Changelog
|
||||||
|
Version 0.13 - Jan. 22 2017
|
||||||
|
Scanline simulator
|
||||||
|
Drag-and-drop disk images and it will try to automount
|
||||||
|
Fixes and improvements to logging
|
||||||
|
Win32 icon parity with other versions
|
||||||
|
Experimental host FST support
|
||||||
|
Various bug fixes
|
||||||
|
|
||||||
|
|
||||||
|
Version 0.12s - Nov. 12, 2016
|
||||||
|
First official alpha release with packages
|
||||||
|
“S” in version is because it introduces new Socket Debugger, large effort
|
||||||
|
|
||||||
|
|
||||||
|
Version 0.11 - 2015 - 2016
|
||||||
|
Not publicly released
|
||||||
|
Features first major contribution - SDL2 driver supporting displays, sound and joysticks
|
Loading…
Reference in New Issue
Block a user