Readme

Introduction
Features
System Requirements
Using ANIMApplet
Copyright Notice

Introduction

The ANIMApplet shows Amiga IFF ANIM animations and IFF IBLM images on Java SE 5 capable Internet browsers.

Features

Supports IFF ANIM, IFF ANIM+SLA, IFF ANIM+ANFI, IFF ILBM, IFF PBM
Has a Quicktime-like user interface.
All Amiga display modes (including EHB, HAM and HAM8) can be displayed.
Anim files can be compressed (zipped) to reduce loading time.
Plays mono sound on Java 1.1 to Java 1.2 enabled browsers
Plays stereo sound when Java 1.3 or better is installed.
Plays CRNG and DRNG color cycling. CRNG color cycles can be blended.

System Requirements

Needs a Java 1.5 capable internet browser.

Using ANIMApplet

The program code of the applet is packaged into a single archive file named ANIMApplet.jar.

The file example.html shows how to embed the applet into a HTML document. It contains the HTML statements as provided here. Please note that the parameter values of the applet tag are case sensitive!

Required HTML tags are printed in bold letters.

<html>
  <body>
    <applet
        code="ANIMApplet.class"
        codebase="."
        archive="ANIMApplet.jar"
        width="320"
        height="271"
    >
    <param name="animSource"  value="anims">
    <param name="animArchive" value="World.zip">
    <param name="anim"        value="World.anim">

    <param name="boxBgColor" value="white">
    <param name="boxFgColor" value="black">
    <param name="boxMessage" value="Loading ANIMApplet...">
    <param name="image"      value="boingball.jpg">

    <param name="scale"            value="toFit">
    <param name="framesPerSecond"  value="0">
    <param name="playEveryFrame"   value="false">
    <param name="playWrapupFrames" value="false">
    <param name="renderAsTrueColor" value="true">
    <param name="blendColorCycles" value="false">

    <param name="audio"      value="true">

    <param name="controller" value="true">
    <param name="autoPlay"   value="true">
    <param name="loop"       value="true">
    <param name="pingPong"   value="false">

    <param name="info"  value="false">
    <param name="debug" value="false">


<!-- Parameters for Sun's Java plug-in: -->

    <param name="codebase_lookup" value="false">
    <param name="classloader_cache" value="false">
    <param name="java_arguments" value="-Djnlp.packEnabled=true"/>
    <param name="image" value="Splash.gif"/>
    <param name="boxborder" value="false"/>
    <param name="centerimage" value="true"/>
    <param name="boxbgcolor" value="white">
    <param name="boxfgcolor" value="black">
    <param name="boxmessage" value="Loading ANIMApplet...">

<!-- The following text is displayed, if the applet can't be started: -->

You need a Java enabled browser to see the animation.

    </applet> 
  </body>
</html>

Parameter	Required	Type	Description

code	required	text	The code attribute lets the browser know which Java class it must use to show the applet. The value must be `"ANIMApplet.class`".
codebase		text	You can use the codebase attribue to tell the browser in which directory the animapplet.jar file is located. If you specify a relative URL, then it's interpreted relative to the HTML document's location. By specifying an absoluteURL, you can load the applet from just about anywhere - even from a different HTTP server. Please note that due to security restrictions: The ANIM-files must be in the same directory-subtree where the animapplet.jar file is located.
archive	required	text	The archive attribute indicates the file where the Java program code is stored. Please note that on most web-servers the case of this value must match the case of the file name "`ANIMApplet.jar`". If you specify the parameters for Sun's Java plug-in, you have to store the file "`ANIMApplet.jar.pack.gz`" in the same directory where you stored "`ANIMApplet.jar`".
width	required	number	Width and height of the applet. Add 16 pixels to the height of the animation to accomodate enough space for the control panel. Tip: Use the "info" parameter to determine the best width and height of ANIMApplet for your animation.
height	required	number

animSource		url	The animSource parameter specifies the directory where the animation file is stored. Please omit this parameter if you store the animation file at the same location as the file "animapplet.jar". Pleas note that, due to security restrictions, an applet may access only files that are located on the same directory subtree where the applet code is stored.
animArchive		url	The imageArchive parameter indicates the .zip-File that contains the ANIM-File. Zipping greatly reduces the download time of your animation. Do not specify this line when you don't zip the animation file.
anim	required	filename	The file-name of the IFF ANIM animation file or of the IFF ILBM image.

