home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 559a.lha / 2View_v1.11 / 2View.doc.pp / 2View.doc
Encoding:
Text File  |  1991-10-05  |  6.4 KB  |  160 lines
  1.  
  2.                   2View V1.11
  3.      Written by Dave Schreiber.  Released on September 11, 1991
  4.  
  5.      This program is Copyright 1991 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. Running 2View from the command line
  18. -----------------------------------
  19.  
  20.      There are two ways to specify what picture(s) you want to display:
  21. either directly, or through a playlist.  To use the command line, just list
  22. the files you want to display.    For example:
  23.  
  24.    2View Thatcher.pic Bush.iff Hussein
  25.  
  26. To do the same thing with a playlist, create a file with those three
  27. filenames, each on a separate line.  Assuming you called the file
  28. 'WorldLeaders', to display the pictures, do the following:
  29.  
  30.    2View from WorldLeaders
  31.  
  32.      There are also two ways to specify how to advance from picture to
  33. picture. If you used the command line above, you'd advance by pressing the
  34. left mouse button (2View only registers mouse clicks on active windows;  if
  35. you switch screens and click on another window, you need to click on the
  36. picture's screen twice (once to activate the screen's window, again to
  37. signal 2View)), or by pressing CTRL-C.    To abort a sequence of pictures in
  38. the middle, click on the right mouse button or type CTRL-D.
  39.  
  40.      You can also specify that 2View will advance to the next picture after
  41. a given time interval.    You can specify the time interval either in
  42. seconds, or 'ticks' (1/50ths of a second).  To specify a delay in seconds,
  43. use the keyword 'seconds' or 'secs', as such:
  44.  
  45.    2View from WorldLeaders secs 4
  46.  
  47. For ticks, the keyword is 'ticks'.  For example:
  48.  
  49.    2View Thatcher.pic Hussein ticks 23
  50.  
  51. Again, to abort the sequence early, press the right mouse button or CTRL-D.
  52. To advance to the next picture in the sequence before the time delay
  53. finishes, press the left mouse button or CTRL-C.
  54.  
  55.      Note that if you specify zero ticks or seconds, 2View will act as
  56. though you hadn't entered a time at all (and wait for you to press the left
  57. mouse button to advance).
  58.  
  59.  
  60.      Finally, by using the keyword 'loop', you can tell 2View to start from
  61. the beginning once it gets through a list of pictures.    A final example,
  62. where the pictures 'Thatcher.pic' and 'Hussein' are displayed over and over
  63. until the right mouse button is pressed, follows:
  64.  
  65.    2View Thatcher.pic Hussein secs 1 loop
  66.  
  67. Running 2View from Workbench:
  68. -----------------------------
  69.  
  70.      You can display pictures from the Workbench by clicking on the
  71. picture's icon (or more than one picture's icon, if you want to display
  72. more than one picture), then (while holding down the shift key) double
  73. clicking on 2View's icon.  If you display more than one picture, you can
  74. advance to the next picture by pressing the left mouse button (or CTRL-C).
  75. You can quit in the middle of the pictures by pressing the right mouse
  76. button or CTRL-D.
  77.  
  78.      You can also display pictures using 2View by setting the 'Default
  79. Tool' field in the icon's Information window to point to 2View (for
  80. example, if you had 2View on a floppy named 'Stuff', in the directory
  81. 'Graphics', you would set the Default Tool field in a picture's icon to
  82. read 'Stuff:Graphics/2View').  Once you've done that, double clicking on
  83. the picture's icon is all that is required to display it
  84.  
  85.      Please note that pictures displayed from the Workbench will be shown
  86. until you click on a mouse button or press CTRL-C or CTRL-D;  timed
  87. advancement (along with playlists and looping) are not supported from the
  88. Workbench (yet).
  89.  
  90. Printing:
  91. ---------
  92.  
  93.      You can print the pictures you display in 2View, either automatically
  94. or manually.  Manual printing is supported when using both the CLI and
  95. Workbench:  just press CTRL-P and a copy of the picture currently being
  96. shown will be printed out on your printer.
  97.  
  98.      Automatic printing (where each picture is printed as it is displayed)
  99. is supported only from the CLI. To use it, put the 'print' keyword on the
  100. command line.  For example:
  101.  
  102.      2View Major Thatcher print
  103.  
  104. would display 'Major', print it out, and wait for you to advance to the
  105. next picture.  Once you did, it would show and print 'Thatcher' and wait
  106. again for you to advance.
  107.  
  108. ARexx:
  109. -----
  110.  
  111.      2View has an ARexx port.  If you're familiar with ARexx, you can use
  112. it to get information on pictures as they are displayed, advance or abort,
  113. print pictures, etc (for example, by combining a playlist and an ARexx
  114. script, you could print out just the HAM pictures in a directory that
  115. contained pictures in a number of different formats).
  116.  
  117.      A list of ARexx commands supported by 2View is in the file
  118. 'ARexx.doc', and a sample script is provided under the name 'GetInfo.rx'.
  119. If you want more information on ARexx in general, consult chapter 10 of the
  120. 'Using the System Software' manual that came with your Amiga.
  121.  
  122. Miscellaneous
  123. -------------
  124.  
  125.      If you have a picture that is larger than the screen, you can scroll
  126. around in it by pressing and holding the left-Amiga key (or whatever keys
  127. you have specified under 'Mouse Screen Drag' in the 'IControl' preferences
  128. program), then pressing and holding the left mouse button while you move
  129. the mouse around.
  130.  
  131.      If you have a file you want to display that has a name that is
  132. identical to a 2View comman dline option. use the 'file' keyword before
  133. those filenames.  For example, if you wanted to show the files 'loop' and
  134. 'print':
  135.    2View loop print
  136. will produce the error.  However,
  137.    2View file loop file print
  138. will work fine.
  139.  
  140.      As you've probably noticed, the source to 2View comes with this
  141. distribution.  To compile (using SAS/C V5.10a), type the following on the
  142. command line, while in the source directory:
  143.  
  144.    lc -v 2View ARexx
  145.    blink with 2View.lnk
  146.  
  147. Please note that you need to have the file 'rexxglue.o' in your LIB:
  148. directory.  'Rexxglue.o' is found in the developers directory on the
  149. commercial version of ARexx.
  150.  
  151.      That's it!  If you have any questions or comments regarding this
  152. program, please feel free to get in touch with me at the following
  153. addresses:
  154.  
  155.                       Dave Schreiber
  156.                       1234 Collins Lane
  157.                       San Jose, CA     95129-4208
  158. email:                      davids@ucscb.ucsc.edu
  159.  
  160.