              Artifex - The Commodore Plus/4 Emulator
              ---------------------------------------
                           Version: 0.29

                   Programmed by: Zsolt Prievara
              Web design and images: Mihaly Saranszki

                    http://artifex.emuunlim.com

                Copyright 2000-2002 Redward Studios

WARNING: This program is FREEWARE, so use it only at your own risk!
There is no WARRANTY, the author shall not be liable for whatever
damage it may cause to you hardware.

1. What is Artifex?

Artifex is a Commodore Plus/4 emulator. It can emulate 
systems based around the same hardware like Commodore 16 or the non
widespread Commodore 232. Parts of this emulator is based on
the sources of my previous emulator called WinEMU. Artifex, however,
is cycle-based and designed for easy-to-use development for real
hardware and supports a very good debugger system.

2. System requirements

For full functionality Artifex requires a very fast machine and a
Windows 95/98/Me/NT/2000/XP operating system. The emulator supports
GDI graphics for compatibility, but DirectX is more recommended.
If you have a DirectX compatible sound card it can emulate the
sound capabilities of the emulated computer. For full sound
emulation you need the power of your PC, as the digital sound
reproduction takes a lot of processor time. Probably in time I will
optimize the code, so the performance will increase in every
new release.

3. Features

This is a very early beta version, so do not wait great surprises.
Here is a list about what the emulator supports:

-CPU 70%      - All documented instructions and some undocumented ones.
                Every instruction is cycle based.
-TED 20%      - All screenmodes and vertical smooth scroll.
                Raster emulation is not too perfect, it is fake raster.
                Most of the registers is "read only".
-Disk 50%     - "Read only" 1551 and PC Directory emulation.
-Tape 50%     - "Read only" tape emulation for half/full sinuswaves.
                Only MTAP, no samples!
-Sound 92%    - All features are emulated with an own sound mixer that
                can produce better quality sound than windows mixer can.
                There are still some small bugs. Digi-sound also supported.
-Joystick 10% - Very early stage, I will implement more later.
-Keyboard 99% - All features are emulated, except some side effects
                of the TED.
-Debugger 80% - Very usable but not yet finished.
-GUI 80%      - Nice GUI that I hope is user friendly enough.

4. Keyboard

Most of the keys are mapped at the same position on PC, but as you
probably know the Plus/4 has special keys that you can't find on the
PC keyboard. Of course these keys are emulated, but somewhere else.
Here are the special key mappings:

Commodore key - End
Run/Stop      - Tilde key (`)
Clear/Home    - Home
Pound         - Delete
*             - '\' key or '*' on the numeric pad

5. Known bugs

If a used feature is not supported by the DirectX driver, the program
may crash. The DirectX sound uses "WritePrimary" method for the best
performance, but it is not supported by all soundcards and operating
systems (especially on Windows NT). Later I want to support the
standard Windows Wave Mapper for sound, because it is more compatible
and supported by more systems.

6. To do

Everything... but first of all I want to improve the TED emulation
with horizontal smooth scroll and correct raster emulation. A nice
original palette and a multilanguage feature would be good.

7. Thanks to...

-Attila Grosz for his help with testing and tape emulation,
-Lando for the programs and support,
-Robert Cseh for instructions,
-Levente Harsfalvi for the Digi-table and palette,
-Crown for the documentations,
-Csabo for ideas,
and all Plus/4 fans who keep the scene alive.

8. Contact me

If you have ideas on what to improve or found a CPU bug, please
contact me!

Web:     http://artifex.emuunlim.com  
E-mail:  zsolt@emuunlim.com
         zsolt@szentes.hu
