home *** CD-ROM | disk | FTP | other *** search
/ Merciful 3 / Merciful_Release_3.bin / software / a / animworkshopagafix.dms / animworkshopagafix.adf / View / View.doc < prev    next >
Text File  |  1993-03-08  |  8KB  |  219 lines
  1.  
  2. View V3.6 - ANIM/ILBM Viewer  (2/22/93)
  3. Written By: Michael W. Hartman, Cryogenic Software
  4. Copyright © 1993, All Rights Reserved.
  5.  
  6.    View is a program that allows you to view all ANIM opcode 5, 6
  7. or 8 animations and all ILBM IFF format pictures.  This viewer
  8. program is freely re-distributable.  This means that you may
  9. distribute it to anyone, or anywhere providing that this unaltered
  10. file, and the original unmodified program are distributed together.
  11. Permission is NOT given to distribute this program with a commercial
  12. product.  If you wish to ship this program with your product, please
  13. contact me at the address below.
  14.  
  15. NOTE: ASDG and Axiom software have been given the right to distribute
  16. View version 3.6 with any product in their product lines.
  17.  
  18. ------------------------------------------------------------
  19.  
  20.    View supports IFF ANIM OpCode 5 animations.  This is the
  21. standard ANIM format that has been adopted by the Amiga
  22. community.
  23.  
  24.    OpCode-6 Animation is my own creation. The format is exactly
  25. the same as OpCode 5 but is QUAD buffered instead of DOUBLE
  26. buffered.  This allows the player to show 2 screens at one
  27. time for the X-Specs Glasses. Each picture MUST be viewed for
  28. 1/60th of a second, therefore to see a 3D-Picture the viewer can
  29. only play ANIMs at up to 30 frames per second. (2 pictures = 1 frame).
  30.  
  31.    OpCode-8 Animation was created by ASDG.  It was designed with
  32. the newer, faster machines in mind.  It is very similar to OpCode-5,
  33. with the exception that it uses short or long word compression
  34. instead of byte.  This gives faster playback, especially with the
  35. new machines.
  36.  
  37.    For more information on Op-Code 6 or anything else about View.
  38. You may contact me at:
  39.  
  40.       Michael W. Hartman
  41.       Cryogenic Software
  42.       10697 Madison St.
  43.       Thornton, CO 80233.
  44.  
  45. -------------------------------------------------------------
  46.  
  47. Updated from version 3.5 to 3.6
  48.  
  49.    1. Added stack checking.  If the program is not run with at least a
  50. stack of 6000 the program will exit.
  51.  
  52.    2. Added support for non-looping Opcode-8 animations.
  53.  
  54. ***********
  55.  
  56.  
  57. Updated from version 3.4 to 3.5
  58.  
  59.    1. Added support for the new Opcode-8 animation format.  This makes
  60. playback MUCH faster, especially on the new machines with higher chip ram
  61. band width.
  62.  
  63.    2. Added support for SHIFT-RETURN in the filename string gadget.
  64. Hitting SHIFT-RETURN instead of RETURN causes the path gadget to become
  65. active.
  66.  
  67.    3. Added the calculation of "Average Frames Per Second".  It is displayed
  68. after the animation has been viewed.
  69.  
  70. ***********
  71.  
  72. Updated from version 3.3 to 3.4
  73.  
  74.    1. Add support for the new AGA display modes.  If you are running 3.0
  75. the program will open its picture/animation on a screen.  It also uses the
  76. new 3.0 Double Buffering functions. If you are not running 3.0 then the
  77. program should operate the same as before.
  78.  
  79. ***********
  80.  
  81. Updated from versions 3.2 to 3.3:
  82.  
  83.    1. Added support for viewing directories of pictures.  To view a
  84. directory full of pictures, use the file requester to select the directory.
  85. Make sure the "FILE" string is empty, and then select "VIEW IFF".  To
  86. view the next file press the left mouse button. to abort viewing press the
  87. <ESC> key.
  88.  
  89.    2. A new key was added.  The 'L' key toggles lace mode. This is mostly
  90. useful when outputing non-interlace pictures to video.  It has a side
  91. effect when viewing interlace pictures of expanding the view so only the
  92. top half of the picture is visable.
  93.  
  94.  
  95. ***********
  96.  
  97. Updated from versions 3.0 to 3.2:
  98.  
  99.    1. AGAIN the method for positioning the display has been changed,
  100. to accomodate DCTV pictures. This 'should' be the final needed change.
  101.  
  102.    2. The menus have been removed when in the 'HELP' or 'ABOUT' screens.
  103. The menus are not affected anywhere else.
  104.  
  105.    3. Support for brushes has been added.  A brush is any IFF picture
  106. that is SMALLER than the default resolution for its display mode.
  107.  
  108.    4. Support for ANIM brushes was added.  Since ANIM brushes have an
  109. interleave of one, double buffering required copying the buffer every
  110. animation frame.  This gets rid of flicker but may reduce the speed at
  111. which the brush plays.  I tried the brushes I have, however, and could
  112. not detect any speed decrease.  Thus I decided to double buffer the ANIM
  113. brush for flickerless playback.
  114.  
  115.    5. I Added an options menu.  This menu currently holds only one item.
  116. "Pause on entry", when turned on (CHECKED) it will cause the animation
  117. to begin in paused mode.  To start the animation playing, press the <SPACE>
  118. key.
  119.  
  120.    6. View 3.0 did not support non-looping animations correctly.  The
  121. routines that were used in versions 2.x had a bug.  I changed the program
  122. so that these animations would work, but non-looping animations would not
  123. play without a small -hiccup- upon reaching the end of the animation.  This
  124. version of the program now properly handles non-looping animations.  It
  125. does this by detecting the non-looping animation and adding the loop frames
  126. magically transforming it into a looping animation.
  127.  
  128. **********
  129.  
  130. Updated from versions 2.1 to 3.0:
  131.  
  132.    1. RGB file support has been removed.  It proved to be too bulky
  133. and widely unused.  And I personally never used it.
  134.  
  135.    2. The code has been significantly reduced. Mostly because of the
  136. removal of RGB support.
  137.  
  138.    3. A bug was fixed that made some IFF pictures display incorrectly.
  139.  
  140.    4. Another bug with HIRES OVERSCAN animations has been fixed.
  141.  
  142.    5. The method for positioning the display has changed AGAIN.
  143. It was found the DCTV pictures had problems with the last method
  144. that I used.
  145.  
  146.    6. A new interface has been applied.  This means a new file
  147. requester, (with all the features of the old one plus a few more).
  148. As well as the fact that the file information is now readable on
  149. the screen.  The key sequences are displayed via a help screen.
  150.  
  151. -------------------------------------------------------------
  152.  
  153.    The programs execution should be fairly easy to understand. To
  154. view a single animation or picture either run view from CLI
  155. passing it the filename, or click onto the PROJECT icon of the
  156. file.
  157.  
  158.     Example: if desired ANIM is named "foo.anim"
  159.  
  160.       <CLI>          1> view foo.anim
  161.  
  162.       <WORKBENCH>    double click the "foo.anim" icon.  The icon
  163.                 MUST be a project type icon, with its DEFAULT
  164.                 TOOL set to point to the View
  165.                 program.
  166.  
  167.    To view multiple animations or pictures simply run the view
  168. program with no arguments.  A file requester will appear and you
  169. may select a file. After viewing the picture or animation the
  170. file requester will reappear.
  171. When you have seen enough click on the CANCEL gadget in the file
  172. selector.
  173.  
  174.    Example:
  175.  
  176.       <CLI>          1> view
  177.  
  178.       <WORKBENCH>    double click the "VIEW" icon.
  179.  
  180.  
  181.    Another method for viewing multiple files is :
  182.  
  183.       <CLI>          1> view <file1> [file2] [file3] [...]
  184.  
  185.       <WORKBENCH>    single click or drag select multiple project icons
  186.                      and double click on the last one with the <SHIFT>
  187.                      key pressed.
  188.  
  189. -------------------------------------------------------------
  190.  
  191.    Version 3.x now has menus.  This allows for a help menu so that you
  192. don't have to remember the keys listed below.
  193.  
  194.  
  195.    VIEWING CONTROLS:
  196.  
  197.       <ESC> stops viewing for an animation or picture.
  198.       <LEFT> mouse buttone also stops viewing.
  199.  
  200.       <ARROWS>  move the view offsets of the picture or
  201.             animation.
  202.  
  203.       <FUNCTION KEYS> change the playback speed of the animation.
  204.  
  205.       <RETURN> Default speed.  This will use the timing
  206.             information in the
  207.                ANIM file for its speed. This option is DEFAULT
  208.             on.
  209.  
  210.       <SPACE> Freezes the animation at the current frame.
  211.  
  212.       <a> Advances forward one frame. (must first freeze it of
  213.         course).
  214.  
  215.  
  216. -------------------------------------------------------------
  217.  
  218.  
  219.