FLIcasso V1.5 Documentation
   ===========================


What is FLIcasso?
~~~~~~~~~~~~~~~~~
FLIcasso  is  an  animationplayer  for Autodesk Animator (*.FLI/*.FLC)
Files. It uses the PICASSO Graphics-Board for Videooutput.


Disclaimer
~~~~~~~~~~
The  author  cannot  be held liable for the suitability or accuracy of
this manual and/or the program(s) it describes. Any damage directly or
indirectly  caused  by  the  use  or  misuse of this manual and/or the
program  it  describes  is the sole responsibility of the user her/him
self.


Copyright/Distribution
~~~~~~~~~~~~~~~~~~~~~~
FLIcasso,©  Copyright  1993/94  by  Reinhard  Haslbeck.   All   rights
reserved.  This  program is SHAREWARE, see below how to register. This
program may be freely distributed as long  as  all  documentation  and
executable(s) remain unchanged and are included with the distribution.
Also no profit is to be made by selling  this  program.  You  may  not
charge  more than Fred Fish does for a single library disk. Commercial
distribution is  NOT  allowed  without  written  permission  from  the
author. It is allowed for non-commercial BBSs to distribute an archive
with only the following files in it to save your users some money when
they  want to download this program. NOTE: All files listed below MUST
be distributed together.  None  of  the  files  listed  below  may  be
distributed  on  it's  own!  They  may  ofcourse  be archived with any
archiver.

         FLIcasso            - Main Program
         FLIcasso.info       - Icon
         FLIcasso.doc        - Manual
         FLIcasso.doc.info   - Icon

How to use
~~~~~~~~~~
FLIcasso is designed for CLI-Usage. If You start it from Workbench, no
options  are  available.  Copy  the  file  'FLIcasso' to 'C:' and type
'FLIcasso ?'. This will display all options available:


      FILE/M,L=LOOPS/K/N,FS=FORCESPEED/K/N,R=RESOLUTION/K/N,QUIET/S:


FILE:
      Simply  the  name  of  the  *.FL?-File  you  want  to see. If no
      Filename  is  entered,  a  Filerequester  will appear. AmigaDos-
      style pattern-matching is also supportet.

LOOPS:
      How often the animation will restart.  Disabled  in  this  unre-
      gistered version.

FORCESPEED:
      Overrides  the animspeed given by the *.FLI-file. If it's set to
      zero  the  anim  is played as fast as possible. Since there's no
      legal  way  to  sync  the  anim  to  the  PICASSO-Hardware, it's
      syncronized   to   the   Amiga-Videohardware.

RESOLUTION:
      This forces FLIcasso to open  the  Picasso-Screen  in  a  custom
      size.  RESOLUTION  must  be  one  of these: 320, 640, 800, 1024,
      1280. If your choosen resolution is lower than the width of  the
      Flic-File,  the  program  will  break with an error. This Option
      will slow down the animation replay a bit.

QUIET:
      Skips  all  Outputs  to  Stdout and the delays at the beginning.
      Useful for scripts.

This unregistered version will wait a few seconds before it starts its
work!


Requirements
~~~~~~~~~~~~
   - An Amiga Computer with a PICASSO II pluged in
   - Amiga OS2.04 +


Bugs
~~~~
In conjunction with the monitor files Picasso 2.11 & 2.14 some strange
effects have been discovered when moving the mouse. It will only occur
if You use the option 'RESOLUTION' because  'VilageBlitCopy'  is  used
then  instead  of  'CopyMem'.  I  have't  detected  errors in my code,
therefore it's better to look for another version of the monitor file.


Development
~~~~~~~~~~~
This program was developed on an A3000/25 with O.M.A. 2.0.


History (for FLIcasso, FLItina and FLImer)
~~~~~~~
Changes from V1.4 to V1.5:
    - initial release of FLImer
    - Faster (if no custom resolutions selected)

Changes from V1.3 to V1.4:
    - Added option 'RESOLUTION'
    - Fixed bug in FLC-Delta Decoder

Changes from V1.2 to V1.3:
    - FLC-Support

Changes from V1.1 to V1.2:
    - Pattern matching to view multiple files
    - Optimized on several parts

Changes from V1.0 to V1.1:
    - Startable from Workbench via Icon


How to register
~~~~~~~~~~~~~~~
To get Your own, full featured version of FLIcasso, send

      * An empty floppydisk (880K)
      * A stamped envelope addressed to Yourself
        (non-stamped if You're no German)
      * The sharefee (10,-DM for Germans, $10 otherwise)

   TO:

            Reinhard Haslbeck
            Spirknerstr. 7
            84137 Vilsbiburg

            GERMANY


Special thanks to
~~~~~~~~~~~~~~~~~
   - Volker Rudolph for coding the special Merlin parts in 'FLImer'
   - My brother Walter for some debug hints
   - Helmut Waege for former Retina tests
   - Hans Maurer for the aminet-distribution of the demo-versions
   - Richard Kinder for the FLC-docs


Contact the author
~~~~~~~~~~~~~~~~~~
Address:    Reinhard Haslbeck
            Spirknerstr. 7
            84137 Vilsbiburg
            GERMANY

Phone:      +49/(0)87418676

Internet:   haslbeck@informatik.tu-muenchen.de