boxBgColor		color	This parameter specifies the background color for any space thatis not taken by the animation (e. g. before the first frame of the animation is loaded). Specify a hex value (e. g. "0xff0000" or "#ff0000"), three RGB values (e.g. "255,0,0") or an HTML color name (e.g. "red"). The default value depends on the browser settings. If the browser uses the Java Plug-In from Sun, this color will be shown while the applet is being loaded. Tip: This value should match the background color of your HTML page.
boxFgColor		color	This parameter specifies the foreground color for messages displayed on the applet. Specify a hex value (e. g. "0xff0000" or "#ff0000"), three RGB values (e.g. "255,0,0") or an HTML color name (e.g. "red"). The default value depends on the browser settings. If the browser uses the Java Plug-In from Sun, this color will be used for messages displayed while the applet is being loaded.
boxMessage		text	If the browsers uses the Java Plug-In from Sun, this parameter specifies a message that is shown while the applet is being loaded.
image		url	If the browsers uses the Java Plug-In from Sun, this parameter specifies the image being shown while the applet is being loaded. This is often referred to as a "splash screen". The image should have the same size as specified by the "width" and "height" attributes.

scale		variant	"scale" is either "toFit", "aspect" or a (fractional) number. By default the value of "scale" is "toFit". If set to "toFit", the animation is scaled to fit the size of the applet as specified by the "height" and "width" attributes (note: the controller occupies 16 pixels of the height). If this is set to "aspect", the movie will scale to fit the size of the applet while maintaining its aspect ratio. If this is set to a (fractional) number, the movie will be scaled by that number (e.g. 1.5).
framesPerSecond		number	If specified overrides the frame delay settings in the animation file. The value "0" is default and hence uses the time settings from the animation file. Supports fractional values.
playEveryFrame		boolean	By default, this parameter is set to "false". When set to "true", causes the applet to play every frame of the animaton even if it is necessary to play at a slower rate to do so. This attribute isparticularly useful to play short fast looping animations.
playWrapupFrames		boolean	A well formed IFF ANIM file contains two wrapup frames (images) at the end of the file. The wrapup frames are identical with the first two frames of the animation. They are required to do fast looping animations. Setting this parameter to "true" makes ANIMApplet treat the wrapup frames like regular frames. That is, the animation is treated as if it had two additional frames. The default value is "false".
renderAsTrueColor		boolean	When set to "true", ANIMApplet renders the video using a 24 bit direct color model regardless of the color model used by the animation. The default value is "true".

blendColorCycles		boolean	When set to "true", colors in a color cycle are blended into each other instead of being shifted in discrete steps. The default value is "false".
audio		boolean	When this is set to "false", the applet does not load audio data from the file. The default value is "true".

colorCycling		boolean	When this is set to "false", the applet does not start plaiyng the color cycling. The default value is "true".
controller		boolean	If "controller" is set to "false", the control panel will not display. The default is "true". To avoid distortion of the animation you should add 16 pixels to the height attribute when the control panel is displayed.
autoPlay		boolean	When set to "true", the autoPlay parameter causes the animation to start playing as soon as the applet estimates that it will be able to play the entire movie without waiting for additional data. This version of ANIMApplet will start playing only after downloading the whole animation file. The default value is "true".
loop		boolean	By default, "loop" is set to "true". When set to true, the "loop" parameter makes the animation play continuously.
pingPong		boolean	By default, "pingPong" is set to "false". When set to true, the "pingPong" parameter makes the animation play forth and back. This will work only for animations that are encoded using Eric Graham's compression mode 'J' delta frames which are XOR encoded.

info		boolean	Set this parameter to "true" to display information about the animation. This information is useful to determine the preferred size of ANIMApplet.
debug		boolean	Set this parameter to "true" to display debug information on each frame of the animation. This parameter is useful if you think that ANIMApplet does not display your animation properly.

Copyright Notice

Third Party Libraries

This software is the confidential and proprietary information of Sun Microsystems, Inc. ("Confidential Information"). You shall not disclose such Confidential Information and shall use it only in accordance with the terms of the license agreement you entered into with Sun.

Parts of this software (as marked) is
Copyright (c) 21 Jan 1985 Steve Hayes, Electronic Arts
This software is in the public domain.

Published in:
Commodore Electronics Ltd. (1991) Amiga ROM Kernel Manual.
Reference Manual. Devices. Third Edition. Addison-Wesley: Reading.

Parts of this software (as marked) is
Copyright (c) 30.4.2000 Olli Niemitalo.

I, as the author and copyright holder, allow you to do anything you wish with this book free of charge, including copying, printing and republishing. In return, you must preserve this notification and the book’s website URL on the title page.

Published In:
Niemitalo, O. (2000). Audio DSP for the Braindead.
Online: http://www.student.oulu.fi/˜oniemita/DSP/INDEX.HTM

Parts of this software (as marked) are
Copyright (c) 1999,2000 by Florian Bomers <florian@bome.com>
Copyright (c) 2000 by Matthias Pfisterer <matthias.pfisterer@gmx.de>

This program is free software; you can redistribute it and/or modify it under the terms of the GNU Library General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public License for more details.

You should have received a copy of the GNU Library General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

Published In:
Tritonus 0.3.1.

ANIMApplet