home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / graphics / watch_it / watch_it.txt < prev   
Text File  |  1994-08-16  |  10KB  |  226 lines
  1. WATCH-IT - Picture Viewer for Atari ST/STE/TT/Falcon030     Version 1.0a
  2. -----------------------------------------------------------------------------
  3.  
  4. Author : Stefan Bock
  5. email  : sbock@informatik.uni-kl.de
  6.  
  7. All rights are reserved by the author.
  8.  
  9.  
  10. 1. What is it ?
  11. ----------------
  12.  
  13. WATCH-IT is a picture viewer for Atari ST/STE/TT/Falcon030 computers.
  14. It was planned as a viewer for the new Falcon computer only, supporting
  15. the 256-colour-resolution and the truecolour-resolution, but as it is a plain
  16. GEM-program, you can also start it on the "old" Ataris as well.
  17. WATCH-IT runs on all memory-configurations, but 512 KByte may be too small
  18. for big pictures.  
  19.  
  20.  
  21. 2. How to start it 
  22. -------------------
  23.  
  24. There are three ways to run the program:
  25.  
  26.   i) application : if you start WATCH-IT as an application, a file selector 
  27.                    will appear. Choose a picture file here (at the moment,
  28.                    only GIF is supported, others will follow soon).
  29.                    Once the file is loaded, depacked and transformed into a
  30.                    bitmap, it will be displayed in a window.
  31.  ii) commandline : starting the program from a shell or from the desktop with
  32.                    one or more filenames as arguments will load all specified
  33.                    files as long as
  34.                    - there are AES-windows left,
  35.                    - there is enough memory left and
  36.                    - the internal limit of 32 windows is not exceeded.
  37.                    WATCH-IT uses ARGV for extended commandlines.
  38. iii) accessory   : clicking on the menu entry will give you the file-selector
  39.                    where you can choose a picture (see i) ).
  40.  
  41.  
  42. 3. How to operate it
  43. ---------------------
  44.  
  45. - You can move and size the window as usual and scroll the picture with the
  46.   sliders if it is bigger than the window.
  47.   If you move the mouse over the window and the picture can be scrolled, the
  48.   arrow will change into a sort of cross-cursor which indicates the
  49.   directions the picture can be scrolled to (play around with this, it's easy).
  50.   Now press and hold the left mouse-button. The picture can be scrolled by
  51.   moving the mouse until the left button is released again.
  52.  
  53. - Cursor keys scroll the picture, too, and SHIFT+<cursor key> scrolls a page
  54.   at a time.
  55.  
  56. - A double-click on the picture or pressing <CONTROL>-I or <TAB> gives you
  57.   an information-window:
  58.   Here you find the width, height and palette size of the picture, the time
  59.   it took WATCH-IT to process the picture (including loading-time) and the
  60.   amount of RAM it uses.
  61.   Note that WATCH-IT uses some bufferspace during depacking and dithering,
  62.   so this displayed amount is smaller than the memory you need to process
  63.   the picture.
  64.   You will also find four buttons labeled "Greyscale", "Colour", "No dither"
  65.   and "FS-Dither". These are not selectable in this release, sorry, but
  66.   definitely will be in the next version, so you can choose your favourite
  67.   display-mode here. At the moment, a default mode is choosen depending on
  68.   the resolution (see below).
  69.                 
  70. - Pressing HELP reveals a help window.
  71.   Click on "OK" or press <RETURN> to close this window.
  72.  
  73. - Click on "LOAD" in the info/help-window or press <CONTROL>-O to load 
  74.   another picture. In accessory-mode clicking on the menu-entry has the same
  75.   effect.
  76.  
  77. - Press <CONTROL>-W to cycle through all open windows.
  78.  
  79. - Press <CONTROL>-U to close the actual window or
  80.         <CONTROL>-Q to close all windows (when the program has been started
  81.                                           as an application, this means "Quit") 
  82.  
  83.  
  84. 4. The picture format(s)
  85. ------------------------
  86.  
  87. At the moment this is only GIF format, but others will follow.
  88. If you have suggestions about what formats should be supported, please contact
  89. the author (format descriptions are welcome, too).
  90.  
  91. GIF-formats 87a and 89a can be loaded, even though WATCH-IT only inter-
  92. pretes the main picture data. I never came across a GIF-file with more
  93. than one picture in it, but if you have such pictures which you cannot
  94. display properly with WATCH-IT, tell me, perhaps i can change it.
  95.  
  96.       "The Graphics Interchange Format(c) is the Copyright property of
  97.       CompuServe Incorporated. GIF(sm) is a Service Mark property of
  98.       CompuServe Incorporated."
  99.  
  100.  
  101. 5. The display modes
  102. ---------------------
  103.  
  104. As mentioned earlier, WATCH-IT was written for the "Falcon resolutions",
  105. and pictures will definitely look best in these resolutions. Nevertheless
  106. I included dither-algorithms for monochrome and 16-colour-modes, too.
  107. Some more dither algorithms and greyscale modes are already finished, but
  108. didn't make it into this first release version, sorry.
  109. Note that pictures have to be processed in device-independant format and
  110. then transformed into the device-dependant format, this will take a little
  111. bit more time than writing the data directly into screen-memory, but is
  112. unavoidable in a GEM-program. On the other hand WATCH-IT will (at least it
  113. should :-)) run on all resolutions. If WATCH-IT does not run on your graphic-
  114. card, please let me know.
  115.  
  116.   i) Truecolour-mode:
  117.      This mode has only been tested on the Falcons truecolour-mode. It should
  118.      run on all resolutions with a device-independant format containing 16
  119.      planes, but i have no information about how RGB-values are coded on
  120.      other graphic-cards (they _should_ do it like the falcon, otherwise
  121.      the format would not be very device-independant, huh ?).
  122.      You can have multiple pictures at the same time each one having its
  123.      correct palette.
  124.      Hey, this is so great, if you don't have a FALCON, get one :-) !
  125.  
  126.  ii) 256-colour-mode:
  127.      This mode is used on resolutions with 8 planes, e.g. Falcon or TT-LOW.
  128.      The picture will be displayed without dithering.
  129.      Anyway, WATCH-IT never uses VDI-colours 0 to 15, since these colours
  130.      should be fixed for all applications. Instead, WATCH-IT shuffles around
  131.      the colours and substitutes similiar ones so that the VDI-colours don't
  132.      have to be used. 
  133.      Note that the palette can only be correct for the topped window, other
  134.      pictures may look quite strange. Simply top the window you wish to look at
  135.      and the correct palette is used.
  136.      By the way, pictures look a little bit like "widescreen" cinema on
  137.      TT-LOW. The reason is the strange pixel ratio on this resolution
  138.      (320 x 480). This may be fixed in future releases. 
  139.  
  140. iii) 16-colour-mode:
  141.      This mode is used on resolutions with 4 planes, e.g. TT-MID or ST-LOW.
  142.      It is the most time-consuming mode, since reducing 256 colours to 16
  143.      colours is not that easy. A special dither-algorithm is used (3 Floyd-
  144.      Steinberg-passes) so that all pictures can use the same palette, that
  145.      means you can have multiple windows which all look correct at the same
  146.      time). 
  147.      Pictures look best when viewed from some distance from the screen.
  148.      There are other possibilities to reduce the colours. An often used method
  149.      is to choose the 16 most used colours. This is definitely faster than
  150.      dithering, but in my opinion often has too poor results.
  151.      If you know better methods, please tell me !
  152.      Anyway, a 16 greyscale-mode will be included in future releases.
  153.  
  154.  iv) Monochrome-mode:
  155.      If none of the above modes can be used (e.g. on ST-HIGH, ST-MID or 
  156.      TT-HIGH), WATCH-IT will switch to monochrome-mode. 
  157.      The picture is dithered with Floyd-Steinberg error diffusion and 
  158.      displayed in VDI-colours 0 and 1. This normally means black and white,
  159.      but of course you can change this with the control panel (feel like 
  160.      Andy Warhol!) .
  161.        
  162.   
  163. 6. WATCH-IT and MultiTos 
  164. -------------------------
  165.  
  166. WATCH-IT runs under MultiTos, even though it can't handle it's own windows
  167. during depacking and dithering. This is so because depacker and plotter
  168. are written in highly optimized assembler and calling aes-functions
  169. during depack would slow down the whole thing significantly.
  170. However other applications can run during WATCH-IT does its work.
  171.  
  172. I consider writing a special MultiTos version which forks the depacker
  173. and ditherer so that they can run in the background while WATCH-IT-windows
  174. can still be moved.
  175. Any ideas about this (except from integrating the depacker into the
  176. event-loop which i definitely won't do !) are welcome !
  177.  
  178. Under MultiTos, no busy-bee is shown as this would be senseless in a
  179. multitasking environment.
  180.  
  181. The help and info-dialog are shown in windows, so dialog-boxes won't block
  182. the system.
  183.  
  184.  
  185. 7. Error messages
  186. ------------------
  187.  
  188. Out of AES-windows      : Close some windows and try again or get MultiTos
  189. Max. 32 windows allowed : This is the current limit.
  190. Read error in header,
  191.      palette or image   : The picture file is corrupted, you can try to
  192.                           load it anyway (press "Yes" in the "proceed ?" -
  193.                           alertbox), but the picture may look strange.
  194.  
  195.  
  196. 8. Disclaimer
  197. --------------
  198.  
  199. I really don't know how this program could harm you or your computer, but:
  200.  
  201. The author makes no warranties of quality or performance for this program.
  202. Use it at your own risk !
  203.  
  204.  
  205. 9. Feedback
  206. ------------
  207.  
  208. If you
  209. - have found bugs,
  210. - don't like the user interface,
  211. - can't get the program to work at all,
  212. - have good ideas how to improve this program,
  213. - or just want to say a few words concerning this program,
  214.  
  215. contact me via email:  sbock@informatik.uni-kl.de
  216.                        (this address will only be valid until end of
  217.                         september 1992)
  218. or in IRC (nickname : Robo).
  219.  
  220.  
  221.  
  222.  
  223.  
  224. Enjoy !
  225.  
  226.