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