mirror of https://github.com/pyrollo/vinace.git
82 lines
2.1 KiB
Markdown
82 lines
2.1 KiB
Markdown
|
# Vinace - VINtage Apple Computer Emulator
|
||
|
|
|
||
|
|
## Requirements
|
||
|
|
|
||
|
|
Vinace needs gtkmm-2.4 and libpulse to be installed.
|
||
|
|
|
||
|
|
On Ubuntu :
|
||
|
|
```
|
||
|
|
apt install libgtkmm-2.4-dev libpulse-dev
|
||
|
|
```
|
||
|
|
|
||
|
|
## How to build
|
||
|
|
```
|
||
|
|
git clone https://github.com/pyrollo/vinace
|
||
|
|
cd vinace
|
||
|
|
cmake .
|
||
|
|
```
|
||
|
|
|
||
|
|
## Fetch ROMs
|
||
|
|
|
||
|
|
Vinace needs ROM images which are copyrighted and which can not be
|
||
|
|
distributed with Vinace.
|
||
|
|
|
||
|
|
To run vinace, ROM files have to be fetched from
|
||
|
|
[https://ftp.apple.asimov.net/emulators/rom_images](https://ftp.apple.asimov.net/emulators/rom_images).
|
||
|
|
Current version uses
|
||
|
|
[APPLE2E.ROM](https://ftp.apple.asimov.net/emulators/rom_images/apple_iie_rom.zip)
|
||
|
|
file.
|
||
|
|
|
||
|
|
```
|
||
|
|
cd roms
|
||
|
|
wget ftp://ftp.apple.asimov.net/pub/apple_II/emulators/rom_images/apple_iie_rom.zip
|
||
|
|
unzip apple_iie_rom.zip
|
||
|
|
cd ..
|
||
|
|
```
|
||
|
|
|
||
|
|
## Play
|
||
|
|
|
||
|
|
From ``vinace`` directory, launch:
|
||
|
|
|
||
|
|
```
|
||
|
|
bin/vinace
|
||
|
|
```
|
||
|
|
|
||
|
|
## Inside Vinace
|
||
|
|
|
||
|
|
Now you should see a color screen and two disk drives. If ROM file is
|
||
|
|
present, screen should display "Apple //e" and floppy drive #1 should
|
||
|
|
be on.
|
||
|
|
|
||
|
|
Emulated Apple //e is waiting for you to insert a disk. To do it so,
|
||
|
|
drag and drop a .DSK file onto drive 1. Such files could be found at
|
||
|
|
[https://ftp.apple.asimov.net/images/](https://ftp.apple.asimov.net/images/).
|
||
|
|
|
||
|
|
Issue a Ctrl-Break or Ctrl-Pause if you want to try Applesoft basic
|
||
|
|
instead of inserting a disk.
|
||
|
|
|
||
|
|
### Keyboard
|
||
|
|
|
||
|
|
Use the keyboard to type text in. The special keys are :
|
||
|
|
|
||
|
|
On your machine | On the emulated Apple
|
||
|
|
--------------------------|----------------------------------
|
||
|
|
Ctrl-Break or Ctrl-Pause | Ctrl-Reset
|
||
|
|
Left Alt | Open Apple (joystick button 0)
|
||
|
|
Right Alt (or AltGr) | Closed Apple (joystick button 1)
|
||
|
|
|
||
|
|
|
||
|
|
### Floppy disks
|
||
|
|
|
||
|
|
Vinace accept any file but works only with .dsk and .do files (DOS
|
||
|
|
ordered disk images). To insert a disk, just drag the file onto the disk
|
||
|
|
drive 1. The lid should automatically close. Then restart with a
|
||
|
|
Alt-Ctrl-Break.
|
||
|
|
|
||
|
|
Disk drives are emulated with the same original speed which is quite...
|
||
|
|
slow.
|
||
|
|
|
||
|
|
You can look if something is happening on the terminal output (look
|
||
|
|
after drive's head position changing, which means that the program
|
||
|
|
is still alive).
|