home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / graphics / view132 / viewttst.txt < prev   
Text File  |  1992-10-11  |  8KB  |  200 lines
  1.                               View ST/TT v1.32
  2.                               ----------------
  3.  
  4. Copyright 1992 by Copson of Unit Seventeen, Sweden. All rights reserved.
  5.  
  6. The programs may only be copied unaltered with this text attached to it.
  7.  
  8.  
  9. MANIFEST
  10. --------
  11. The archive should contain following files:
  12.  
  13. VIEW_TT.PRG   -  The Viewer for a MC68030-based computer (TT)
  14. VIEW_ST.PRG   -  The Viewer for a MC68000-based computer (ST/STe)
  15. VIEWTTST.TXT  -  This text
  16.  
  17.  
  18. DESCRIPTION
  19. -----------
  20. With this program you can show pictures in various formats in either ST-Low,
  21. ST-Medium, ST-High, TT-Low or TT-Medium on the Atari TT030 and ST-Low on
  22. the Atari ST and STe. It can also use the current VDI-resolution and might
  23. even work together with screen enhancements such as overscan or screen
  24. doublers.
  25.  
  26. The formats supported so far is:
  27.  
  28. TGA         Truevision Targa. 16, 24 and 32-bit true color pictures.
  29. RAW         Output format from the QRT raytracer. 24-bit true color.
  30. IMG         Output format from the Vivid raytracer on the PC, not to
  31.             be confused with the GEM-Image-Format. 24-bit true color.
  32. IFF HAM     IFF Hold And Modify from Commodore Amiga. Max 4096 colors.
  33. IFF ILBM    IFF Interleaved bitmap. Max 256 colors.
  34. GIF87a      Graphics Intechange Format by CompuServe. Max 256 colors.
  35. SPC, SPU    Spectrum 512 pictures compressed and uncompressed.
  36. PI?, PC?    Degas and Degas Elite pictures, compressed and uncompressed.
  37. NEO         Neochrome low resolution.
  38. ART         Art Director low resolution.
  39. DOO         Doodle high resolution.
  40. IMG         GEM-Image format, 1 bitplane.
  41.  
  42. The special thing with this program compared to others, is its ability to
  43. view the pictures quick and easy in different screen resolutions, without
  44. having to restart the program and change resolution manually. The program
  45. is of course coded in assembly language to make it as fast as possible.
  46.  
  47. All pictures are expanded to its true colors and are then reduced to the
  48. number of colors of the resolution which it is to be shown in. For example,
  49. if a TGA-picture with 16M colors are to be shown in TT-Low, it first loads
  50. the picture in the memory and then reduces it to 256 unique colors. This
  51. method consumes lots of memory, so don't expect to show extremely big
  52. pictures if you aren't equipped with extremely much memory...
  53. No kind of dithering is currently used for either resolution, so don't expect
  54. too much from true color pictures on the ST/STe...
  55.  
  56. IFF-pictures (ILBM) from the PC often contains a so called Tiny-picture, which
  57. is a reduction of the original picture which are shown in the fileselctor in
  58. Deluxe Paint for the PC. This program can also display the Tiny-picture and
  59. textchunks contained in the picture.
  60.  
  61. View TT is optimized especially for the 68030 and should run on the Atari
  62. TT030 as well as an ST equipped with a 030-board.
  63.  
  64. View ST runs both on the ST and TT.
  65.  
  66. HOW TO USE THE PROGRAM
  67. ----------------------
  68. The program can either be started with a commandline which contains the file
  69. to be showed, or without any arguments. In the later case a fileselector
  70. appears in which you choose your picture from.
  71.  
  72. The program loads the picture and unpacks it to memory. You choose which
  73. resolution you want to see it in, from the main alert. Your choices are:
  74.  
  75. ST: This button shows an alert with the three ST-resolutions, ST-Low,
  76.     ST-Medium and ST-High. If you choose an illegal button, the program
  77.     shows a error message.
  78.  
  79. TT: This button shows an alert with the two TT-resolutions for color:
  80.     TT-Low and TT-Medium. The third button is named Current and shows the
  81.     picture in the current resolution. This is useful if you run in a non-
  82.     standard resolution such as interlace. The programs then tries to read
  83.     the screen parameters from the VDI and use these.
  84.  
  85. When you have choose your resolution, the program displays the picture.
  86. You can now use the keys to expand or move the picture. When you press Undo
  87. you are returned to the resolution alert, and you can choose to show the
  88. picture in a different resolution or to load a new one.
  89.  
  90. You quit the program by choosing Cancel in the fileselector.
  91.  
  92.  
  93. KEYBOARD COMMANDS
  94. -----------------
  95.  
  96. Arrows      If the picture is larger than the screen, you can use the arrows to
  97.             scroll around in the picture. If it is smaller than the screen, the
  98.             arrows are used to move around the picture on the screen. The
  99.             movement is exponential, the longer you press down the key, the
  100.             faster is the movement.
  101.  
  102. S           Save picture in Degas or Degas Extended format, see description
  103.             below. You are confronted with a fileselector in which you choose
  104.             filename for the picture to be saved.
  105.  
  106. R           Save picture in QRT's RAW-format. Mainly to be used with the
  107.             Photochrome program to view pictures with many colors on an ST or
  108.             STe. This function is only availible in ST-Low. The program always
  109.             saves what is shown on the screen to a file. It is therefore
  110.             possible to zoom or reduce the picture so it fits the screen
  111.             before saving it.
  112.  
  113. T           If an IFF-picture contains a reduced image, a TINY, this could
  114.             be viewed with this key. IFF-pictures which are drawn with Deluxe
  115.             Paint on the PC can contain such images.
  116.  
  117. C           Center picture. If the picture is smaller than the screen, this
  118.             aligns the picture in the middle of the screen. If the picture is
  119.             bigger, no action is taken.
  120.  
  121. I           Zoom in picture at y-axis. Exponential increase.
  122.  
  123. O           Zoom out picture at y-axis. Exponential increase.
  124.  
  125. X           Zooms the picture in x-axis in four steps: (Previous D-key)
  126.             100%, 50%, 25% and 12,5%
  127. Y           Zooms the picture in y-axis in four precalculated steps:
  128.             200%, 100%, 50% and 25%.
  129.  
  130. Undo        Return to the main alert.
  131.  
  132. Help        Shows a alertbox with descriptions of the key commands.
  133.  
  134.  
  135. EXTENDED DEGAS FORMAT
  136. ---------------------
  137. For saving the pictures, I have extended the standard Degas-format PI0 to
  138. the TT-resolutions. Following is a description of the format I use:
  139.  
  140.                ST-Low                  TT-Low                  TT-Medium
  141.  
  142. Extension      PI0                     PI4                     PI5
  143. Resolution     1 word: $0000           1 word: $0007           1 word: $0004
  144. Colormap       16 word                 256 word                16 word
  145. Bitmap         32000 bytes             153600 bytes            153600 bytes
  146. Total length   32034 bytes             154114 bytes            153634 bytes
  147.  
  148. DISCLAIMER
  149. ----------
  150. I don't have any responsibilities for any typ of damage caused by using
  151. this program.
  152.  
  153. This program is Freeware, which means that it is free for everyone to use
  154. without having to pay anything. It is free to be copied only if no changes
  155. are made to the archive itself or the files in the archive. I claim to have
  156. copyright on the code, so if you rip anything, you could at least mention
  157. me as the original author...
  158.  
  159. If you find the program useful and would like further development, by
  160. supporting more formats or future screenresolutions (e.g. F030-rez),
  161. send me your comments on a nice postcard. If I don't get any responce to
  162. the program, it is not likely to continue to grow... Future enhancements
  163. planned are RSC-interface, more formats, more resolutions, but that depends
  164. on YOU!
  165.  
  166. Have fun with the program!
  167.  
  168. PLEASE SUPPORT SHAREWARE AUTHORS!
  169.  
  170.  
  171. SOURCES
  172. -------
  173. ST Picture Formats edited by David M. Bagget
  174. Spectrum 512-viewer from ST Magazin by Enno Borgsteede
  175. GIF(tm)-unpacking routine in assembler by Lars Brinkhoff
  176. JPEG-sources for the PC
  177. GIF(tm) Specification
  178. and of course the ATARI ST Profibuch by Sybex Verlag, GmbH
  179.  
  180. Thanks to my betatesters Elof, Jason and Knightman of Unit Seventeen,
  181. Roine Stenberg and Niklas Nylin.
  182.  
  183. GIF is a trademark of CompuServe, Incorporated.
  184.  
  185.  
  186. ADDRESSES OF THE AUTHOR
  187. -----------------------
  188.  
  189. Fido Netmail:
  190. Conny Pettersson, 2:204/419.5
  191.  
  192. Email (FidoNet Gateway):
  193. Conny_Pettersson@p5.f419.n204.z2.fidonet.cd.chalmers.se
  194.  
  195. By Letter:
  196. Conny Pettersson
  197. Hovetorpsgatan 66
  198. S-582 64  LINKOEPING
  199. SWEDEN
  200.