home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / tt / st2ttpic / st2ttpic.dox next >
Text File  |  1992-08-04  |  8KB  |  208 lines
  1.  
  2.                        ST to TT Picture Converter  v1.10
  3.                                  Documentation
  4.  
  5.                            Released on July 25, 1992
  6.  
  7.                   Copyright 1992 by Lonny L. Pursell and ENCOM
  8.                               All Rights Reserved.
  9.  
  10.  
  11.  
  12.  
  13. Archive Contents
  14. ----------------
  15.  
  16. This archive should contain the following files.
  17.  
  18.   ST2TTPIC.PRG    the utility program itself
  19.   ST2TTPIC.DOC    this doc file
  20.  
  21.  
  22. Introduction
  23. ------------
  24.  
  25.     This program will convert Spectrum 512 and GFA Raytrace files into
  26. Prism-Paint files.  Neither Spectrum or Raytrace function on the TT
  27. but why should that stop TT owners from viewing the images they can
  28. create.  I decided on Prism-Paint output since I own Prism-Paint and
  29. it supports TT low resolution.  Since Prism-Paint reads quite a few
  30. file formats, I see this program as a companion to Prism-Paint to fill in
  31. the gaps for users who would like Spectrum 512 support.  I threw in the
  32. Raytrace support since it is similar to Spectrum.
  33.  
  34.  
  35. This program is ShareWare!
  36. --------------------------
  37.  
  38.      All versions of this program are 'ShareWare', this means that if
  39. you decide to use it you're expected to pay for it.  You pay for the
  40. commercial programs you use, right?  Why not pay for the ShareWare you
  41. use as well?  Rememeber, ShareWare doesn't happen by accident.  The
  42. author spent time writing the software and relies on your honesty
  43. as an Atari Computer owner.
  44.  
  45. The registration fee is $5.00 ... or send what you think it's worth.
  46.  
  47.      If you do decide to use it, please send a check or money order
  48. in U.S. funds to...
  49.  
  50.      Lonny L Pursell
  51.      Attn ST2TTPIC
  52.      PO Box 145
  53.      Pandora  OH  45877  USA
  54.  
  55.      I thank you for your support!  Please remember, if you want to see
  56. more ShareWare programs like this, you have to do your part and pay for
  57. the ShareWware programs you use.
  58.  
  59. ----User Support----
  60.  
  61.     If you have an idea for a feature or want to report a bug (if any)
  62. then by all means contact me.  Please include the full name and
  63. version# of the program you are refering to.
  64.  
  65.     I can be reached by U.S. Mail at the address above or by telephone at
  66.       (419)-384-3594 [ask for Lonny]...
  67.  
  68.     I can also be reached on my FAVORITE multi-line BBS...
  69.  
  70.       CodeHead Quarters BBS
  71.       (213)-461-2095
  72.       1200/2400/9600 baud
  73.       Username: Lonny Pursell
  74.  
  75.  
  76. Before you get started
  77. ----------------------
  78.  
  79.     Runs on a TT030 in TT low resolution only.
  80.     Reads GFA Raytrace 'SUL' uncompressed files only.
  81.       Remember, Raytrace crashes on a TT so you'll need an ST or STE!
  82.       You must first uncompress the file you wish to convert.  To do this
  83.       you need to load GFA Raytrace and turn off the 'Compression' feature
  84.       under the 'Status' option from the editor.  Load the picture and
  85.       then resave it and it will be uncompressed.
  86.     Reads Spectrum 512 'SPU' uncompressed or 'SPC' compressed files.
  87.     Writes TT low rez uncompressed Prism-Paint 'PNT' files only.
  88.  
  89. ----To use the program----
  90.  
  91. Double-click on the program from the GEM Desktop.  The program uses
  92. the GEM interface so you'll soon see a menu bar at the top of the screen.
  93.  
  94. The drop down menus:
  95.  
  96.    DESK
  97.      Desktop Info        Displays the program credits.
  98.  
  99.    FILE
  100.      Load Spectrum 512   Loads a Spectrum 512 pic directly to the screen
  101.                          where it's scanned into an internal buffer.
  102.      Load GFA Raytrace   Loads a GFA Raytrace pic. (same as above)
  103.      Save Prism-Paint    Save the currently loaded pic to disk in
  104.                          Prism-Paint format.
  105.      Quit                Returns you to the GEM Desktop.
  106.  
  107.    VIEW
  108.      Color Info          Shows some statistics about the currently loaded
  109.                          pic like total colors, etc.
  110.      Show Picture        Redisplays the pic to the screen.  Press any key
  111.                          to exit.
  112.      Redraw Picture      Converts the image to TT low rez directly on the
  113.                          screen and averages out any colors beyond 256.
  114.                          Press any key to exit.
  115.  
  116.    Options
  117.      Full Size           When checked it scales the pic to full size
  118.                          and when not checked it draws the image pixel
  119.                          for pixel.
  120.  
  121.  
  122. Now for an example:
  123.     Select 'Load Spectrum 512' under the File menu and locate the picture
  124. file with the file selector.  You'll see what looks like a mess loaded
  125. to the screen and scanned line by line.  After that's done select 'Redraw
  126. Picture' under the View menu.  The Spectrum image will be transformed in
  127. TT low rez right before your very eyes.  Press any key to exit the pic
  128. and select 'Save Prism-Paint' under the File menu.  Save the pic to
  129. whatever drive you want with the file selector.  Keep in mind that
  130. the converted file will be about 160K in size.
  131.  
  132. Select 'Full Size' under the Options menu to change the size of the
  133. converted pic.  Select 'Redraw Picture' under the View menu to make
  134. the change.
  135.  
  136. After you've selected 'Redraw Picture' you can use 'Show Picture' to
  137. review the image instantly.  This is the image that will be saved to disk.
  138.  
  139.  
  140. Notes:
  141.    The way averaging works is like this.  If the pic has over 256 colors
  142. then the program totals up all the colors used per pixel and finds the
  143. least used color.  It then matches it to the closest possible color that's
  144. already in the pics palette.  This continues until the pic has exactly
  145. 256 colors.  Averaging isn't very fast, but it averages pretty good.
  146.  
  147.    When conveting the pics to TT low rez the program tries to insure
  148. that when it's loaded into Prism-Paint the background color won't be the
  149. same as the text color used by Prism-Paint's menus.  If the pic has less
  150. than 256 colors the background will be set to black and the text color
  151. will be set to white.  If the pic has more than 256 colors then the
  152. darkest color will be used for the background and the lightest color
  153. will be used for the text.
  154.  
  155.    If an error is detected all open files will be closed, and you will be
  156. alerted and the program will try to recover.
  157.  
  158.  
  159. About the program
  160. -----------------
  161.  
  162.     This program was written with GFA Basic 3.6TTe on an Atari TT030,
  163. 4meg ST RAM, TOS 3.06, and a PTC1426 color monitor.  I can't say for sure
  164. if it will run on lesser or newer machines.  Since I wrote the program
  165. without any docs on the GFA Raytrace file format or the Prism-Paint file
  166. format it's possible I over looked something important.  If anyone has any
  167. scrap of info on these file formats I would like to see it.  Future
  168. version might read compressed GFA Raytrace files and perphaps write GIF
  169. files or other formats that can also retain all 256 colors.  Please
  170. contact me if you have an docs on GIF, GFA Raytrace, or Prism-Paint
  171. that you would like to share.
  172.  
  173.  
  174. Acknowledgments
  175. ---------------
  176.  
  177. Atari, ST, Mega ST, STE, and TT030 are trademarks of Atari Corp.
  178. GEM, GEM Desktop, and DRI are trademarks of Digial Reasearch Inc.
  179. GFA and GFA Basic are trademarks of GFA Systemtechnik
  180. GFA Raytrace is (C)1989 by GFA Data Media Ltd.
  181. Spectrum 512 is (C)1987 by Trio Engineering, Inc.
  182. Prism-Paint is (C)1991 by Lexicor Software
  183. All other items are copyrighted/trademarked by their respective owners
  184.  
  185.  
  186. Disclaimer
  187. **********
  188.  
  189. This document and all versions of ST to TT Picture Converter are
  190. Copyright 1992 by Lonny L. Pursell and ENCOM
  191. All Rights Reserved.
  192.  
  193. ST to TT Picture Converter may not be sold.  It may, however, be freely
  194. distributed as long as this document is included and neither program nor
  195. document are modified in any way whatsoever.  This document may not be
  196. reprinted without prior permission from the author.
  197.  
  198. While every effort has been made to ensure that this program is free of
  199. bugs, I claim no responsiblity for any damage or loss of data resulting
  200. from the use or misuse of ST to TT Picture Converter.
  201.  
  202.  
  203. Revision history
  204. ----------------
  205.  
  206.   v1.00  first release
  207.   v1.10  added GFA Raytrace compressed SCL file support
  208.