Apple-2-Tools/gsplus
1
0
Fork 0
mirror of https://github.com/digarok/gsplus.git synced 2024-11-30 16:50:45 +00:00
Code Issues Projects Releases Wiki Activity

doc updates for 0.13 release

Browse Source
This commit is contained in:
Dagen Brock 2017-01-22 16:27:18 -06:00
parent bbc679abb8
commit 35daae6815
3 changed files with 60 additions and 28 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
doc/README.txt
View File

@ -1,21 +1,47 @@
Getting started Getting started
=============== ===============
1. Download the emulator package and put it in a folder 1. Download the emulator package from https://apple2.gs/plus and put it in a folder.
Yes, you can drag it into your Applications on a Mac, but be aware that it is still
meant to be launched from a command line. If you put it in Applications, you should
be able to run it with the terminal command:
/Applications/GSplus.app/Contents/MacOS/gsplus
2. Download the Apple IIgs Firmware ROMs, for either a ROM01 or ROM03 machine. 2. Download the Apple IIgs Firmware ROMs, for either a ROM01 or ROM03 machine.
(If you have a real IIgs, there are ways to save it from your machine too.) (If you have a real IIgs, there are ways to save it from your machine too.)
Try: ftp://ftp.apple.asimov.net/pub/apple_II/emulators/rom_images/ Try: ftp://ftp.apple.asimov.net/pub/apple_II/emulators/rom_images/
3. Download some Apple IIgs software. a. Put the ROM image in the same folder where you run the emulator from.
I recommend the excellent Apple IIgs dedicated site, It will search for: "ROM", "ROM.01", "ROM.03"
If your ROM image is named differently, launch the program from the command line
and hit F4 to go to the config menu to choose your ROM location
3. Get some Apple IIgs software.
I recommend the excellent Apple IIgs dedicated site:
http://www.whatisthe2gs.apple2.org.za/ http://www.whatisthe2gs.apple2.org.za/
If you have a real IIgs, you can transfer your disks using ADTPro If you have a real IIgs, you can transfer your disks using ADTPro
http://adtpro.sourceforge.net/ http://adtpro.sourceforge.net/
4. Edit your config: 4. Edit your config:
You can manually edit the config.txt file You can manually edit the config.txt file, or while the emulator is running hit F4
.. or while the emulator is running... hit F4 to enter config menu. to enter config menu.
Set up the ROM to point to your IIgs ROM file from step 2.
Set it to point to your IIgs ROM file from step 2 if not already configured.
Set up the slots to point to disks from step 3. Set up the slots to point to disks from step 3.
5. Boot the Apple IIgs by running the emulator 5. Boot the Apple IIgs by running the emulator
Windows: gsplus32.exe Windows: gsplus32.exe
Mac/Ubuntu: ./gsplus Mac/Ubuntu: ./gsplus
Mac (if in Apps) /Applications/GSplus.app/Contents/MacOS/gsplus
If the config file can’t be found, it will try to create a config.txt file for you,
with all of the defaults.
Note: You can also specify a config file. This is very useful as you can have specific
disks/setting pre-set in a config file and launch directly into your favorite game with
that config. They can be named anything you want, though the officially recognized
extensions are .txt and .gsp.
Examples:
Windows: gsplus32.exe -config arkanoid.gsp
Mac/Ubuntu: ./gsplus -config choplifter_config.txt

BIN
doc/gsplusmanual.pdf
View File

Binary file not shown.

18
doc/gsplusmanual.txt
View File

@ -19,23 +19,29 @@ The first steps were a release of a new SDL2 driver. SDL or "Simple DirectMedia
Part of this effort has also led to the development of an automated build and packaging pipeline using Gitlab CI. This helps our team of one continue to develop on primarily a single platform, while still ensuring that it works across many operating systems Part of this effort has also led to the development of an automated build and packaging pipeline using Gitlab CI. This helps our team of one continue to develop on primarily a single platform, while still ensuring that it works across many operating systems
Currently, the main supported platforms are Linux, OSX and Windows. Currently, the main supported platforms are Linux, OSX and Windows.
Getting started Getting started
1. Download the emulator package from https://apple2.gs/plus and put it in a folder 1. Download the emulator package from https://apple2.gs/plus and put it in a folder.
2. Download the Apple IIgs Firmware ROMs, for either a ROM01 or ROM03 machine. 2. Download the Apple IIgs Firmware ROMs, for either a ROM01 or ROM03 machine.
(If you have a real IIgs, there are ways to save it from your machine too.) (If you have a real IIgs, there are ways to save it from your machine too.)
Try: ftp://ftp.apple.asimov.net/pub/apple_II/emulators/rom_images/ Try: ftp://ftp.apple.asimov.net/pub/apple_II/emulators/rom_images/
3. Download some Apple IIgs software. 1. Put the ROM image in the same folder where you run the emulator from.
It will search for: "ROM", "ROM.01", "ROM.03"
If your ROM image is named differently, launch the program from the command line and hit F4 to go to the config menu to choose your ROM location
1. Download some Apple IIgs software.
I recommend the excellent Apple IIgs dedicated site: I recommend the excellent Apple IIgs dedicated site:
http://www.whatisthe2gs.apple2.org.za/ http://www.whatisthe2gs.apple2.org.za/
If you have a real IIgs, you can transfer your disks using ADTPro If you have a real IIgs, you can transfer your disks using ADTPro
http://adtpro.sourceforge.net/ http://adtpro.sourceforge.net/
4. Edit your config: 2. Edit your config:
You can manually edit the config.txt file You can manually edit the config.txt file
.. or while the emulator is running… hit F4 to enter config menu. .. or while the emulator is running… hit F4 to enter config menu.
Set up the ROM to point to your IIgs ROM file from step 2. Set it to point to your IIgs ROM file from step 2 if not already configured.
Set up the slots to point to disks from step 3. Set up the slots to point to disks from step 3.
5. Boot the Apple IIgs by running the emulator 3. Boot the Apple IIgs by running the emulator
Windows: gsplus32.exe Windows: gsplus32.exe
Mac/Ubuntu: ./gsplus Mac*/Ubuntu: ./gsplus
* Yes, you can drag it into your Applications folder on a Mac, but be aware that it is still meant to be launched from a command line. If you put it in Applications, you should be able to run it with the terminal command:
/Applications/GSplus.app/Contents/MacOS/gsplus
If the config file can’t be found, it will try to create a config.txt file for you, with all of the defaults. If the config file can’t be found, it will try to create a config.txt file for you, with all of the defaults.
1. Note: You can also specify a config file. This is very useful as you can have specific disks/setting pre-set in a config file and launch directly into your favorite game with that config. They can be named anything you want, though the officially recognized extensions are .txt and .gsp. 1. Note: You can also specify a config file. This is very useful as you can have specific disks/setting pre-set in a config file and launch directly into your favorite game with that config. They can be named anything you want, though the officially recognized extensions are .txt and .gsp.