home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / graphics / dlviewer / dlviewer.doc < prev    next >
Text File  |  1994-05-28  |  6KB  |  149 lines
  1. --- Program Documention ----
  2.  
  3. DL Viewer
  4. Version 0.01b
  5. by Lonny L Pursell
  6. (C)1994 by Lonny L Pursell and ENCOM
  7. All rights reserved.
  8. Released: May 25th, 1994
  9.  
  10.  
  11. Note: Skip to revision history for a complete list of changes from
  12.       previous versions.
  13.  
  14.  
  15. ---- Disclaimer ----
  16. Use completely at your own risk.
  17. I (the author) will not be held responsible for any damage
  18. (be it hardware or software related) to your system do to the
  19. use or misuse of this program.
  20. The package may be freely distributed as long as the program and this
  21. doc file remain unchanged.
  22. By storing this package on your system you agree to all the above
  23. terms and conditions.
  24.  
  25.  
  26. ---- Purpose ----
  27. This utility will play back DL animations.  Simply known as DL animations
  28. this file format originate from the PC platform.  Many PC CD-ROMS and
  29. Bulletin Boards contain DL files and now you can view them on your Atari.
  30.  
  31. This program was designed for my own use since having recently entered the
  32. CD-ROM craze I discovered a whole subdirectory of these DL files on one of
  33. my CD-ROMs.  The end result being this DL player after many hours
  34. searching through the DL files with a file editor.   I decided to clean up
  35. the program and release it so others my enjoy the many DL files floating
  36. around.  I've also encountered other Atari users looking for such a
  37. player, not to mention it gives me yet another reason not to use a PC!
  38. Need I say more?
  39.  
  40.  
  41. ---- Requirements ----
  42. Any Atari ST compatible machine.
  43.   Memory requirements are based on the DL files you attempt to load.
  44. Runs in any resolution greater than 320x200x16.
  45.   This means the pixel resolution must be at least 320x200 minimum,
  46.   with a minimum of 16 colors.  Tested on the Nova in 24-bit mode!
  47. Remove an TSR or desk accessories to free up more memory.
  48.   The player allocates all free ram when loaded.
  49. Incompatible with MuliTOS!
  50.  
  51.  
  52. ---- Usage ----
  53. Simply run the program from the Desktop or whatever shell you use.  The
  54. file selector will appear.  Select the DL file you wish to play.  After
  55. the DL file is loaded you may be prompted for some further options.  DL
  56. files come in several sizes so you may get an alert box with an option to
  57. play back in double height.  This option was added for TT users beacuse TT
  58. low has a strange aspect ratio, thus squashing the play back.  Gray scales
  59. are used in all modes with less than 256 colors due to obvious
  60. limitations.  If you have 256 colors or more you are prompted for the
  61. color format during playback.
  62.  
  63. Once the animation is running you use the mouse to alter the play back
  64. speed in real-time.  Left to right controls the speed, where left is fast
  65. and right is slow.  Move the mouse real slow as it's sort of touchy.
  66.  
  67. To exit press the right mouse button.  Pressing ESCape, or the the SPACE
  68. bar will also exit.
  69.  
  70. Selecting 'Cancel' in the file selector when prompted for the DL file
  71. exits the player.
  72.  
  73. You can also pass the player a command line by dropping DL files on top of
  74. it from the Desktop.  That is, if your Desktop supports this feature.  If
  75. activated this way the DL file is read, and played back as if you loaded
  76. it from the file selector as described above.
  77.  
  78. The utility uses the file extender to determine what type of file it is
  79. loading, so selecting files with invalid (non-DL) extenders will be
  80. rejected.
  81.  
  82.  
  83. ---- Notes ----
  84. Should any errors be detected, the program closes all open files and
  85. exits.
  86.  
  87. The entire DL file is loaded and converted to a playable form from ram, so
  88. lots of ram is a plus when using this player.  Currently the player does
  89. not support disk viewing, future version may or may not.  If you have a
  90. 256 color mode use it, a 24-bit mode only eats more memory per frame!
  91.  
  92. All screen access is handled through the VDI, even play back, with the
  93. hope that it will work on all ST compatible systems.  I have a TT and
  94. without feedback there's no way for me to resolve any possible problems on
  95. non-TT systems.
  96.  
  97. If you find a problem with the player or a specific DL file that won't
  98. play back properly you should send it to me for inspection.
  99.  
  100. The DL player was developed from scratch with _no_ documentaion on the DL
  101. file format, and all I had was a file editor.  I have no idea how they are
  102. created, but I do know that there is an older version of the format.  My
  103. player loads version '2' DL files since that's all I have to go by at this
  104. time.  If you have any scraps of info on the DL file format please send it
  105. to me.
  106.  
  107. I also have a CD-ROM with GL files, so perhaps soon GL files will be
  108. supported too!  Stay tuned...
  109.  
  110.  
  111. ---- Support ----
  112. This program is released as PostCardWare.
  113.  
  114. What this means is that all I want in return for it's use is simply a
  115. postcard.  The postcard lets me know that there are users out there using
  116. the program.  Just knowing that the program is being used is reward enough
  117. and it also tells me that my effort was not wasted.
  118.  
  119. So for the cost of one mere stamp, you'll have the satisfaction of knowing
  120. that you brightened someone else's day.
  121.  
  122. Do the right thing, mail your postcard today to:
  123.  
  124.    Lonny L Pursell
  125.    PO Box 145
  126.    Pandora  OH  45877
  127.    USA
  128.    Tel: (419)-384-3594  [after 4pm EST]
  129.  
  130. If it's not too much trouble, it would be nice if you listed the name and
  131. version of the program you are responding to and the details of the
  132. machine you are running it on.
  133.  
  134. Thanks for being an Atari user!
  135.  
  136.  
  137. ---- Credits ----
  138. Roger Burrows for writing and releasing ExtenDOS and opening up the world
  139. of CD-ROM to the Atari.
  140.  
  141. >> Your name could be listed here. <<
  142. Anyone who sends me some DL documentaion will be listed here!
  143.  
  144.  
  145. ---- Revision History ----
  146.   v0.01b  First release, basically a beta version.
  147.  
  148. [eof]
  149.