home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / graphics / fliplay_1 / !FliPlay / !Help < prev    next >
Text File  |  1994-09-29  |  6KB  |  156 lines
  1. !FLIPlay 0.26, 29th September 1994
  2. ==================================
  3.  
  4. #include <std/disclaimer.h>
  5. FLIPlay is copyright © 1994 K.F.Quinn.  It is distributed in good faith,
  6. but without any warranty, even without any implied warranty of
  7. merchantability or fitness for a particular purpose.
  8.  
  9. FLIPlay 0.26 is free.  No charge may be made for the software itself,
  10. however reasonable charges may be made to cover handling, distribution
  11. and media costs.
  12.  
  13. Comments, suggestions and bug reports to fliplay@banana.demon.co.uk.
  14.  
  15.  
  16. Credits:
  17.   Simon Middleton for hints, bug reports, corrections, RiscPC stuff and
  18. general encouragement.
  19.  
  20.  
  21. --------------------------------------------------------------------------
  22.  
  23.  
  24. Introduction
  25. ============
  26.  
  27. This little utility plays standard Autodesk Animator FLI and Animator Pro
  28. FLC files.
  29.  
  30. Note that under Risc OS 2 the player only supports FLI files and only
  31. supports the standard 256-colour (16-palette) modes.  
  32.  
  33. Under Risc OS 3 however it will play FLI and FLC files, and automatically
  34. finds the best available screen mode, and should detect graphics
  35. enhancement cards if they integrate properly with Risc OS.  Where 256-entry
  36. palettes are available these will be used if possible.  It also corrects
  37. properly for the 6x5 aspect ratio on FLI files.
  38.  
  39. Under Risc OS 3.5 (i.e. on the Risc PC) the player finds a 256-entry
  40. palette mode that is most appropriate - this gives true SVGA colour.
  41.  
  42. For the rest of this document, where FLI files are mentioned, it should
  43. be taken to mean FLI or FLC files.
  44.  
  45.  
  46.  
  47. Instructions
  48. ============
  49.  
  50.  
  51. 1) Loading FLIPlay and Starting Animations
  52.    ---------------------------------------
  53.  
  54. Double-click on the !FLIPlay icon or a file with filetype FLI (&B9F) to
  55. load FLIPlay.
  56.  
  57. When the application is loaded, click select on the iconbar icon to
  58. see the FLI (if appropriate).  Double-clicking on a FLI file when the
  59. application is already loaded automatically runs the animation.  Once
  60. loaded, the application will attempt to play files ending in "/FLI" or
  61. "/FLC" as well as those of filetype FLI.  Clicking select on the iconbar
  62. will play the last FLI loaded.
  63.  
  64.  
  65. 2) The Iconbar Menu
  66.    ----------------
  67.    
  68. The iconbar menu allows some control over the display of animations.
  69. The "Options" submenu has the following items, all of which may be
  70. turned on and off:
  71.  
  72.   Display Text:  For each frame, the frame number and the amount of
  73.                  time taken to process the frame (in centiseconds) is
  74.                  shown at the bottom of the display.  The time delay
  75.                  does not include the time taken to load the frame
  76.                  from disc (if relevant).
  77.                  Default: Off.
  78.  
  79.   Override Chk:  This stops FLIPlay from discarding files that don't
  80.                  come up to certain criteria.  The checks include
  81.                  the file "magic number" and that the depth of pixels
  82.                  is 8bpp.  I have seen a few FLIs which say they don't
  83.                  meet the 8bpp requirement, even though they do.  If
  84.                  you have one of these files, select this option and
  85.                  FLIPlay will attempt to play as normal.  Default: Off.
  86.            Note: If this option is selected and a file that is NOT a
  87.                  FLI is dragged to the icon bar then the action of the
  88.                  player is undefined, and could cause your machine to
  89.                  crash.  Use with caution.
  90.  
  91.   Grid Aspect:   This option causes FLIPlay to rationalise the aspect
  92.                  ratio of animations.  This is particularly useful for
  93.                  old-style FLIs which have small sized text in their
  94.                  frames.  Old-style FLIs have an aspect ratio of 6:5
  95.                  which leads to problems when displaying on a screen
  96.                  whose aspect ratio is 1:1, 1:2, 2:1 etc.  If this
  97.                  option is selected then the aspect ratio is adjusted
  98.                  to one that fits more easily.  This means that the
  99.                  animation gets squashed or stretched somewhat, but
  100.                  the display is cleaner (and often quicker).
  101.                  Default: On.
  102.  
  103.   Resolution:    This option has a submenu which lists all the suitable
  104.                  screen resolutions found by FLIPlay, along with an item
  105.                  "Auto".  If "Auto" is ticked, then FLIPlay will try to
  106.                  find a best-fit screen resolution, picking the nearest size
  107.                  greater than or the same as that of the FLI being played.
  108.                  An individual resolution may be ticked instead of Auto,
  109.                  in which case FLIPlay will use the selected resolution.
  110.                  This is particularly useful for users with VGA monitors
  111.                  for example, or for times when the automatic selection
  112.                  picks an unsuitable screen resolution.  On the Risc PC,
  113.                  the frame rate is displayed as well as resolution.  On
  114.                  other machines the old-style 16-palette modes are marked
  115.                  as "low colour".
  116.                  Default: Auto.
  117.  
  118.  
  119. 3) Facilities while Playing
  120.    ------------------------
  121.  
  122. The following keys are detected by FLIPlay.  The keyboard is checked
  123. between frames, so to have any effect a key must be held down for at
  124. least one frame.
  125.  
  126.   Key    | Action
  127.   -------+-------------------------------------
  128.   Shift  | Speed up animation
  129.   Ctrl   | Slow down animation
  130.   Space  | Pause/Release animation
  131.   Escape | Stop animation and return to desktop
  132.  
  133. Note that on the Risc OS 2 version, "Escape" has no effect, and "Space"
  134. causes the animation to terminate next time it reaches the end of the
  135. sequence.
  136.  
  137.  
  138. 4) Comments about File Loading
  139.    ---------------------------
  140.  
  141. The player attempts to read the whole file into main memory; however
  142. if this is not possible then the file is loaded frame by frame.  Memory
  143. that is grabbed during playback is released back to the system when
  144. the animation is stopped.  Obviously the playback will be quicker if the
  145. whole animation can be loaded - try to make sure you have enough memory
  146. in the "Free" and "Next" slots in the task display to hold the animation.
  147.  
  148.  
  149. 5) The FLI filetype
  150.    ----------------
  151.  
  152. The FLI filetype is &B9F.  If you have any FLI files that are filetyped
  153. to anything else, they should be changed (an older release of
  154. FLIPlay used another type).  Filetype &B9F has been properly allocated
  155. to FLI files by Acorn Computers Ltd.  The filetype also covers FLC files.
  156.