Documentation for FlAniS - the Flash AnimationS applet

June, 2008
updated: June, 2009

Current release version 1.4 -- June, 2009

Welcome to the homepage for the Flash Animations Applet (FlAniS for short). This is a re-casting of the AniS Java applet, done in Flash. Why? We needed to overcome limitations with memory size and problems with cross-platform layout issues. Plus, we wanted to add a few more features!

This document is the detailed information. If you want to take a quick look at the examples, please click here!. If you have questions or comments, please let us know! If you find errors or things that are not clear in this document, we would also appreciate hearing from you!

Quick Links in this Document

Click here for a Quick Help for Flash page, if you or others are having problems with the Flash runtime.

To run FlAniS, you need these three files:

  1. an HTML file that contains the size (width and height) specification, and names the configuration file
  2. the configuration file that contains the options ("parameters")
  3. the flanis.swf file which is the "Flash program".
  4. (during this beta-testing, we also have a flanisdebug.swf which contains debugging output if there are problems)
Downloading: You may pick up this ZIP archive file which contains an example of the HTML and config files, plus the two .swf files mentioned above, as well as the source code.
Here is a skeleton HTML file. Both the OBJECT and EMBED tags are needed to cover different browsers. <html> <body> <OBJECT classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000" codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=9,0,0,0" WIDTH="620" HEIGHT="650" id="FlAniS"> <PARAM NAME="movie" VALUE="flanis.swf"> <PARAM NAME="quality" VALUE="high"> <PARAM NAME="menu" value="false"> <PARAM NAME="FlashVars" value="configFilename=config.txt"> <EMBED src="flanis.swf" NAME="FlAniS" swLiveConnect="false" quality="high" menu="false" WIDTH="620" HEIGHT="650" TYPE="application/x-shockwave-flash" PLUGINSPAGE="http://www.macromedia.com/go/getflashplayer" scale="noscale" FlashVars="configFilename=config.txt"> </EMBED> </OBJECT> ly</body> </html> You may use the above as a template, since very few changes will be needed. If you copy this, then you must:
  1. set the height and width values in both places above to meet your needs.
  2. if you want to use a different name for the configuration file, you must change the "config.txt" in both places in the file.

It is also acceptable to put some of the parameters, described below, into the "FlashVars" parameter in the HTML (in addition to the required configFilename= parameter). You would have to do this in both declarations of FlashVars. In the value part of the FlashVars parameter, each item must be separated by an ampersand (&). For example:
   <PARAM NAME="FlashVars" value="configFilename=config.txt&active_zoom=true&backcolor=0x382433">
Although this makes the specifications much more difficult to read than putting them into a configuration file (below), it is acceptable. If you omit the "configFilename" parameter, then all the parameters must be supplied this way.

An extension of this is to use server-side PHP scripting to return the contents of the configuration file. In this mode, you may also cause some parameters to be passed to the PHP script by using the vertical bar ("|") to separate these parameters. This will be changed to the customary ampersand before the request string is sent to the host. For example:
   <PARAM NAME="FlashVars" value="configFilename=myscript.php?type=7|code=318|domain=us&active_zoom=true&backcolor=0x382433">
In this case, the "config filename" request sent to the server will be:
   myscript.php?type=7&code=318&domain=us
and the active_zoom and the backcolor parameters will be used by FlAniS as parameters.

The configuration file is a text file that contains the parameters and their values. If you are familiar with the Java AniS applet, then these parameters are just like the ones you used in the <PARAM> tags however, here they are contained in a separate text file. Note, however, that each parameter and its arguments MUST be on one line of text in the file! There are no "continuation" lines or marks available!

An example of this configuration file:

# config file for my stuff backcolor=0x800000 controls=startstop, step, speed, framelabel, looprock, refresh, overlay controls_tooltip = Start and stop , Step , change speed, Times , Toggle between looping and rocking, Refresh the images from the server bottom_controls = toggle bottom_controls_tooltip=Click on frame square to remove from animation; click again to add it back file_of_filenames=fof.txt transparency = #ffffff no_enh = true active_zoom=true toggle_size=5,10,20 overlay_labels=Topo,Radar/on,/Counties,Legend overlay_links=1,0,-1,0 overlay_labels_color=0,xff0000,0x00ff00,0 overlay_labels_mouseover_color=0xffffff,x00ff00,0xffffff, 0x801050 overlay_tooltip=Topographic map,, Map outline of counties, The legend overlay_radio=f,t,t,f overlay_smooth=f,t,f,f overlay_transparent_amount=100,50,100,50 overlay_zorder=0,1,3,2 pause=500 rocking=true keep_zoom=true overlay_zoom=t,t,t,f
Note on specifying color values

Throughout this document, hexadecimal values are used to specify colors. The hex values are always in the one of the formats:

where "RR", "GG" and "BB" are the Red, Green, and Blue values from 00 to FF hex. If you know the decimal value, you may use that as well.

Names and Definitions of Controls and Parameters

The rest of this document describes the parameter names and values needed to drive the FlAniS applet. We begin with the controls and then describe the specification of the filenames of the images.

This controls parameter will position the controls above the image window. If you would like some (or all) of the controls below the image window, use the bottom_controls tag, as in:

Note: You must not specify the same control in both the controls and the bottom_controls parameters!

If you want to have your controls appear on more than one horizontal line, preceed the first one on the new line with a /. For example:
controls=startstop, step, speed, /framelabel, looprock, refresh, overlay
would make two lines of controls, with the "framelabel" being the first one on the second line.

Here are the details about each control:

Parameters that may also be used (details for those parameters related to filenames, portals and overlays appear after this section):

debug = true Enables a "debug pop-up window" that will contain information about errors encountered, and other information that might be helpful in setting up your animations. The window may be moved around by dragging on the "title bar". The default value for this parameter is "false". controls_gap = 8 Specify the gap (space) between control widgets, in pixels. The default is 8. controls_tooltip = Start-stop the animation, Refresh the display with current data, Print the display, Set the animation speed...... specifies a "tooltip" for each of the controls. If you use the "toggle" control, there must be a place-holder "tooltip" in the list. bottom_controls_tooltip = Click to step one frame forward/backward, Click to go to the first or last frame,..... specifies a "tooltip" for each of the bottom_controls. If you use the "toggle" control, there must be a place-holder "tooltip" in the list. overlay_tooltip = Enable topographic display, Enable radar reflectivity display, Show the roads, Show the watches and warnings,.... specifies a "tooltip" for each of the overlays. If you use the "hidden" option on an overaly, there must be a place-holder "tooltip" in the list. use_progress_bar = false specifies whether to use the "Progress Bar" to indicate the status of loading images from the server. The default for this parameter is "true". active_zoom = true specifies that the zoom ability will always be active; this cannot be used in conjunction with the "zoom control". If you specify this parameter, user left-clicks on the image will zoom at that point, right-clicks will zoom out. While zoomed, the image may be roams by dragging the mouse around.

This option should not be used when portals are also used.

keep_zoom = true specifies that the zoom level and position will be restored after a "refresh" is done. Without this parameter, the zoom is reset to the "un-zoomed" view. zoom_factor = 3.4 sets the zoom factor to 3.4. The default is 1.0. This is the factor that determines the zoom "step" for each mouse click. Note that a value of 10.0 approximates what the old AniS did. overlay_zoom = y,y,y,n specifies whether an overlay will be zoomed along with other images. If the value is "y", then the overlay will be zoomed. This is the default.

If the value is "n" then the overlay will NOT be zoomed. This is useful for overlays which are legends, since the legend information will remain on the frame during zoom and roam.

image_window_size = 400,200 specifies that the images will be displayed in a window with a width=400 and a height=200. Without this parameter, the size of the window is the size of the first frame (image). When this parameter is used, the images will be rescaled to this size which might cause some distortion if the given width and height are not proportional to the image width and height.

