home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / compress / xpk25usr.lha / Workbench / MoviePRO.doc < prev    next >
Text File  |  1992-10-28  |  7KB  |  204 lines
  1.           MoviePRO - an ANIM player for Movie and ANIM5 animations
  2.           --------------------------------------------------------
  3.  
  4.                          Version Beta 4, 14-Feb-91
  5.  
  6.  
  7.                       This program and iff.library by:
  8.  
  9.         Christian A. Weber, Bruggerweg 2, CH-8037 Zurich, SWITZERLAND
  10.  
  11.            Any suggestions or bug reports are welcome, e-mail to:
  12.  
  13.     UUCP:     {uunet|pyramid|rutgers}!cbmvax!cbmehq!cbmswi!mighty!chris
  14.     INTERNET: weber@amiga.physik.unizh.ch
  15.  
  16.  
  17.  
  18. THIS PROGRAM IS IN THE PUBLIC DOMAIN.  IT MAY BE FREELY DISTRUBUTED, COPIED
  19. AND USED FOR COMMERCIAL OR NON-COMMERCIAL PURPOSES. YOU ARE ALLOWED TO MAKE
  20. CHANGES TO THE SHOWIFF.* FILES AS LONG AS YOU CLEARLY MARK THE CHANGES.
  21.  
  22.  
  23. DISCLAIMER
  24.  
  25. THIS SOFTWARE IS PROVIDED "AS IS".
  26. NO REPRESENTATIONS OR WARRANTIES ARE MADE WITH RESPECT TO THE ACCURACY,
  27. RELIABILITY, PERFORMANCE, CURRENTNESS, OR OPERATION OF THIS SOFTWARE, AND
  28. ALL USE IS AT YOUR OWN RISK. YOU ALREADY KNEW THAT, DIDN'T YOU. THE AUTHOR
  29. ASSUMES NO RESPONSIBILITY OR LIABILITY WHATSOEVER WITH RESPECT TO YOUR USE
  30. OR INABILITY TO USE OF THIS SOFTWARE.
  31.  
  32.  
  33.                                     ***
  34.  
  35.  
  36. FEATURES
  37. --------
  38.  
  39. - Plays Movie animations (Created with Sculpt 3D/4D or DILBM/PILBM) and
  40.   ANIM5 animations (Videoscape, DPaint...).
  41.  
  42. - Runs from both Workbench and CLI, creates an AppIcon under Kickstart 2.x
  43.  
  44. - Uses double-buffering for best results
  45.  
  46. - Is fully multi-tasking compatible!
  47.  
  48.  
  49.  
  50. REQUIREMENTS
  51. ------------
  52.  
  53. MoviePRO requires the arp.library and, of course, the iff.library. These
  54. two files should be located in the LIBS: directory.
  55.  
  56. Currently, MoviePRO requires 10 KBytes of stack. Make sure you set this
  57. stack size in EVERY animation's icon, or a guru will visit you!
  58.  
  59. Note: This is only a beta release and has many bugs! Beware!
  60.  
  61.  
  62.  
  63. WORKBENCH USAGE
  64. ---------------
  65.  
  66.  
  67. Under Kickstart 1.3:
  68.  
  69.   Select all animations you wish to view while pressing the SHIFT key, then
  70.   double-click the MoviePRO icon.
  71.  
  72.   You can also set the animation's default tool to MoviePRO using WorkBench's
  73.   'Info' feature. You must set the stack size to at least 10K in the icon.
  74.   If you wish to display all the animations in a drawer, select the drawer,
  75.   and while depressing the SHIFT key, double-click the MoviePRO icon. This
  76.   works even with disk icons!
  77.   If a drawer or disk contains another drawer, the animations in that drawer
  78.   will also be displayed.
  79.  
  80.  
  81. Under Kickstart 2.x:
  82.  
  83.   Under Kickstart 2.x you have an additional possibility, which you may
  84.   prefer once you are familiar with Kickstart 2.x: You can put MoviePRO in
  85.   your WBStartup drawer. When you boot your Amiga, MoviePRO is automatically
  86.   started and creates an "AppIcon". This icon looks like any other icon, and
  87.   you can freely chose it's name and it's position (see below). But this
  88.   icon has an interesting feature: You can view an animation by simply
  89.   dragging the icon of that animation on MoviePRO's AppIcon. This works for
  90.   drawers and disks too, of course.
  91.   If you wish to remove the MoviePRO AppIcon, simply start MoviePRO again.
  92.  
  93.  
  94. Tool Types:
  95.  
  96.   MoviePRO understands several tool types. You can edit them using the
  97.   "Show Information" or "Info" commands from the Workbench menu. Here's
  98.   a list of the recognized tool types:
  99.  
  100.   ICONXPOS     Specifies the x coordinate of MoviePRO's AppIcon. This works
  101.                only under Kickstart 2.x and above.
  102.                Example: ICONXPOS=620
  103.  
  104.   ICONYPOS     Specifies the y coordinate of MoviePRO's AppIcon. This works
  105.                only under Kickstart 2.x and above.
  106.                Example: ICONYPOS=120
  107.  
  108.   ICONNAME     Specifies the name of MoviePRO's AppIcon (Only Kickstart 2.x).
  109.                Example: ICONNAME=Animation Player
  110.  
  111.   OPTIONS      Here you can specify several options, in the same format as
  112.                if you would enter them from CLI. Works under 1.3 too.
  113.                Example: OPTIONS=ALL LOOP 5 NOOVERSCAN
  114.  
  115.   TASKPRI      If you have a slow processor or a complex animation, MoviePRO
  116.                needs more processor time to display the animation in the
  117.                desired speed. If you set TASKPRI to some value higher than 0,
  118.                MoviePRO will run slightly faster. Note that in this case
  119.                you should not run any time-critical software (such as terminal
  120.                programs) while playing animations. TASKPRI can be set to any
  121.                value between -128 and 127.
  122.                Example: TASKPRI=50
  123.  
  124.  
  125.  
  126. CLI USAGE
  127. ---------
  128.  
  129.  
  130. The template is:
  131.  
  132. Patterns/...,ALL/s,C=CONTINUOUS/k,L=LOOP/k,T=TIMING/k,NO=NOOVERSCAN/s,V=VERBOSE/s
  133.  
  134. MoviePRO <patterns> [ALL] [CONTINUOUS num] [LOOP num] [TIMING jiffies]
  135.          [NOOVERSCAN]
  136.  
  137.  
  138. Example: MoviePRO Anim/* Sculpt/foo.anim CONTINUOUS 32000 TIMING 3
  139.  
  140.  
  141. patterns       can be any number of file names, directories or disk names.
  142.                All of the ARP wildcards can be used. (?,*,#?,...)
  143.  
  144. ALL            if this keyword is specified, animations in sub-directories
  145.                will also be shown.
  146.  
  147. CONTINUOUS n   This determines how many times the animation is displayed.
  148.  
  149. LOOP n         With LOOP you can specify how many times the animation is
  150.                played, but not continuously. This is for animations which
  151.                are not designed as endless-loop-animations.
  152.  
  153. TIMING n       specifies the delay between the frames of the animation, in
  154.                jiffies. Note that if you have a complex animation or a slow
  155.                processor, values lower than three (3) are not guaranteed to
  156.                give the desired results.
  157.  
  158. NOOVERSCAN     display all animations in the size of the Workbench screen, and
  159.                never in overscan. This is not very useful ;-)
  160.  
  161. VERBOSE        This is only for debugging and should never be used.
  162.  
  163.  
  164.  
  165. KEYS AND MOUSE-BUTTONS
  166. ----------------------
  167.  
  168. While an animation is displayed, you can press the following keys:
  169.  
  170.  
  171. LEFT MOUSE BUTTON
  172.  
  173.   Display the next animation. If there are no more animations to show,
  174.   MoviePRO closes its window and terminates.
  175.   If in AppIcon mode, MoviePRO closes its window and waits for new animations.
  176.  
  177.  
  178. RIGHT MOUSE BUTTON
  179.  
  180.   Abort immediately
  181.  
  182.  
  183. Ctrl-C (if the MoviePRO window or the CLI window is active)
  184.  
  185.   Abort immediately
  186.  
  187.  
  188. Ctrl-E (if the MoviePRO window or the CLI window is active)
  189.  
  190.   If you started MoviePRO from Workbench, ore enabled the "ALL" option from
  191.   CLI, pressing Ctrl-E will skip all animations in the current sub-directory,
  192.   and return to the parent-directory (like in the CLI "Dir" command).
  193.  
  194.  
  195.  
  196. ----------------------- Schneid hier -----------------------------------------
  197.  
  198. Gruss
  199.     -chris
  200.  
  201.  
  202.  
  203.  
  204.