www.randelshofer.ch

ANIMApplet

© Werner Randelshofer
Readme  Changes  License

Readme

Contents

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

ANIMApplet Copyright © 1999-2010 Werner Randelshofer
Hausmatt 10, CH-6405 Immensee, Switzerland
werner.randelshofer@bluewin.ch
http://www.randelshofer.ch
All rights reserved

Third Party Libraries

Parts of this software (as marked) is
Copyright 1997-2003 by Sun Microsystems, Inc.,
901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
All rights reserved.

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.