Normally, zooming is enabled (either with the "zoom" control or the "active_zoom" parameter. If zooming is active, when the user zooms, the image will be zoomed as usual, possibly showing more detail.

image_preserve=0,0,639,49, 610,0,639,479 specifies that when images are zoomed, the two rectangular areas specified (top 50 lines, right-most 30 pixels) should be preserved from the original image. This is useful for showing labels and logos that are part of the original images. There may be one or more such rectangles; the number of values must be a multiple of 4.

The values of the coordinates are ordered: x_upper_left,y_upper_left, x_lower_right, y_lower_right. The (0,0) point for images is in the upper_left corner. The 'x' coordinate is horizontal, the 'y' coordinate is vertical.

For overlays, see the overlay_zoom parameter.

use_caching = true this will enable caching of the images. (The "file_of_filenames" is always read without caching enabled). Whether or not a particular user environment is configured to support caching is unknown. exclude_caching = abcd When caching is enabled (see use_caching above), you can exclude from caching any file whose name contains the string "abcd". use_anti_caching = false Disables the use of altering the filename requested from a web server for non-cached images. The default value is "true". Normally, FlAniS will append "?xxxx" to the request for a file from the HTTP server (where 'xxxx' is an ever-changing value). This will normally not interfere with the HTTP request for the actual file, but has the effect of usually preventing any intermediate "caching servers" from caching images inappropriately.

If you experience any difficulties with this, then set the value to false to prevent this.

no_enh = true this supresses the attempt to read the enh.tab file which contains the enhancement tables if you are using the "enhance" control. enhance_filename=myenh.txt this specifies a different filename for the enhancement table. The default filename is "enh.tab". enhance_overlay = 3 this says that the "enhance" control will be applied to overlay #3 (the first overlay is number zero). Otherwise, the enhancement will be applied to the "base" images. auto_refresh = 16 specifies that the base images will be automatically reloaded from the source every 16 minutes. Note: be somewhat cautious with overlays or portals when using the auto_refresh option -- they may not always work as expected. base_static = true specifies that the base images will be loaded only one time from the server. Any "refresh" action (automatic or manual) will not cause these images to be reloaded. This is appropriate if your base images are unchanging (for example, a topography image). [See also, the overlay_static parameter, below. no_controls = true this supresses showing any controls. Please see "start_looping" parameter, below. coordinates = 43.0, -89.5, 40.65, -81.241 this enables the readout (display) of the coordinates -- usually latitude and longitude. The first two values are the latitude (y) and longitude (x) coordinates of the upper left corner. The next two values are the corresponding values for the lower right.

Linear variation is assumed.

If this parameter is used without specifying the location control then the readout (display) will always appear on the screen!

coordinates_style = 0x000000, 0xffffff, 20, Lat=, Lon=, 2 This specifies the style for the readout (display>. The values are: 1. background color, 2. foreground color, 3. font size, 4. first coordnate label, 5. second coordinate label, 6. number of decimal digits to display. Note that you may omit the last 3 parameters; however if you want to specify them, then you must specify the font size (default is 10)!! hotspot0 = 10, 20, 50, 50, pan, fof, mynewfof.txt, Click here for a new view hotspot1 = 30, 500, 50, 50, pan, popup, this is the pop-up message hotspot2 = 110, 0, icon, lnkimg.gif, nopan, link, http://www.ssec.wisc.edu/flanis specifies three "hotspots" on the image display. Note that the keyword name has an appended number -- this is used to make each hotspot unique, but is only required in the "config" file; it is not required in the "file_of_filenames", where you may just use "hotspots=".

The parameters are specified in one of two formats:

hotspot = x, y, width, height, pan, action, value [,tooltip] hotspot = x, y, icon, filename, pan, action, value [,tooltip]

NOTE -- sensing a hotspot click action takes priority over zooming. If the user puts the mouse pointer on a hotspot and clicks, only the hotspot action will happen.

NOTE -- see "file_of_filenames", below, for additional information.

hotspot_color = 0x40ff00ff specifies that when no hotspot icon image is specified, that the hotspot(s) should use the specified color to fill the rectangle. The format of this value is 0xAARRGGBB, where AA is alpha (opacity, 00 = transparent, ff=opaque), RR is the red intensity, GG is green, and BB is blue. The default for this parameter is 0x00000000 -- a completely transparent rectangle. start_looping = false specifies the initial state of the animation. A value of "false" means the animation is not started automatically. The default value is "true", meaning the animation begins automatically as soon as all frames are loaded. Note: if you do not put in a startstop control and set start_looping to "true" then the animation will run "forever". start_frame = 18 specifies the frame number (starting at zero) of the frame to display after all loading is done. This option implies "start_looping" is "false". rate = 120 rate = 120, 5, 200 specifies the initial loop rate as a number corresponding to frames per second times 10 (thus, 120 means 12 frames per second). The second form provides the range for the "speed" slider if it is enabled. The first value is the minimum speed (0.5 fps or a dwell of 2 seconds per frame, here), and the second is the maximumg (20 fps). minimum_dwell = 30 specifies the minimum dwell (milliseconds) that can be set with the speed slider. The default value is 30ms; the minimum value is 5ms. Not that using small values can cause slower computers to have problems whilst looping. If the speed slider is being used, please use the rate parameter, above, to set the range you desire. dwell_rates = 1000,1000,500,30,1000 specifies the dwell (in milliseconds) for each frame. There must be the same number of values (comma-separated) as there are frames in the animation. In this example, the first and second frames have a fixed dwell if 1s, the third frame is a half-second, the fourth is 30ms, and the fifth frame is 1s. NOTE: these times assume no additional overhead, which is usuallly not the case!

Frame dwell rates may also be set in the file_of_filenames (see below)

rocking = true make "rocking" the startup mode for displaying the sequence; otherwise, "movie loop" is the startup mode. pause = 2000 pause on the last frame of a loop the additional number of milliseconds given (2 seconds in this example). The default is zero. pause_percent = 250 pause on the last frame of a loop the additional percentage of the current dwell time specified (250% in this example). In addition, if the current dwell is > 1 second, a fixed value of 100% will be used whenever this pause_percent option is specified. The default value is zero. transparency =#FFFFFF use the color "white" as the transparency value. This is only needed for overlays, and is optional for fading. The value is a hex value of red/green/blue (template: 0xrrggbb). "black" (0x000000) is also commonly used. In the second example, the transparent values range from 00 to 05 for red, green and blue. This form is particularlly useful when the background is not quite a constant value.

If the value = "image" then all the images are assumed to be GIF images with the 'transparent' attribute assigned to one color level. If used, this option will conserve memory and load faster. When used, the next option (overlay_transparent_amount) cannot be used.

overlay_transparent_amount = 100, 40, 20 The non-transparent pixels in overlays should be set to the opacity percentage indicated. In this case, the first overlay (see overlay_labels) is 100 opaque, the second is 40% and the third is 20%. 0 = totally transparent (you will not see anything! 100 = totally opaque (what would normally happen). overlay_zorder = 3,1,2,0 Changes the order of stacking of the overlays, so that the overlay labels may be arranged in an order that is independent of the stacking of the overlays. The default is: 0,1,2... When using this parameter, there must be one and only one value for each overlay. The example says that the first overlay will be "on top" and the last one will be on the bottom, with the second and third (values 1 & 2) will be in the default order. overlay_labels_color = 0x000000, 0xff0000, 0x00ff00, 0xff00ff Specifies the color of the text used to label the overlay selector buttons. The values are in RGB order (0xRRGGBB) and coded as hexadecimal values (00 = 0, ff = 255). There must be one item for each label -- even if the label is hidden! See "overlays" below. overlay_labels_mouseover_color = 0x808080, 0x00ff00, 0xffff00, 0x505050 Specifies the color of the text used to label the overlay selector buttons when the mouse is "rolled over" the selector. The values are in RGB order (0xRRGGBB) and coded as hexadecimal values (00 = 0, ff = 255). There must be one item for each label -- even if the label is hidden! See "overlays" below. Pick colors that provide contrast with the background and are different than the "overlay_labels_color" (above). overlay_labels_bold = f,f,t,f Specifies whether the weight of the overlay label should be Bold or Normal. "t" (or "b") specifies bold. overlay_static = y,y,n,n,y Specifies that certain overlays are "static" and do not need to be re-read when a Refresh is done. A value of "y" (yes) indicates this overlay is static. "n" (no) indicates it is not static and it's image files should be read during a refresh. overlay_gap = 8 Specify the gap (space) between the overlay checkboxes, in pixels. The default is 8. fade = true NOT IMPLEMENTED -- although the "fader" control is! instead of just showing the images, generate 'faded' images between them and use the result as the sequence. background_image=myimage.jpg instead of a constant color for the background of the applet (see "backcolor", below), this allows you to create an image. Most of the image will be covered up by the main display "window". No scaling of the image is done, so it should be the same size as defined in the HTML for the HEIGHT and WIDTH parameters. background_hotspot = x, y, width, height, action, value define a hotspot for the background_image. If you use more than one background_hotspot, you MUST use key names appended with an increasing number. For example, if you had 3 background_hotspots to define, you would use:
background_hotspot0 = 350, 200, 50, 50, fof, newfof.txt
background_hotspot1 = 200,100,50, 50, fof, new2fof.txt
background_hotspot2 = 100,540, 50, 50, popup, More info content_position = 0, 3 Specify that the panel containing the controls and display will be placed at x =0 and y=3 in the parent panel. This can be used when a background_image is used to fine-tune the positioning. backcolor = 0xff00ff set the applet background color (used for backgrounds of all the controls as well...) to the RGB value (in hex) given (in this case, red=255, green=0 and blue=255). forecolor = xffffff set the color of the foreground (used for names on buttons, etc.) to the RGB value (in hex) given (in this case, white). Note that you should keep a good contrast between the background and foreground colors. font_size = 18 set the size of the fonts for all widgets to the value give; the default is 10. startstop_labels = Start, Stop, 20 looprock_labels = Loop, Rock, 20 autotoggle_labels=Auto On, Auto Off, 30 autorefresh_labels = Auto On, Auto Off, 30 refresh_label = Refresh zoom_labels = Zoom, Un-zoom, 30 fader_label = Vis IR fadertoggle_label = Step through images pick_enhancement = Pick Enhancement location_labels = Show Location, Hide Location, 100 Each of these parameters allows you to specify alternate labels for many of the controls. For those controls having more than one label, you may also specify a 3rd parameter which is the width (in pixels) of the button -- this can be helpful to avoid any automatic resizing when toggling button states. setframe_label = Image Frame Number * set the template to use for labelling the "setframe" control slider/scrollbar. The given string of characters must contain an asterisk ("*") character; the actual frame number will replace this when displayed. frame_label = label for 1, label for 2, ... TIME/DATE SUBSTITTUTION NOT IMPLEMENTED when the framelabel control is specified, the values in this comma-separated list will be used to label each frame. If you enclose a standard format date-time between a pair of "$$" characters, it will be replaced by a string for the computer's local time zone. For example: "Picture from $$5/10/00 15:00 GMT$$ in the morning" will be displayed as: Picture from May 10 10:00:00 CDT 2000 in the morning The formatting is fixed by the Java library... frame_label_width = 30 this specifies the width of the text box (in characters) to be used for the frame_label strings. The default is 20 frame_label_style = 0x000000, 0xffffff, 20, 30 this parameter specifies the style of the frame_label display. The arguments are: background color, foreground (text) color, font height, and label (box) height. image_base = http://www.my.host/mydir/ this directs that the base URL of the image files (and the file_of_filenames, if used) should be the value given. The default URL is the directory containing the HTML. Note that the hostname in the specified URL must be the same as the hostname where the applet is read from.

Note that if this is a directory reference, it MUST end with a slash character (that is: / ).

toggle_size = 5,10,3 this sets the toggle control's little boxes width to 5, the height to 10, and the spacing between them to 3. This can be very helpful if you have a large number of frames and don't want to make your applet width too large just to accomodate these boxes. rotator_labels = N, E, S, W NOT IMPLEMENTED this defines the labels to be used with the rotator widget. You may specify up to 8 labels (more just won't fit...) that will be evenly distributed around the circle. The first label will be placed at the top ("North"), and sucessive labels will be positioned clockwise around the circle. Depending on the letters, you may be able to get up to 4 letters per label (certainly more than that for the top and bottom (0 and 180 degrees). If you use 'fading', then the number of frames will be recomputed when you activate/de-activate it, but the rotator labels will not change. NOT IMPLEMENTED rotator_color = x00ff00 NOT IMPLEMENTED this defines the color to use for the rotator "arm". It is in for format: xRRGGBB, so the value shown will make a green colored arm. The labels and circle will be drawn with the foreground color specified. The default is yellow (xffff00). NOT IMPLEMENTED num_frames_choice = 5, 10, 15, all NOT IMPLEMENTED this defines the contents of the numframeschoice control (see above) that allows the user to select the actual number of images (frames) that are downloaded and displayed. By default, the first element in this list defines the start-up conditions. In the example herein, only the last 5 frames of the sequence will be initially downloaded and displayed; this includes all overlays and portals defined for only these frames as well.

There are some options available:

default_num_frames_choice = 2 NOT IMPLEMENTED this sets the initial (default) index of the choice for num_frames_choice list (above). This value is zero-based and the default value is 0 (zero) meaning the first item in the list.

The following are related to the image filenames specification - details are immediately below.

basename = file num_frames = 6 base_starting_number = 1 filenames = file0.gif, file1.gif, file2.gif file_of_filenames = listoffiles.txt

Note that while the "file_of_filenames" argument is normally the name of a text file, you may also use this to invoke a server-side php script that will return lines of text just as if they were from a file. If you need to pass parameters to your php script, you must use the vertical bar (|) instead of the ampersand (&) in the declaration; the bars will be changed into ampersands before making the server request, however.

An example might look like: file_of_filenames=myscript.php?type=432|code=12|realtime=y when this is sent to the server, it will be: myscript.php?type=432&code=12&time=y

Image file names
All the image files can be in GIF, JPEG or PNG formats. The files identified using the parameter names described in this section should fill the desired window. If used, overlays and portals should be the same size and have the same geometry as these "background" images.

For the background images, the image files may be specified in one of three, mutually exclusive, ways.

  1. Using a "root" name, to which successive numbers are appended to create the actual filenames:
    basename = file num_frames = 4 base_starting_number = 0 In this case, the root name is file and since there are 4 images specified with the numbering starting at 0, the actual filenames must be: file0, file1, file2, and file3. Please note that the default base_starting_number is zero, and so it would not have to specified in this case...

    Also, please see the Note below about this form and wildcards

  2. Using the filenames themselvels:
    filenames = file0, file1, file2, file3
  3. Using a file which contains a list of the image filenames (one per record)
    file_of_filenames = file-containing-filenames where the file "file-containing-filenames" contains lines of text that are in the form:
    file0 file1 file2 file3 Lines beginning with # are ignored, so you may put comments into your file_of_filenames.

    NOTE: If you want to specify an optional frame label (see the controls section above), you may put the value with quote marks after the filenames. (The label may, optionally, contain a date-time to be reformatted for the user's timezone -- see "frame_label", above.) For example: file0 "label one" file1 "label two"
    NOTE: If you want to specify an optional dwell rate for each frame, put the value (in milliseconds) inside brackets after the filename. Be sure to put a space before and after the brackets. If you use this mode, you must supply a dwell rate for every frame! For example: file0 [800] "label one" file1 [300] "label two"
    NOTE: if you are using overlays, then you may put them into the file_of_filenames as well. Please see the section, below, on overlays.

    NOTE: if you would like to re-define hotspots in the file_of_filenames, use any of the forms specified in the definition of the parameter "hotspot" (above). Some examples:

    hotspot=x,y,w,h,pan,fof,mpx_ncr20090405.txt, Click here to load new data hotspot=x,y,icon,himage3.png,pan,popup,This is the popup text and may be <b> in bold</b> hotspot=x,y,icon,hotimage1.gif,nopan,link,http://www.ssec.wisc.edu,Click here to open a link to the SSEC homepage ....
    You may also re-define the "coordinates" parameter within the file_of_filenames.
NOTE: For the first form (specifying a "basename"), you may also use a wildcard format. There are two forms of this, one using a single * (to substitute numbers 0,1,2...,10,11,.. at that point) and the second using one or more ? (to substitute the numbers with leading zeroes for all the ? marks). For example, if you say: basename = file*.gif the actual filenames must be: file0.gif, file1.gif, file2.gif, and file3.gif

You may also use the form:

basename = file????.gif the actual filenames in this case must be: file0000.gif, file0001.gif, file0002.gif, and file0003.gif

Note that in both these cases,

Overlays
You may also use overlays -- one or more images that are (optionally) displayed on top of the base image, usually in such a way that part of the base image shows through. For example, a map or plotted data may be an overlay. In order to let some of the base (background) image show through, you must designate one color level in the overlay images as "transparent" and then specify that value using the transparency parameter (above). You may also specify the opacity/transparency of the non-transparent portions of overlay images -- see the overlay_transparent_amount parameter (above).

You may also specify the color of the labels for each overlay using the overlay_labels_colors parameter (above).

In addition, you need to specify the overlay control, and provide a few more parameters:

Overlay file names

To specify the names of the files for the overlays, you may use one of these forms (note in each example, 3 overlays (A,B,c) are being defined with the names associated with each separated by a comma; in the second method, the files for each of 4 frames are explicitly named separated by &).

  1. NOT IMPLEMENTED In the first case, you are specifying a "basename" for each overlay (see file name conventions, above). Each name you specify is for an individual overlay, and the software will load as many images for each overlay as there are background image frames. overlay_basenames value= ofileA, ofileB, ofileC (Again, you may use the wildcard format -- see above.)
  2. In the second case, you are naming each file explicitly. The grouping of names is the same as above -- commas separate portals. Ampersands separate filenames for each frame of a loop. overlay_filenames = ofileA0 & ofileA1 & ofileA2 & ofileA3, ofileB0 & ofileB1 & ofileB2 & ofileB3, ofileC0 & ofileC1 & ofileC2 & ofileC3
  3. Finally, you may also use a text file (the "file_of_filenames" form) to specify all the filenames. To use overlays with this form, the filenames for all the overlays for one frame appear on one line. file0 overlay=ofileA0, ofileB0, ofileC0 file1 overlay=ofileA1, ofileB1, ofileC1 file2 overlay=ofileA2, ofileB2, ofileC2 file3 overlay=ofileA3,ofileB3, ofileC3 NOTE: You MUST supply all overlay file names for each frame, even if the filename is repeated!!

    NOTE: If you want to specify an optional frame label (see the controls section above), you may put the value with quote marks between the filenames and the keyword that follows. For example: file0 "label one" overlay=ofileA0, ofileB0, ofileC0 file1 "label two" overlay=ofileA1, ofileB1, ofileC1
    NOTE: If you want to specify an optional dwell rate for each frame, put the value (in milliseconds) inside brackets after the filename. Be sure to put a space before and after the brackets. If you use this mode, you must supply a dwell rate for every frame! For example: file0 [800] "label one" overlay=ofileA0, ofileB0, ofileC0 file1 [300] "label two" overlay=ofileA1, ofileB1, ofileC1

Updates after Beta

Since the first release version, here is a summary of changes:

What's new

Here is a brief list of those things that FlAniS has that AniS does not:

Updates during Beta

During the Beta "test" period, lots of changes were made....here's a summary:

Join the FlAniS mailing list

 If you would like to get notified of updates to FlAniS, send an email to:

leave ths subject and body blank. You will later be asked to verify that you did, indeed, subscribe. Just follow the instructions. We will keep the AniS and FlAniS lists the same for the time being...so if you are already on the AniS list, you do NOT need to sign up again!

Copyright Notice

The software described herein, FlAniS (Flash AnimationS), a Flash-based animator for the web and is Copyright(C) 2008-2009 Tom Whittaker. Flash is a product of Adobe.

This program is free software; you can redistribute it and/or modify it but you may NOT repackage and sell it.

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.

The developers or their employers are not responsible for any and all ramifications, etc., which may result from using this software, or software derived therefrom. Furthermore, you agree to hold us harmless from any consequences related to the use of this software.

That's it.

Back to the FlAniS homepage