home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 314.lha / Zhow.doc < prev    next >
Encoding:
Text File  |  1989-12-05  |  6.6 KB  |  170 lines
  1.  
  2.             Zhow 1.1 - The ILBM Glider
  3.             ==========================
  4.  
  5.               ® Jonas Petersson & Sirius Soft
  6.  
  7.  
  8. "Oh no, yet another show program..."
  9.  
  10.   Well, you're right. I HAD to write it since no other program seemed to
  11. be written with any USEFULNESS in mind. Ok, there are quite a few that
  12. probably works well with a 640x200 Amiga but how about Europe? Not to 
  13. mention the really BIG pictures, you know that the Amiga officially
  14. supports resolutions that is 1Kx1K? Wouldn't it be nice to be able to
  15. look at them too...? As a bonus from the calculations needed to accomplish
  16. these things you have the possibility to "ZOOM" into pictures that are lores
  17. and/or interlaced.
  18.  
  19.   Another nice thing with this one is that it supports overscan and
  20. (yeach) workbench - even multiselections. It also shows the picture on
  21. a separate SCREEN, not only in a View, which means that it lets you
  22. do other things on some other screen, like showing other pictures...
  23.  
  24.   1.1 doesn't show the workbench screen between the pictures but rather
  25. an (almost) blank screen to make it serve better as a primitive slideshow.
  26. The blank screen uses your workbench colors 0 and 1, so you can
  27. choose your favorite colors (or make them the same if you don't like my
  28. little commercial ;-).
  29.  
  30.  
  31. Usage
  32. -----
  33.  
  34.  Like any other show program but with a little feature:
  35.  
  36.  
  37.    Zhow [-wWidth] [-hHeight] [-tTime] pictures
  38.  
  39.  When started with only the filename it will examine the picture size
  40. and from that and the workbench screen size decide what size the new
  41. screen containing the picture should be.
  42.  
  43.  When width and/or height are specified it will try to show the picture in
  44. a screen of THAT size. The Time is the maximum no of seconds that the
  45. picture will be shown. There is a little kludge if you happen to like naming
  46. your file something beginning with a '-' and then 'w', 'h' or 't'. Solution
  47. #1: rename you file ;-) , #2 give an illegal option (like '--') to terminate
  48. the option parsing. BTW, you may specify as many options as you like - 
  49. only the last one counts...
  50.  
  51.  When the picture is bigger than the screen, you will be able to 
  52. scroll around so that your mouse pointer always is on the spot it should
  53. have been if the picture had been the size of the screen. It might sound
  54. a bit strange but once you've tried it, you'll like it.
  55.  
  56.  There is really one more difference using height&depth or not: If you
  57. DON'T specify them, maximum screen usage is determined from the workbench
  58. screen as described above, but if you DO specify you'll be able to look
  59. att pictures in overscan. That is: any width up to 376 is shown in LORES
  60. on a screen of suitable size. HAM pictures can, of course,be any width
  61. they like, since there is no such thing as a HIRES HAM picture. Scrolling
  62. in HAM pictures gives nice effects on the left side of the screen as anyone 
  63. with some knowledge of HAM understands.
  64.  
  65.  
  66.  You can FREEZE the scrolling anytime by clicking the left mouse button.
  67. Click it again to UNFREEZE. There is an invisible dragbar and also the 
  68. screen depth gadgets. They might be a bit hard to find on very small and
  69. very big pictures though...
  70.  
  71.  You end by pressing the right mouse button or by pressing the ESC key
  72. or by waiting for the timeout (if you specified one).
  73.  
  74.  
  75.  Since it checks the workbench screen rather than doing some strange
  76. assumptions, it doesn't matter whether you have NTSC or PAL och have 
  77. MOREROWed etc. You'll get the size you LIKE! Personnally I have two 
  78. "aliases": 
  79.  
  80.     ILBM file  =>  zhow file
  81.     ZOOM file  =>  zhow -w320 -h256 file
  82.  
  83.  The first one works like any ordinary show while the other one makes it
  84. possible to examine a picture that is bigger than 320x256 closer.
  85. On small pictures it won't matter which I use.
  86.  
  87.  
  88. Notes:
  89. ------
  90.  
  91.  There seems to be a problem with screens that are smaller than about 
  92. 32x32 pixels. The picture ends up like garbage all over the first 32 lines.
  93. Seems like the problem isn't mine but rather CBM's... Not very much of
  94. a picture anyway.
  95.  
  96.  These very small pictures may cause another problem: If the height is less
  97. than the dragbar you will have trouble activating the picture once you 
  98. dectivate it. I use wKeys to avoid this.
  99.  
  100.  Another inconvenience shows up when scrolling around in an overscanned
  101. picture: CBM seems to stop the mouse pointer from moving to positions 
  102. outside the workbench screen rectangle and thus prevents you from
  103. scrolling to the corners. On the other hand - why should you ever want 
  104. to BOTH overscan AND scroll around? ONE of the alternatives is quite 
  105. enough to look at the whole picture...
  106.  
  107.  Right now it doesn't support color cycling. Let me know if you think
  108. it's needed.
  109.  
  110.  No serious bugs found (yet?). It might even work nice with the new chip set
  111. (that was my intention anyway). I've tried it with pictures as high as
  112. 1008 (maybe 1024) and as wide as 4096 - no problem.
  113.  
  114.  
  115. Future enhancements
  116. -------------------
  117.  
  118.  Possibly colorcycling and maybe scripts if there is an interest.
  119. This version is a FAST one, but that means that it uses a lot of memory
  120. when unpacking a big picture. I've been thinking of using a slower
  121. unpacker in case the last AllocMem() for the work space fails. Unfortunatly,
  122. that will make the program at bit bigger... We'll see. Argumentation for
  123. leaving it out now goes something like this: If you don't have enough
  124. memory to unpack it FAST, then you can't even THINK of loading it into
  125. a paint program, so the picture isn't of much use for you anyway...
  126.  
  127.  
  128. Revision history
  129. ----------------
  130. 1.1    Added ESC, timeout and (almost) blank screen during 
  131.     picture switches on demand from Matt Dillon, plus 
  132.     changed the option parsing.
  133.  
  134.  
  135. Distribution
  136. ------------
  137.  
  138.  Zhow is not public domain. A friend of mine advised me to call it
  139. "Freely Distributable Copyrighted" instead. That's close enough.  
  140. If You wish to include it with a commercial program feel free provided 
  141. that You send me a registered copy.
  142.  
  143.  Source code? You mean there is something to IMPROVE??? Right, send
  144. me a message then and I'll think about it...
  145.  
  146.  
  147.  Here is a list of "message ports" to me:
  148.  
  149.     Jonas 'Zaphod' Petersson
  150.     Ö Farmvägen 36 B
  151.     S-214 41 MALMÖ
  152.     SWEDEN
  153.     Phone: +46 40 120117
  154.  
  155.     Sysop on Amiga User Group Sweden's BBS2 (AbsExecBase)
  156.     IFNA 2:501/414  +46 40 977886, 300-14400 8N1 (HST)
  157.  
  158.     zaphod@{magrathea.sirius.se,slaka.UUCP}     /* These are Amigas! */
  159.     jp@malmax.maxcimator.se            /* At work  */
  160.     jonpe@majestix.ida.liuida.se        /* Postgrad */
  161.     D85.J-PETERSSON@LINUS.liuida.se        /* -- " --  */
  162.     nhs@asterix.liuida.se            /* Project  */
  163.     zaphod@idefix.ida.liuida.se            /* Not very reliable */
  164.  
  165.  
  166. Feel free to send comments, bug reports (huh?), money, coke, beer, girls...
  167.  
  168. Just a "Hi, I liked your program" is just as good as a few bucks - I didn't
  169. write this to make money out of it...
  170.