mirror of https://github.com/pyrollo/vinace.git
Convert README to markdown and update it
This commit is contained in:
Pierre-Yves Rollo
parent
8a34ca6321
commit
7b83622d20
63
README
63
README
|
|
@ -1,63 +0,0 @@
|
|||
Vinace - VINtage Apple Computer Emulator
|
||||
========================================
|
||||
|
||||
Requirements
|
||||
------------
|
||||
|
||||
Vinace needs gtkmm-2.4 and libpulse0 packages to be installed.
|
||||
|
||||
Vinace needs ROM image which are copyrighted and which can not be distributed with Vinace.
|
||||
|
||||
Current version uses file named APPLE2E.ROM contained in zip file located at :
|
||||
ftp://ftp.apple.asimov.net/pub/apple_II/emulators/rom_images/apple_iie_rom.zip
|
||||
|
||||
How to test Vinace ?
|
||||
--------------------
|
||||
|
||||
If you want to build it from source :
|
||||
|
||||
1 - Download the source
|
||||
2 - Enter trunk directory
|
||||
3 - ./configure
|
||||
4 - make
|
||||
5 - Enter src/gui directory
|
||||
6 - Copy ROM file APPLE2E.ROM into this directory
|
||||
7 - ./vinace
|
||||
|
||||
If you don't want to build it from source but still want to try it :
|
||||
|
||||
1 - Download the binary
|
||||
2 - tar xvf vinace.gz
|
||||
3 - Enter the vinace directory
|
||||
4 - Copy ROM file APPLE2E.ROM into this directory
|
||||
5 - ./vinace
|
||||
|
||||
If you don't want to try it, get back to the dull 64 bits world.
|
||||
|
||||
Inside Vinace
|
||||
-------------
|
||||
|
||||
Now you should see a color screen and two disk drives.
|
||||
|
||||
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 Closed Apple (joystick button 1)
|
||||
|
||||
You can issue a first Ctrl-Break to try Applesoft basic. And of course, a
|
||||
Alt-Ctrl-Break will restart the computer (the Apple, not your actual computer).
|
||||
|
||||
If you want to use floppy disks, you can go to
|
||||
ftp://ftp.apple.asimov.net/pub/apple_II/images
|
||||
|
||||
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).
|
||||
|
|
@ -0,0 +1,81 @@
|
|||
# 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).
|
||||
Loading…
Reference in New Issue