home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / GFX / viewer / WINPL131.LZX / WinPlay / WinPlay.DOC < prev    next >
Encoding:
Text File  |  1995-12-11  |  8.7 KB  |  226 lines
  1.                                   WinPlay
  2.  
  3.                            Version 1.0 Release 3
  4.  
  5.                        Amiga Workbench Animation Viewer
  6.  
  7.  
  8.  
  9.                                    *-*-*
  10.  
  11.  
  12.  
  13. Thank you for trying out WinPlay. This little program will allow playback of
  14. standard IFF/ILBM anims in a window on a workbench screen. The animations
  15. must be compatible with the DPaint 3 format. WinPlay uses long delta (type 2)
  16. compression and does not include any palette changes.
  17.  
  18. This software is shareware. That means that if you decide to keep it you need
  19. to register this copy with the author and pay a shareware fee of US $10.00
  20. to those who register I will send an AGA version of the software, which
  21. supports palettes of up to 256 colors.
  22.  
  23. This version is not crippled in any way (except for shareware notices). It
  24. should still run on all Amigas including AGA machines.
  25.  
  26. This version of the archive is freely distributable. You may distribute it
  27. in any way you want, as long as no files are altered, and all the files
  28. in this archive are included in your distribution.
  29.  
  30. I do not take any responsibilies for any sort of damages resulting from
  31. using this software. Use this software at your own risk.
  32.  
  33. RELEASE 3 (v1.3)
  34.  
  35. This is current, latest release of Winplay. Few minor bugs were fixed, some
  36. things fixed to perform better (double buffering should work 100% clean now)
  37. and there are some new features introduced.
  38.  
  39. In general, new in v1.3
  40.  
  41. - improved double buffering (no more "ghost" effects appearing sometimes).
  42. - slightly faster, smoother playback.
  43. - removed ability to load more anims to the same window (PREV/NEXT).
  44. - delete anim file from within the program (or any other file).
  45. - file information about an anim readily available within the program.
  46. - save currently displayed frame to a disk as an IFF file.
  47. - save a range of frames to a disk as a series of IFF files.
  48. - option to capture entire Workbench screen when saving anim frames.
  49. - variable speed playback
  50.  
  51. REQUIREMENTS
  52.  
  53. WinPlay should run on all Amigas. Hopefully, even on the ones with graphics
  54. cards (PicassoII and Cybergraphics have been confirmed).
  55.  
  56. It only requires that thinpaz.font, size 8, be present in your FONTS: drawer.
  57. It will also need topaz 8, but since all systems come with topaz 8, it was
  58. not included in the archive.
  59.  
  60. INSTALLATION
  61.  
  62. Copy thinpaz.font and its drawer to FONTS: directory. Also, make sure that
  63. topaz.font, size 8, is also available.
  64.  
  65.  
  66.                                INSTRUCTIONS
  67.  
  68.  
  69. Functions of most menus and gadgets should rather self-explanatory. Anyway,
  70. here is a quick overview of all the functions.
  71.  
  72. CONTROL:
  73. --------
  74.  
  75. OPEN     -  Load anim into memory for playback
  76. NEW      -  Delete current anim from the queue (first in last out)
  77. PLAY     -  Play current animation
  78. REWIND   -  Jump to very first frame
  79. ADVANCE  -  Go to next frame
  80. STOP     -  Hold (stop) playback
  81. PALETTE  -  Allows to manipulate palettes:
  82.  
  83.          ALL ANIM    -  Make anim's palette become WB's palette
  84.          ALL WB      -  Restore WB palette in its entirety
  85.          MERGE ANIM  -  Copy pens from anim's palette to the current palette
  86.          MERGE WB    -  Restore lower WB palette's pens
  87.  
  88. ABOUT    -  WinPlay information
  89. QUIT     -  Exit WinPlay
  90.  
  91. OPTION:
  92. ------
  93.  
  94. PLAYBACK COUNTER  -  If "ON" it will display current frame number during
  95.                      playback. Included as an option because slow down it
  96.                      causes on slower machines is somewhat noticable.
  97. MERGE PENS        -  Number of pens (0 - 7 registers only) restored when
  98.                      using MERGE ANIM and MERGE WB from PALETTE menu.
  99. VERIFY ANIMATION  -  Error detection can be switched "ON" or "OFF"
  100. CHECK FREE MEMORY -  Same as above. Look below for more information about
  101.                      error checking.
  102. WORKBENCH CAPTURE -  If "ON", entire Workbench screen will be saved with
  103.                      a current frame in a WinPlay's window when using frame
  104.                      capture.
  105. PLAYBACK SPEED    -  sets the speed of the played anim: 1 being the fastest
  106.                      and 6 the slowest setting (approx. 1 frame per second)
  107.  
  108. FILE:
  109. ----
  110.  
  111. DELETE  - Deletes a file from a disk. If you have an anim loaded this will
  112.           the default subject for deletion, but you may change it to anything.
  113. CAPTURE - Will save currently shown frame to a disk as an IFF/ILBM picture.
  114.  
  115.         CURRENT FRAME  -  will save one (current) frame
  116.          FRAMES RANGE  -  will allow to specify a range of frames (first and
  117.                           last frame, and increment).
  118.  
  119. INFO    - Displays some very basic information about currently viewed anim.
  120.  
  121. ERROR DETECTION
  122.  
  123. This is my first program that deals with animations. I understand that there
  124. is a great possibility that WinPlay will not recognize some of the anim file
  125. formats. To play, an animation has to be standard DPaint 3 compatible. If
  126. after trying to load an animation, WinPlay keeps saying "Anim not recognized"
  127. and you're confident that it should have been, turn error checking off and
  128. try again.
  129.  
  130. The same idea is behind checking if there is enough chip memory to hold an
  131. animation before loading it. Machine will crash if it runs out of RAM while
  132. loading an anim. Winplay will check if there is enough room for an animation
  133. plus two additional bitmaps of that anim's size needed for double buffered
  134. playback.
  135.  
  136. Error checking was added as an option for greater flexibility.
  137.  
  138. MORE ON PALETTES HANDLING:
  139.  
  140. When you first load an animation, WB palette remains the same. You can switch
  141. to full anim's palette by picking CONTROL/PALETTE/ALL ANIM. But then if you'd
  142. like to keep working with Workbench, but only need let us say 4 first pens to
  143. do so you'll need to set OPTION/MERGE PENS/4, and then select CONTROL/PALETTE
  144. /MERGE WB. This will cause first four pens of your original Workbench palette
  145. to be used as current pens 0..3, while preserving the remaining colors of the
  146. animation. And that's all there is to it. You can merge 2,4,or 8 pens, which
  147. is selectable using OPTION/MERGE PENS menu item.
  148.  
  149.  
  150. KEYBOARD CONTROLS
  151.  
  152. ARROWS UP, DOWN, LEFT, RIGHT
  153. Scroll currently displayed bitmap in corresponding direction. There is no
  154. bitmap boundaries checking so it may lead to some interesting results. Useful
  155. if animation's size is greater than the 320x200 window.
  156.  
  157. RETURN
  158. Restores anim's bitmap original position.
  159.  
  160. = (+)  increase scroll speed.
  161.  
  162. - (-)  decrease scroll speed.
  163.  
  164. \ (\)  restore original speed.
  165.  
  166. Be careful with scrolling on machines with little RAM. Scrolling too far can
  167. cause the machine to crash.
  168.  
  169. KNOWN THINGS TO WATCH OUT FOR:
  170.  
  171. Sometimes Winplay may wrongfully estimate the amount of free available RAM, so
  172. if you are positive that anim should load try again with OPTION/CHECK FREE RAM
  173. marked OFF.
  174.  
  175. FUTURE WINPLAY
  176.  
  177. Some of the features I am planning for the future releases of Winplay:
  178.  
  179.   - resizable viewing window
  180.   - true VCR like buttons
  181.   - better palette preservation
  182.   - loading anims to fast RAM
  183.   - anim playback from hard disk
  184.   - FLI/FLC format support
  185.   - FLI/FLC playback from hard disk
  186.   - supporting anims with multiple palettes
  187.   - viewing IFF/ILBM pictures full screen or in a window. Winplay will already
  188.     load and show IFF pictures; don't try using any anim playback functions
  189.     while doing so. It will crash. In future versions it won't.
  190.   - all suggestions from users will be taken into regard and implemented if
  191.     possible.
  192.  
  193. Please, don't forget to register if you like this program and decide to keep
  194. it. I will send you an AGA version of the software (or non-AGA capable of
  195. operating on palettes of more than 64 colors), and offer a great deal on next
  196. upgrade of WinPlay, when it is ready. All users who will register Release 3
  197. will be offered upgrade to next major release free of charge. But you must
  198. registered before that next version is released.
  199.  
  200. If you have any comments, suggestions, or critiques, please, contact me by
  201. email. They are more than welcome.
  202.  
  203. Full registered package consists of the following items:
  204.  
  205.   - Personalized Winplay AGA Version 1.0 Release 3.
  206.   - Personalized Winplay Version 1.0 Release 3 (for non-AGA machines).
  207.   - Bug fixes without having to wait for the next release.
  208.   - Free next major upgrade (sent when ready).
  209.  
  210. To register, please send US $10.00 to the address below. If registering, also
  211. send your full name, full address (please triple check the address to make
  212. sure it is deliverable), e-mail address (if available), a notice if you would
  213. rather receive the software by email, and some comments and/or suggestions
  214. about the program.
  215.  
  216. I hope you'll enjoy WinPlay. Take care and have fun!
  217.  
  218.                            Maciej Gorny
  219.                            424A Victoria Avenue
  220.                            Glassboro, NJ 08028
  221.                            USA
  222.  
  223. e-mail addresses: gorny@saturn.rowan.edu
  224.  
  225. December 1995                                 WinPlay (c) 1995 Maciej R. Gorny