========================================
  ORIC DEMO - VIPORIC Prod version 0.1
========================================
      Release date: May 17 2014
             Party: VIP 2014
   My first real ORIC demo (with asm)
       Author: mmu_man (TripleA)
========================================

How to run it:
--------------
This is really easy if you are running one of Windows versions since a PC
emulator is included. If you use GNU/Linux, Haiku or whatever else, you will 
have to find an emulator for your operating system, see below for Oricutron.

For windows users:

1) First, you need to be sure that the files are in one single folder called
"30" that is located at the root of the "C:" drive. If it's not the
case, it will not run. This version of the emulator is stripped down to a
minimum, if you want to install it somewhere else, you'll have to change the
path references in the "euphoric.ini" and "r.bat" files.

2) Run the "C:\VIPORIC\R.BAT" file. 
This will run the emulator, press any key after the detection of devices,
and look at the emulator boot on the TAP file.

3) Just look and appreciate. At the end, the demo exits to the BASIC prompt, 
so just press F10 to quit the emulator.


Special note for Windows NT/2000 users !

Since Euphoric is a DOS emulator, it has some troubles with Windows NT kernel
because the sound card detection is not working very well. Anyway, there are
two solutions in your case:

1) Instead of running "R.BAT" use "NOSOUND.BAT". You would miss the funky beat though

2) Install VDMS. It's a kind of "sound blaster emulator" specially made to
solve this kind of trouble. Simply download and install the last version of
VDMS (here: https://sourceforge.net/projects/vdmsound/). 
After the installation, you will have a new option in the right click 
contextual menu. So, click on "R.BAT", and choose "RUN WITH VDMS". And it's
magic, this will create a virtual sound blaster, euphoric will be happy,
and so you will be able to watch this demo with music :) Pump up the volume !

Special note for Windows 7 users !

On Windows7, Euphoric does not run properly, at least on the default installation.
An alternative emulator is included called Oricutron.

1) Run "oricutron.bat" to launch it.
It should run regardless of the location of the folder.
Or use "fullscreen.bat" to get the full screen...

2) Just look and appreciate. At the end, the demo exits to the BASIC prompt, 
so just close the window (Alt-F4) to quit the emulator.



For GNU/Linux, OSX and other OSes users:

You should be able to compile Oricutron from the source code available at:
http://code.google.com/p/oriculator/

1) compile and install it.

2) in a terminal, run:
oricutron -d VIP2014.tap


For Haiku users:

Oricutron is available in Haiku Ports.
1) To compile and install it, run:
haikuporter -i oricutron

2) in a Terminal, run:
oricutron -d VIP2014


Sources:
--------

Sources are available at:
http://miniserve.defence-force.org/svn/users/mmu_man/demos/oric/viporic/



Credits:
--------
mmu_man	(TripleA)
_Dbug_ (Defence Force)

To contact us:
--------------
mmu_man
	- revol@free.fr
 
