home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 1 / FishNMoreVol1.bin / more / graphics / viewers / showiff / show.doc < prev    next >
Text File  |  1987-03-17  |  4KB  |  108 lines
  1. SHOW x2.1
  2.  
  3. This program will show any standard IFF picture file: Lores-MedRes-HiRes-Hams.
  4.  
  5. Features:
  6.   Only 6600 bytes of code.
  7.   Faster loading time: it takes about 50% less than the old ShowAll.  For Lores
  8.     uncompressed IFF picture from ram, it takes only a blink of the eye.
  9.     From a disk drive, it loads about 10K of data per second.
  10.     (Just wonder what would happen if this entirely written in assembly
  11.     rather than pure C).
  12.   Less memory used: is uses only one screen of memory when showing the picture,
  13.   rather than buffering one screen prior to showing it.
  14.   Accepts more than one picture as an argument.
  15.  
  16. NEW on x2.0:
  17.   Timer is NOW user controlable.
  18.   Runable from CLI or Workbench.
  19. On x2.1:
  20.   Problem on failing to show certain picture is FIXED.
  21.  
  22.  
  23. To close the picture window:
  24.     1. Happens automatically when the timer expires.
  25.     2. Click upper left corner of the picture (invisible close gadget).
  26.     3. Press SPACE bar or ESCAPE key.
  27.         (ESCAPE will abort the showing of any additional pictures).
  28.  
  29. Usage:
  30. ~~~~~
  31. From CLI:
  32.  
  33.   SHOW [timer] [filename] [timer] [filename] .... [timer] [filename]
  34.  
  35. [timer] is optional, default timer is forever.  Well it is not actually
  36.     forever, you can wait to see how long it is :-).
  37.     Timer is specified by a minus '-' sign followed by a number.
  38.     Zero will also give you the default timer. If timer is not specified
  39.     for the next picture, the previous timer will be used.
  40. example:
  41.     SHOW a b c     -> will show a, b, and c until you close it.
  42.     SHOW a -5 b c  -> will show a forever, b and c for 5 secs.
  43.     SHOW -10 a b c -> will show a, b, and c for 10 secs each.
  44.     SHOW -5 a -7 b -> will show a for 5 secs and b for 7 secs.
  45.  
  46. NOTE: Regardless of the value set for the timer, if the close gadget, SPACE 
  47. BAR, or the ESCAPE key is pressed, the picture will close immediately.
  48.  
  49. From Workbench:
  50.  
  51. There are 3 ways you can use SHOW from Workbench.
  52.  
  53. 1. Give it a TOOL TYPE icon. Now you can click its icon and hold <SHIFT> key
  54.    down while clicking the icon(s) (of pictures you want to see) once, but
  55.    DOUBLE click the last one. <EXTENDED SELECTION>
  56.    This will work fine even if the picture has a TOOL TYPE icon. If the picture
  57.    has a PROJECT icon, be sure that its DEFAULT TOOL is empty or...
  58.  
  59. 2. Give your picture a PROJECT TYPE icon, and set the DEFAULT TOOL to this
  60.    SHOW program wherever you put it. Now just DOUBLE click the picture
  61.    icon, and it will load the SHOW first then show will handle it.
  62.    
  63. 3. COMBO of 1 and 2:
  64.    You can put SHOW wherever you want, as long as the FIRST icon you
  65.    selected is of part 2, you can hold <SHIFT> down and click more picture
  66.    icons (doesn't matter what type, my SHOW won't care), and double click
  67.    the last one.
  68.  
  69. Timer from the Workbench is passed on the TOOL TYPE BOX.
  70.     Format is "TIMER=#", where # is the number of secs you want.
  71.  
  72. To set it up:
  73.     1. Click the icon and select the "INFO" from WB menu.
  74.     2. Click the ADD gadget at the right most of the TOOL TYPE BOX.
  75.     3. Click inside the TOOL TYPE BOX and start typing "TIMER=5" for
  76.            example will set timer for 5 seconds.
  77.     4. Click the SAVE gadget at the bottom left. DONE.
  78.  
  79. Enjoy, if you like it I am happy. If you don't like it, oh well, you can
  80. always write your own.
  81.  
  82.  
  83. -------------------------------------------------------------------------------
  84. SHOW x2.0 Copyright 1987 by Andry Rachmat
  85.  
  86. This PROGRAM is copyrighted and all RIGHTS reserved.
  87. It is NOT a PUBLIC DOMAIN , however PERMISSION is granted to freely
  88. copy, use and redistribute this program, for non-commercial uses, as long 
  89. as this program is not altered in any way and is accompanied with this 
  90. document.
  91.  
  92. It is FORBIDDEN to use or include this program on ANY COMMERCIAL
  93. DISK or PRODUCT, without prior, written permission from the author.
  94. If you interested in using this program please contact me at addresses 
  95. below.
  96.  
  97. I make no warranties, either expressed or implied, with respect to the
  98. program described herein, its quality, performance, merchantability,
  99. or fitness for any particular purpose. This program is provided "as is"
  100. and the entire risk as to its quality and performance is with the user.
  101. -------------------------------------------------------------------------------
  102.  
  103. 10715 Roosevelt NE #7
  104. Seattle, WA 98125
  105. ------------------------------------------------------------------------------
  106. Spring 1987 - when flowers bloom and sun shines
  107.  
  108.