home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 600-699 / ff654.lha / 2View / 2View.doc < prev    next >
Text File  |  1992-05-14  |  8KB  |  197 lines
  1.  
  2.                 2View V1.50
  3.       Written by Dave Schreiber. Released on March 24, 1992
  4.  
  5.      This program is Copyright 1991-1992 by Dave Schreiber,  All Rights
  6. Reserved.  2View is freely distributable, but the author retains all
  7. rights in regards to the program.  Permission is granted to distribute this
  8. program for a minimal charge (for copying, handling, etc.).
  9.  
  10.      The files Minrexx.o and Minrexx.h are exempt from this copyright, as I
  11. did not create them.
  12.  
  13.      2View is a IFF picture viewer, meant for use under Workbench 2.0, and
  14. thus will only operate under version 2.0 or later of the operating system;
  15. hopefully by the time you read this, 2.0 will be out for all Amigas.
  16.  
  17.      2View supports all Amiga display resolutions (lores, hires,
  18. interlaced, HAM, etc.), including Sliced-HAM (SHAM) and MacroPaint images
  19. (support for non-MacroPaint dynamic hires images isn't included yet;  2View
  20. isn't able to display them correctly).
  21.  
  22. Running 2View from the command line
  23. -----------------------------------
  24.  
  25.      There are two ways to specify what picture(s) you want to display:
  26. either directly, or through a playlist.  To use the command line, just list
  27. the files you want to display.    For example:
  28.  
  29.    2View Thatcher.pic Bush.iff Hussein
  30.  
  31. To do the same thing with a playlist, create a file with those three
  32. filenames, each on a separate line.  Assuming you called the file
  33. 'WorldLeaders', to display the pictures, do the following:
  34.  
  35.    2View from WorldLeaders
  36.  
  37.      There are also two ways to specify how to advance from picture to
  38. picture. If you used the command line above, you'd advance by pressing the
  39. left mouse button (2View only registers mouse clicks on active windows;  if
  40. you switch screens and click on another window, you need to click on the
  41. picture's screen twice (once to activate the screen's window, again to
  42. signal 2View)), or by pressing CTRL-C.    To abort a sequence of pictures in
  43. the middle, click on the right mouse button or type CTRL-D.
  44.  
  45.      You can also specify that 2View will advance to the next picture after
  46. a given time interval.    You can specify the time interval either in
  47. seconds, or 'ticks' (1/60ths of a second;  note: this was 1/50th of a
  48. second in previous releases). To specify a delay in seconds, use the
  49. keyword 'seconds' or 'secs', as such:
  50.  
  51.    2View from WorldLeaders secs 4
  52.  
  53. For ticks, the keyword is 'ticks'.  For example:
  54.  
  55.    2View Thatcher.pic Hussein ticks 23
  56.  
  57. Again, to abort the sequence early, press the right mouse button or CTRL-D.
  58. To advance to the next picture in the sequence before the time delay
  59. finishes, press the left mouse button or CTRL-C.
  60.  
  61.      Note that if you specify zero ticks or seconds, 2View will act as
  62. though you hadn't entered a time at all (and wait for you to press the left
  63. mouse button to advance).
  64.  
  65.      Finally, by using the keyword 'loop', you can tell 2View to start from
  66. the beginning once it gets through a list of pictures.    A final example,
  67. where the pictures 'Thatcher.pic' and 'Hussein' are displayed over and over
  68. until the right mouse button is pressed, follows:
  69.  
  70.    2View Thatcher.pic Hussein secs 1 loop
  71.  
  72. Running 2View from Workbench:
  73. -----------------------------
  74.  
  75.      You can display pictures from the Workbench by clicking on the
  76. picture's icon (or more than one picture's icon, if you want to display
  77. more than one picture), then (while holding down the shift key) double
  78. clicking on 2View's icon.  If you display more than one picture, you can
  79. advance to the next picture by pressing the left mouse button (or CTRL-C).
  80. You can quit in the middle of the pictures by pressing the right mouse
  81. button or CTRL-D.
  82.  
  83.      You can also display pictures using 2View by setting the 'Default
  84. Tool' field in the icon's Information window to point to 2View (for
  85. example, if you had 2View on a floppy named 'Stuff', in the directory
  86. 'Graphics', you would set the Default Tool field in a picture's icon to
  87. read 'Stuff:Graphics/2View').  Once you've done that, double clicking on
  88. the picture's icon is all that is required to display it
  89.  
  90.      Please note that pictures displayed from the Workbench will be shown
  91. until you click on a mouse button or press CTRL-C or CTRL-D;  timed
  92. advancement (along with playlists and looping) are not supported from the
  93. Workbench (yet).
  94.  
  95. Color Cycling:
  96. --------------
  97.  
  98.      If a range of colors in the image are suppossed to cycle, 2View will
  99. cycle them.  You can turn cycling off and on by pressing TAB.
  100.  
  101.      Note:  there are two types of color cycling currently in use on the
  102. Amiga.    The first, used in Deluxe Paint I through III, requires that the
  103. colors being cycling lie next to each other in the color pallette.  The
  104. second method, used in Deluxe Paint IV, allows any colors to be cycled
  105. without requiring them to be in one contiguous block.  2View supports both
  106. types of color cycling.
  107.  
  108. Printing:
  109. ---------
  110.  
  111.      You can print the pictures you display in 2View, either automatically
  112. or manually.  Manual printing is supported when using both the CLI and
  113. Workbench:  just press CTRL-P and a copy of the picture currently being
  114. shown will be printed out on your printer.
  115.  
  116.      Automatic printing (where each picture is printed as it is displayed)
  117. is supported only from the CLI. To use it, put the 'print' keyword on the
  118. command line.  For example:
  119.  
  120.      2View Major Thatcher print
  121.  
  122. would display 'Major', print it out, and wait for you to advance to the
  123. next picture.  Once you did, it would show and print 'Thatcher' and wait
  124. again for you to advance.
  125.  
  126.      Because of the unusual nature of SHAM and MacroPaint format pictures,
  127. the printing of such images isn't supported.
  128.  
  129. ARexx:
  130. -----
  131.  
  132.      2View has an ARexx port.  If you're familiar with ARexx, you can use
  133. it to get information on pictures as they are displayed, advance or abort,
  134. print pictures, etc (for example, by combining a playlist and an ARexx
  135. script, you could print out just the HAM pictures in a directory that
  136. contained pictures in a number of different formats).
  137.  
  138.      A list of ARexx commands supported by 2View is in the file
  139. 'ARexx.doc', and a sample script is provided under the name 'GetInfo.rx'.
  140. If you want more information on ARexx in general, consult chapter 10 of the
  141. 'Using the System Software' manual that came with your Amiga.
  142.  
  143. Miscellaneous
  144. -------------
  145.  
  146.      If you have a picture that is larger than the screen, you can scroll
  147. around in it by pressing and holding the left-Amiga key (or whatever keys
  148. you have specified under 'Mouse Screen Drag' in the 'IControl' preferences
  149. program), then pressing and holding the left mouse button while you move
  150. the mouse around.
  151.  
  152.      If you have a file you want to display that has a name that is
  153. identical to a 2View command line option, use the 'file' keyword before
  154. those filenames.  For example, if you wanted to show the files 'loop' and
  155. 'print':
  156.    2View loop print
  157. will produce an error.    However,
  158.    2View file loop file print
  159. will work fine.
  160.  
  161.      As you've probably noticed, the source to 2View comes with this
  162. distribution.  To compile (using SAS/C V5.10a), type the following on the
  163. command line, while in the source directory:
  164.  
  165.    lc -v 2View ARexx
  166.    lc -v -b0 Misc
  167.    asm 2ViewAsm.a
  168.    blink with 2View.lnk
  169.  
  170. Please note that you need to have the file 'rexxglue.o' in your LIB:
  171. directory.  'Rexxglue.o' is found in the developers directory on the
  172. commercial version of ARexx.
  173.  
  174. Bugs/Limitations:
  175.      The support for MacroPaint images is woefully undertested.  I only
  176. have two MacroPaint images to work with (Astronaut.mp and FB111.mp, both in
  177. the distribution of the MacroPaint picture viewer Shazam), and thus can't
  178. guarantee that non-interlaced or overscan MacroPaint images will display
  179. correctly.  I intend to rectify this in the future by adding true dynamic
  180. hires support, which will mean support for all MacroPaint images
  181. automatically (the MacroPaint format is a scaled down version of Dynamic
  182. Hires as defined by NewTek).
  183.      2View seems to occassionally crash when displayed ILBM brushes.  I'd
  184. thus recommend not using 2View for this purpose until the bug is fixed.
  185.  
  186.      That's it!  If you have any questions or comments regarding this
  187. program, please feel free to get in touch with me at the following
  188. addresses:
  189.  
  190.                       Dave Schreiber
  191.                       1234 Collins Lane
  192.                       San Jose, CA     95129-4208
  193. email:                      davids@cats.ucsc.edu
  194.  
  195.  
  196.  
  197.