home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 329.lha / Show_v2.0 / Show.doc.pp / Show.doc
Text File  |  1990-01-05  |  10KB  |  201 lines
  1.  
  2.                                  Show 2.0
  3.  
  4.                             by Sebastiano Vigna
  5.  
  6.     There are many public-domain utilities which show IFF ILBM files.
  7. None of those I've seen 'til now meets the goal:  every program has its
  8. idiosyncrasies.  If you can display overscan pictures, then every picture
  9. with more than 640 pixel on a line will be shifted as 700 pixel ones; if
  10. you want to see a directory of pictures, you must enter the single
  11. filenames; some programs crash with PAL pictures; some others do the same
  12. with pictures larger than any screen; you never have an option to force a
  13. screen mode (for the tech-folks out there:  old IFF ILBM files don't have
  14. the CAMG chunk!); you can't use a comfortable file requester when you don't
  15. know exactly the name of the file (who can remember GRABBiT file names?);
  16. often you can't press the right mouse button, or a useless drag bar will
  17. corrupt the picture...
  18.  
  19.     If one program has one feature, lacks another, so I decided to
  20. write a show utility; but I surely never succeeded if I didn't have the
  21. best friend of an Amiga programmer:  the ARP library.  If I had been able
  22. to write Show, it's only to ARP's credit.  Pattern matching, resource
  23. tracking, powerful resident functions...  The only drawback is that you
  24. MUST have the arp.library (V39!) in your libs:  directory in order to run
  25. Show.  Otherwise, a message will be displayed, and Show will refuse to run.
  26. Note that you can't run Show from Workbench:  it works only from CLI.
  27. Sorry.  As a reward, it's re-usable, yet not pure, i.e.  you can make it
  28. resident and use it many times, but you can't run it in many CLI at the
  29. same time.
  30.  
  31.     Show can process ANY IFF ILBM file (including Photon Paint files,
  32. Excellence!  files etc.); this means not only IFF ILBM FORMs, but also
  33. nested ILBM, FTXT, etc.  FORMs, CATs, LISTs and PROPs!  It will always try
  34. to find the screen type that fits the best, and won't give up if you want
  35. to see 1x1 brushes or VERY large pictures (I tried upto 2048x2048).
  36. Nevertheless, you can force the screen type with several options.  The
  37. program won't show you cycles from programs like DeLuxePaint.  I don't
  38. think cycling is "standard IFF".  It's "standard EA".
  39.  
  40.  
  41. To get the syntax in AmigaDOS/ARP style type:
  42.  
  43.         Show ?
  44.  
  45. This will give you:
  46.  
  47. Files/...,Secs/k,F=Fade/k,N=NOMOUSE/s,R=REPEAT/s,C=CENTER/s,
  48. B=BLACKBACKGROUND/s,NOFASTDRAW/s,Width/k,Height/k,ALL/s,
  49. HIRES/s,LACE/s,LORES/s,NOLACE/s,HAM/s,HALFBRITE/s:
  50.  
  51. If you ask more help with "?", you will see:
  52.  
  53. Show 2.0 © 1990 Sebastiano Vigna
  54. Usage: Show <wildcards [...] | !> [SECS seconds] [FADE speed]
  55.     [NOMOUSE] [REPEAT] [CENTER] [BLACKBACKGROUND]
  56.     [NOFASTDRAW] [WIDTH width] [HEIGHT height] [ALL]
  57.     [HIRES | LORES] [LACE | NOLACE] [HAM | HALFBRITE]
  58.  
  59. The same help is displayed if you call Show with no argument.
  60.  
  61.     The first argument for Show is a list of patterns (or file names)
  62. as long as you want; you will get every picture that match one of the
  63. patterns.
  64.     Alternatively, you can give only the "!" character, that will
  65. display the famous Heath File Requester and will make you able to scan the
  66. entire file system.
  67.     When you're tired of looking at your picture, take the mouse
  68. pointer at the very top of the screen and press the right button (you can
  69. also simply press the RETURN, SPACE or ESCAPE keys).  You can always drag
  70. or depth-arrange the screen (the gadgets seem not to be there, but they do
  71. really are!) with the left mouse button.  To stop a pattern matching search
  72. use CTRL-C.
  73.     If the screen size is for some reasons less than the size of the
  74. picture, you can move around with cursor keys alone (8 pixels), ALTed (16
  75. pixels, lowest=weakest), SHIFTed (64 pixels) or CTRLed (128 pixels,
  76. highest=strongest).  A noteworthy feature of Show is that the picture is
  77. NOT decrunched one time for all in a VERY large chunk of memory:  a fast LM
  78. routine decrunches the file in real-time every time you move (the routine
  79. could indeed be faster, but it has lot of controls to get rid of damaged
  80. IFF BODY chunks; safety always first).  This is not as fast as the
  81. memory-eating method, but I think it's MUCH better!  Very huge pictures
  82. (e.g., 800x900) will be shown in a full screen (generated on the fly at
  83. Workbench size) from which you can move around.  Overscan pictures will
  84. retain their size of it's not greater than 400x300 lo-res pixels (400x250
  85. on a NTSC Amiga).
  86.     A weird effect of this method is that you can see pictures that
  87. can't be even *LOADED* in your Amiga.  Let's suppose you have a really
  88. crunched picture; the BODY chunk and a 256x256 lo-res screen could take
  89. much less than the decrunched picture, so you could create pictures that
  90. only Show 2.0 could let you see in all of their parts.  Why would you want
  91. to do this, well, that's another matter.
  92.  
  93.     The second (optional, as any of the remaining) argument is the
  94. keyword SECS followed by a number between 1 and 1000.  Show will check
  95. neither the right mouse button nor CURSOR/RETURN/SPACE/ESCAPE/CTRL-C, and
  96. will display the picture for the number of seconds specified.
  97.  
  98.     The third argument lets you specify a FADE speed (between 1 and 4)
  99. at which you want to fade in/out every picture.  The higher the number, the
  100. slower the fade.  Note that HAM pictures can't be faded.
  101.  
  102.         Now we have a lot of options:
  103.  -  NOMOUSE will kill the mouse pointer while Show is displaying a picture;
  104.  -  REPEAT will endless restart from the first pattern when it has finished
  105. with the last;
  106.  -  CENTER will force the screen to be centered (640x200 pictures on PAL
  107. screens look so ugly...) and will of course overscan if needed;
  108.  -  BLACKBACKGROUND will create a 0-bitplane (almost no memory consuming!)
  109. black screen that will stay until you saw the last picture.
  110. Aesthetical-only.
  111.  
  112.     All of the preceeding options can be shortened with their first
  113. letter.  Please note that centering is done via Preferences, i.e.  EVERY
  114. screen open will be silently "moved".  Watch out for side-effects.
  115.  
  116.  -  NOFASTDRAW leaves the program at priority 0; by default, Show will
  117. surround the BODY decrunching operations with a SetTaskPri(1):  this will
  118. not lock the system, but in a multitasking situation Show will perform fast
  119. when needed;
  120.  -  WIDTH and HEIGHT want an argument that specify the dimensions of the
  121. show screen (WIDTH will be padded to the next word boundary).  However,
  122. Show is an intelligent program, and will almost always find by itself the
  123. right screen.  WARNING:  dimensions allowed are from 64 to 1024, at your
  124. own risk.  Your Amiga won't crash, but weird things can happen...
  125.  -  ALL scans recursively all of the subdirectories during the wildcard
  126. search.
  127.  
  128.     Now, graphics options.  You can force all screens to be HIRES or
  129. LORES, (inter)LACE or NO(inter)LACE, to be HAM or (EXTRA_)HALFBRITE.  Note
  130. that if Show find as six bitplanes picture with no indications (i.e.  no
  131. CAMG chunk), it won't set by default the HAM flag.
  132.  
  133.  
  134.     And now, some examples:
  135.  
  136. SHOW MyPics:* SECS 5 FADE 0 NOMOUSE BLACKBACKGROUND REPEAT CENTER ALL
  137.  
  138. will generate a real (and endless!) slide show of the pictures in the
  139. MyPics:  dir and in all its subdirs, centered and with no mouse hanging
  140. around.  Note that in order to stop the slide show, you must put in front
  141. the Workbench screen with the AMIGA-N keys, quickly select the Show CLI
  142. window and press CTRL-C.  With the SECS option, CTRL-C during screen
  143. displays is not checked.  WARNING:  I found out that if you use DMouse and
  144. you want to send back a picture using the two mouse buttons, the system can
  145. deadlock!  (A strange interaction with the 0-depth screen?) Use AMIGA-N.
  146.  
  147. SHOW df0:*.image df0:pictures/*.pic HIRES LACE
  148.  
  149. will show the files ending with .image on the drive df0:  and the files
  150. ending with .pic in the directory df0:pictures forcing (if possible) Show
  151. to use always high resolution, interlaced screens.  Usually, setting the
  152. HIRES flag on pictures with more than 4 bitplanes leads you to see
  153. absolutely nothing.
  154.  
  155. SHOW dh0:hirespic LORES NOLACE
  156.  
  157. will show an hi-res picture in lo-res, i.e.  "zooming in".  You can move
  158. around with cursor keys, as above.
  159.  
  160. WIDTH and HEIGHT can be usefull when you have a picture that cannot be
  161. displayed because there's not enough Chip RAM (usually, you got the "Can't
  162. open Screen" error message).  Try then:
  163.  
  164. Show pic WIDTH 128 HEIGHT 128
  165.  
  166. This, usually, will allow you to peek something.
  167.  
  168.  
  169.  
  170.  
  171.                                Credits, etc.
  172.  
  173.     I am proud to announce that Show showed perfectly .LBM files of an
  174. MS-DOS known game directly from the original disk (via CrossDos, of
  175. course).
  176.  
  177.     I wish to thank some people, first of all the ARP team for the
  178. arp.library and John Toebes at Lattice for the best Amiga C.  Speed and
  179. compactness of Show come from the fabulous 5.04 release.  Dulcis in fundo
  180. (I like SO much latin!) thanks to Luca Spada (the SkyLink SysOp) for his
  181. enthusiasm about Show 1.0, that persuaded me to create a 2.0 version.
  182.  
  183.     A word about debugging:  I don't have much time to debug, so maybe
  184. some nasty bugs are lurking around the code.  If you find something please
  185. write me or leave me a message at BIX.  Comments, suggestions, as well as
  186. $, are definitively welcome.
  187.  
  188.     This software is not exactly public domain.  It is freely
  189. distributable, copyrighted software.  You can copy it, spread it, use it,
  190. include it in commercial packages as a "bonus" at no fee, but you cannot
  191. sell it.  This brief note should always stay together with the program.  I
  192. hope Show will help you to enjoy more (if possible) your Amiga.
  193.  
  194.                             Sebastiano Vigna
  195.                             BIX:  svigna
  196.  
  197. Address:
  198. Sebastiano Vigna
  199. Via Valparaiso, 18
  200. 20144 MILANO Italia
  201.