home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / GFX / ADPro251-3.DMS / ADPro251-3.adf / View.lha / View.doc < prev    next >
Encoding:
Text File  |  1994-01-31  |  7.6 KB  |  215 lines

  1.  
  2. View V3.5 - ANIM/ILBM Viewer  (2/8/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 has been given the right to distribute View version 3.5
  16. with any product in their product line.
  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 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.4 to 3.5
  48.  
  49.    1. Added support for the new Opcode-8 animation format.  This makes
  50. playback MUCH faster, especially on the new machines with higher chip ram
  51. band width.
  52.  
  53.    2. Added support for SHIFT-RETURN in the filename string gadget.
  54. Hitting SHIFT-RETURN instead of RETURN causes the path gadget to become
  55. active.
  56.  
  57.    3. Added the calculation of "Average Frames Per Second".  It is displayed
  58. after the animation has been viewed.
  59.  
  60. ***********
  61.  
  62. Updated from version 3.3 to 3.4
  63.  
  64.    1. Add support for the new AGA display modes.  If you are running 3.0
  65. the program will open its picture/animation on a screen.  It also uses the
  66. new 3.0 Double Buffering functions. If you are not running 3.0 then the
  67. program should operate the same as before.
  68.  
  69. ***********
  70.  
  71. Updated from versions 3.2 to 3.3:
  72.  
  73.    1. Added support for viewing directories of pictures.  To view a
  74. directory full of pictures, use the file requester to select the directory.
  75. Make sure the "FILE" string is empty, and then select "VIEW IFF".  To
  76. view the next file press the left mouse button. to abort viewing press the
  77. <ESC> key.
  78.  
  79.    2. A new key was added.  The 'L' key toggles lace mode. This is mostly
  80. useful when outputing non-interlace pictures to video.  It has a side
  81. effect when viewing interlace pictures of expanding the view so only the
  82. top half of the picture is visable.
  83.  
  84.  
  85. ***********
  86.  
  87. Updated from versions 3.0 to 3.2:
  88.  
  89.    1. AGAIN the method for positioning the display has been changed,
  90. to accomodate DCTV pictures. This 'should' be the final needed change.
  91.  
  92.    2. The menus have been removed when in the 'HELP' or 'ABOUT' screens.
  93. The menus are not affected anywhere else.
  94.  
  95.    3. Support for brushes has been added.  A brush is any IFF picture
  96. that is SMALLER than the default resolution for its display mode.
  97.  
  98.    4. Support for ANIM brushes was added.  Since ANIM brushes have an
  99. interleave of one, double buffering required copying the buffer every
  100. animation frame.  This gets rid of flicker but may reduce the speed at
  101. which the brush plays.  I tried the brushes I have, however, and could
  102. not detect any speed decrease.  Thus I decided to double buffer the ANIM
  103. brush for flickerless playback.
  104.  
  105.    5. I Added an options menu.  This menu currently holds only one item.
  106. "Pause on entry", when turned on (CHECKED) it will cause the animation
  107. to begin in paused mode.  To start the animation playing, press the <SPACE>
  108. key.
  109.  
  110.    6. View 3.0 did not support non-looping animations correctly.  The
  111. routines that were used in versions 2.x had a bug.  I changed the program
  112. so that these animations would work, but non-looping animations would not
  113. play without a small -hiccup- upon reaching the end of the animation.  This
  114. version of the program now properly handles non-looping animations.  It
  115. does this by detecting the non-looping animation and adding the loop frames
  116. magically transforming it into a looping animation.
  117.  
  118. **********
  119.  
  120. Updated from versions 2.1 to 3.0:
  121.  
  122.    1. RGB file support has been removed.  It proved to be too bulky
  123. and widely unused.  And I personally never used it.
  124.  
  125.    2. The code has been significantly reduced. Mostly because of the
  126. removal of RGB support.
  127.  
  128.    3. A bug was fixed that made some IFF pictures display incorrectly.
  129.  
  130.    4. Another bug with HIRES OVERSCAN animations has been fixed.
  131.  
  132.    5. The method for positioning the display has changed AGAIN.
  133. It was found the DCTV pictures had problems with the last method
  134. that I used.
  135.  
  136.    6. A new interface has been applied.  This means a new file
  137. requester, (with all the features of the old one plus a few more).
  138. As well as the fact that the file information is now readable on
  139. the screen.  The key sequences are displayed view a help screen.
  140.  
  141. -------------------------------------------------------------
  142.  
  143.    The programs execution should be fairly easy to understand. To
  144. view a single animation or picture either run view from CLI
  145. passing it the filename, or click onto the PROJECT icon of the
  146. file.
  147.  
  148.     Example: if desired ANIM is named "foo.anim"
  149.  
  150.       <CLI>          1> view foo.anim
  151.  
  152.       <WORKBENCH>    double click the "foo.anim" icon.  The icon
  153.                 MUST be a project type icon, with its DEFAULT
  154.                 TOOL set to point to the View
  155.                 program.
  156.  
  157.    To view multiple animations or pictures simply run the view
  158. program with no arguments.  A file requester will appear and you
  159. may select a file. After viewing the picture or animation the
  160. file requester will reappear.
  161. When you have seen enough click on the CANCEL gadget in the file
  162. selector.
  163.  
  164.    Example:
  165.  
  166.       <CLI>          1> view
  167.  
  168.       <WORKBENCH>    double click the "VIEW" icon.
  169.  
  170.  
  171.    Another method for viewing multiple files is :
  172.  
  173.       <CLI>          1> view <file1> [file2] [file3] [...]
  174.  
  175.       <WORKBENCH>    single click or drag select multiple project icons
  176.                      and double click on the last one with the <SHIFT>
  177.                      key pressed.
  178.  
  179. -------------------------------------------------------------
  180.  
  181.    Version 3.x now has menus.  This allows for a help menu so that you
  182. don't have to remember the keys listed below.
  183.  
  184.  
  185.    VIEWING CONTROLS:
  186.  
  187.       <ESC> stops viewing for an animation or picture.
  188.       <LEFT> mouse buttone also stops viewing.
  189.  
  190.       <ARROWS>  move the view offsets of the picture or
  191.             animation.
  192.  
  193.       <FUNCTION KEYS> change the playback speed of the animation.
  194.  
  195.       <RETURN> Default speed.  This will use the timing
  196.             information in the
  197.                ANIM file for its speed. This option is DEFAULT
  198.             on.
  199.  
  200.       <SPACE> Freezes the animation at the current frame.
  201.  
  202.       <a> Advances forward one frame. (must first freeze it of
  203.         course).
  204.  
  205.  
  206. -------------------------------------------------------------
  207.  
  208.  
  209.    KNOWN PROBLEMS.
  210.  
  211.    1. If the animation does not have loop frames, the creation of the
  212. loop frames can lock the machine, if the frame delta is greater than 64K.
  213.  
  214.    2. Non-Looping animations are NOT supported for ANIM-8 animations.
  215.