
WHAT IS THE BLISS APPLET
The Bliss Applet is a fully-functional Intellivision emulator in the form of 
a Java applet which enables playable Intellivision games to be embedded into 
a web page.


USING THE BLISS APPLET
If you wish to embed the Bliss Applet into a web page, you must first acquire 
the Executive ROM and GROM images.  The ROM images provided with Bliss are 
not the real Executive and GROM images, but merely contain some public domain 
bootstrap Intellivision code and character sets to allow the 4-Tris example 
to run.  If you wish to embed an ECS-enabled Intellivision game in your web 
page, you must also obtain an image of the ECS ROM.  If you wish to hear 
Intellivoice output for Intellivoice-enabled games, you must also obtain an 
image of the Intellivoice ROM.

Place the ROM images of the cartridge, Executive, and GROM along with the 
BlissApplet.jar file together in the same directory.  Then you simply need to 
insert an <applet> tag into your HTML code.  This applet tag must use the 
following form.

    <applet archive="BlissApplet.jar" code=com.bliss.applet.BlissApplet
            width=320 height=192>
        <param name="cartfile" value="{cart_filename_here}">
    </applet>


APPLET PARAMETERS
The "cartfile" parameter is required and should be the filename of the 
Intellivision game you wish to play on your web page.  The Bliss applet will 
assume some default filenames for the Executive ROM, GROM, and ECS ROM files.  
These filenames should be "exec.bin", "grom.bin", and "ecs.bin" respectively.  
If you name these files something other than those described here, then you 
must tell the Bliss applet where to locate these files using more parameters 
to the applet tag.

Since the 4-Tris example uses the public domain Executive ROM and, you'll 
notice the following parameters in the applet tag.

        <param name="execfile" value="freeexec.bin">
        <param name="gromfile" value="freegrom.bin">

Note that not all cartridges will function properly with the free Executive 
ROM and GROM images provided in the example.

Below is a complete listing of parameters that are deciphered by the Bliss 
Applet along with the description of each parameter.

    cartfile            the cartridge ROM filename; this parameter is
                         required
    execfile            the Executive ROM filename; default is
                         "exec.bin"
    gromfile           - the GROM filename; default is "grom.bin"
    ecsfile            - the ECS ROM filename; default is "ecs.bin"
    ivoicefile          the Intellivoice ROM filename; default is
                         "ivoice.bin"
    audioenabled        true or false; default is true
    audioaccuracy       low, moderate, high, or highest; default is
                         low
    audiomixingquality  high or low; default is high
    frameskip          - 0, 1, 2, 3, 4, or 5; default is 1


RESIZING THE APPLET    
You can also resize the applet to any size you wish by changing the "width" 
and "height" parameters of the applet tag itself.  However, for performance 
reasons, I highly recommend using an exact multiple of 320 for the width and 
an exact multiple of 192 for the height.  For example, 640x384 works well for 
a larger applet size.


CHANGING THE CARTRIDGE
After the applet has loaded, you can change the cartridge by using JavaScript 
to call the 'loadCartFile()' method on the applet.  However, you must first 
name the applet using the 'name' parameter on the applet tag so that you can 
reference the applet using JavaScript.  For example, if you wish to allow the 
user to switch between 4-Tris and the Maze Demo contained in the file 
'mazdemo1.bin', you could use the following HTML.

    <applet name="MyExample" archive="BlissApplet.jar"
            code=com.bliss.applet.BlissApplet width=320 height=192>
        <param name="cartfile" value="4tris.bin">
    </applet>
    <p>
    <a href="javascript:document.MyExample.loadCartFile('4tris.bin')">4-
Tris</a>
    <br>
    <a href="javascript:document.MyExample.loadCartFile('mazdemo1.bin')">Maze 
Demo</a>

Note that you must use single quotes (') around the cartridge filename.  
Using the sample HTML code above, the user would be able to switch between 4-
Tris or the Maze Demo by simply clicking on the links provided on the web 
page.


APPLET INPUT
The supported keys and the description of each are listed below.

    0-9        - keypad 0-9
    ENTER       keypad enter
    CTRL       - top action buttons
    Z          - bottom left action button
    X          - bottom right action button
    ARROW KEYS  disc controller
    F1         - pause
    F9         - reset


KNOWN LIMITATIONS
- There is no method provided yet for remapping the key inputs.


LICENSE
Note that Bliss is now distributed under the GNU Public License (GPL).  See 
the included GPL.txt for more details on this license.


THANKS AND CONTRIBUTIONS
Thanks to Joe Zbiciak for creating the 4-Tris game as well as the public 
domain Executive and GROM images used in the example, and thanks go to him as 
well for general engineering help and technical information provided all 
throughout the development of Bliss.

