home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 1 / FishNMoreVol1.bin / more / graphics / viewers / superview3.0 / sv3.zoo / superview3.0.doc < prev   
Text File  |  1989-09-20  |  14KB  |  411 lines
  1.  
  2.     SuperView,   A IFF display program.  by  David  Grothe  V 3.0
  3.     Release Date   09-20-89
  4.  
  5.     *
  6.     * Copyright 1989 by David Grothe
  7.     * All rights reserved.
  8.     *
  9.     * This program is Shareware,  if you use this program
  10.     * please send $10 to: 
  11.     *
  12.     * David Grothe
  13.     * 20 SW 39th
  14.     * Okla City, OK  73109
  15.     *
  16.     * If you have sent in the shareware on version 2x, then you 
  17.     * need not send in anymore money.  
  18.     *
  19.     * You may pass the program around as long as this Doc file 
  20.     * remains a part of it.
  21.     *
  22.     * If you would like to distribute this program with your 
  23.     * software, you must contact me first.
  24.     * 
  25.  
  26.  
  27. SuperView is a program that will display IFF pictures of all types 
  28. on the Amiga.  The program supports the following features:
  29.  
  30.     Multiple files on one command line.
  31.     WorkBench  (icons) are supported.
  32.     All display modes supported.
  33.     Auto Overscan
  34.     Color Cycle ( DPaint and GraphiCraft types)  CRNG  CCRT
  35.     AmigaBasic  ACBM  type files
  36.     Author chunk is supported
  37.     Displays the first cell in a ANIM file
  38.     Written in Assembly, PURE code that can be resident under 1.3
  39.  
  40. *NEW*   Display Animations.  (Type 5 - DPaintIII, VideoScape2.0)
  41.  
  42.  
  43. Display options include the following:
  44.  
  45.     -a        Suppress Author Text
  46.     -c        Suppress Color Cycling
  47.     -d <dir>    Display all pictures in a directory
  48.     -f <file>    Read a text file for picture names
  49.     -h<n>       Change the display height of a picture
  50. *NEW*    -j<n>        Force <n> Jiffies between frames
  51.     -l           List picture information
  52.     -m<x>       Select view modes.
  53. *NEW*    -n        No ANIM, show picture only
  54.     -o           Override the Auto Overscan 
  55.     -p           Disables Pointer Clearing
  56.     -r           Repeat command line
  57.     -s<n>        Display picture for n seconds
  58.     -t[<n>]        Double buffer pictures
  59.     -u        Dual Playfield
  60.     -v        Stop Animation after one time through.
  61.     -w<n>        Change the display width
  62.     -x<n>        Change the position of the display area x
  63.     -y<n>        Change the position of the display area y
  64.  
  65.  
  66. Overscan sizing and positioning has also been improved.
  67.  
  68. Controls:
  69.  
  70.     Left Mouse     Button Scrolls around in a picture
  71.     Right Mouse     Button Continues to next picture
  72. *NEW*    TAB         Starts and stops the color cycling
  73.     ESC         Aborts the command line
  74. *NEW*    SpaceBar    Starts and stops animations
  75. *NEW*    Return        Step through animation
  76.  
  77. Using SuperView from WorkBench.
  78.  
  79. SuperView has a complete WorkBench (Icon) interface built in.  
  80. To use SuperView from WorkBench, you must have an icon for your picture. 
  81. Most all paint programs build icons for you as you save a picture, so 
  82. this should not be a problem.  There are two ways to view pictures at 
  83. this point.  The easy way is to click once on the picture icon, hold 
  84. down the shift key, and then double click the SuperView icon.  You can 
  85. reverse this and click once on the SuperView icon and double click your 
  86. picture icon.  To view more that one picture,  you hold down the shift 
  87. key and click each picture that you want to show and the SuperView icon.  
  88. You don't have to select the icons in any kind of order as long as you 
  89. double click the last icon you select.  The pictures will be displayed 
  90. in the order that you select them.  You can also make the picture icon 
  91. itself run SuperView by putting SuperView in the default tool of the 
  92. icon.  This way you can just double click the picture icon to view it.  
  93. For a detailed description of how this is done, see the article in 
  94. Ami Exchange Mag V1.4.  
  95.  
  96. After the picture is loaded from workbench, you can stop and start the 
  97. color cycling with the TAB key, hold down the left mouse button to 
  98. scroll around in a large bitmap picture, press the right mouse button 
  99. to go to the next picture,  or press the ESC key to abort. Pressing the 
  100. ESC key will remove the current picture and cancel out any pictures that 
  101. you had selected that you have not viewed yet.
  102.  
  103.  
  104. Using SuperView from the CLI
  105.  
  106. Here is where the real power of SuperView comes out.  
  107. From the CLI,  you can choose many display options that allow you to 
  108. view a picture in different ways.  The command line from the CLI is
  109.  
  110. 1> SuperView [option[...]] <fileName> [[option[...]] <fileName>].... 
  111.  
  112. You can use up to 255 characters on the command line.  
  113. Here is a list of the options and how to use them.
  114.  
  115.     -a    Suppress Author Text
  116.  
  117. If you use this option, no Author text will be displayed from the AUTH 
  118. chunk in the IFF file.  
  119.  
  120. Example: 
  121.  
  122. 1> SuperView -a <Picture>
  123.  
  124.  
  125.     -c    Suppress Color Cycling
  126.  
  127. This option will prevent the picture from color cycling.  If you use this 
  128. option,  the spacebar will not start color cycling.  
  129.  
  130. Example:
  131.  
  132. 1> SuperView -c <Picture>
  133.  
  134.  
  135.     -d <dir>    Display all pictures in a directory
  136.  
  137. The -d option will take the name of a directory instead of a picture 
  138. name and display every picture that if finds in that directory.  
  139. SuperView will overlook files that are not pictures, so you wont have 
  140. to worry about having non-picture files in the directory.  Any options 
  141. that you select before the directory name will stay in effect for each 
  142. picture in the directory.  After the directory has been displayed, 
  143. SuperView will continue on with the rest of the command line.  This 
  144. option works well with the -s option. 
  145.  
  146. Example:
  147.  
  148. 1> SuperView -d df0:
  149. 1> SuperView -s10 -c -d df0:
  150. 1> SuperView -s10 -d -a df1: -r
  151.  
  152. To display the Parent directory,  use the / as the directory name.  If 
  153. you want to show the pictures in your current directory you will need to
  154. use /<directory>  This takes you to parent and back into the current.  So
  155. if you wanted to show all of the pictures in your current directory, and
  156. that directory was  dh0:pics/lo-res/mine,  you would use a this line:
  157.  
  158. 1> SuperView -d /mine        ;show directory mine
  159.  
  160. If your current directory was dh0:pics/lo-res,  then you could use this
  161. line:
  162.  
  163. 1> SuperView -d mine        ;show directory mine
  164.  
  165. You could type in the complete path name if you like.    
  166.  
  167.  
  168.     -f <file>    Read a text file for picture names
  169.  
  170. This option will read a text file and use it as a script to display 
  171. pictures.  The format of the file is the same as the format of each 
  172. picture on the command line.  
  173.  
  174. Example:
  175.  
  176. -a <Picture>
  177. -s10 MyPicture
  178. -d -s10 -c df0:
  179. GreatPic
  180. -x200 -y100 BigPic
  181.  
  182. Each picture in the file can have its own options.  When all of the files 
  183. have been displayed,  SuperView will continue with the rest of the 
  184. command line.
  185.  
  186. Example:
  187.  
  188. 1> SuperView -f MyScript
  189. 1> SuperView -f MyScript -r
  190. 1> SuperView -f MyScript -s10 <Picture>
  191.  
  192.  
  193.     -h<n>   Change the display height of a picture
  194.     -w<n>    Change the display width
  195.  
  196. These two options change the display size of a picture.  You can use one 
  197. or both of them on a picture.  These options change the display size of 
  198. the picture, not the size of the picture.   If you tell it to use a 
  199. smaller display size than the picture is, you will be able to scroll 
  200. around in the smaller display area.  The best way to under stand this may 
  201. be to try it.   
  202.  
  203. Example:
  204.  
  205. 1> SuperView -w320 -h200 <Picture>
  206. 1> SuperView -w320 -h200 -m <Picture>
  207. 1> SuperView -w200 -h100 -x60 -y50 <Picture>
  208.  
  209. *NEW*    -j<n>   Force <n> Number of Jiffies between frames
  210.  
  211. When displaying an animation, this will allow you to change the 
  212. playback speed.  A Jiffiy is 1/60th of a second, so the greater the
  213. number, the slower the animation is.
  214.  
  215. Example:
  216.  
  217. 1> SuperView -j6 Cry
  218.  
  219.  
  220.     -l   List picture information
  221.  
  222. If you want to know the size of a picture, or if it is HAM or HalfBrite, 
  223. then this is your option.  This will list out the size of the display 
  224. area,  the size of the picture, what type of file it is (ILBM, ACBM, 
  225. ANIM), any display modes, number of colors and bit planes. 
  226.  
  227. Example:
  228.  
  229. 1> SuperView -l <Picture>
  230. 1> SuperView -l -s10 <Picture>
  231. 1> SuperView -l -w400 <Picture>
  232.  
  233.  
  234.  If you want to save this information to disk or printer,  you may 
  235. redirect the output:
  236.  
  237. 1> SuperView >Prt: -d -l df1:
  238.  
  239. This line will show each picture on drive df1: and list the information 
  240. to the printer.
  241.  
  242.  
  243.     -m<x>   Select view modes  
  244.         h = HAM 
  245.         r = HiRes 
  246.         l =Lace
  247.         b = HalfBrite
  248.  
  249. This will allow you to change any display modes that you want.  The 
  250. display modes that are supported are,  Hi-Res (640 display), 
  251. Lace (interlace), HAM (Hold And Modify), and Extra-HalfBrite.  If you 
  252. just select -m option without any letters following it, all modes will be 
  253. cleared.  If the modes are clear, you will get a standard lo-res screen.  
  254. This is good for taking a Hi-Res, Lace picture and making it Lo-Res.
  255.  
  256. Example:
  257.  
  258. 1> SuperView -w320 -h200 -m <Picture>
  259. 1> SuperView -w320 -h200 -ml <Picture>
  260.  
  261. This will give you a 320 X 200 picture of <Picture> that you can scroll 
  262. around in.  
  263.  
  264. *NEW*    -n   No Animation.
  265.  
  266. Use this flag to prevent SuperView from playing an animation.  SuperView
  267. will go ahead and load the frist frame and treat it as a normal picture.
  268.  
  269.  
  270.     -o   Override the Auto Overscan 
  271.  
  272. This will cause SuperView to display the picture exactly like the IFF 
  273. file said to.  No attempt to size or place the picture is made.
  274.  
  275. Example:
  276.  
  277. 1> SuperView -o <Picture>
  278.  
  279.  
  280.     -p   Disables Pointer Clearing
  281.  
  282. If you don't want your pointer to disappear when showing the picture,  
  283. then use this option.
  284.  
  285. Example:
  286.  
  287. 1> SuperView -p <Picture>
  288.  
  289.  
  290.     -r   Repeat command line
  291.  
  292. This will cause SuperView to repeat the command line in a loop.  With 
  293. this option, the -s and -d or -f options, you can make a slide show.  
  294. This is the only option that you put after everything else and everything 
  295. past the -r is ignored.  The only way to stop this is to hit the ESC key.
  296.  
  297. Example:
  298.  
  299. 1> SuperView <Picture> <Picture> -r
  300. 1> SuperView -s10 <Picture> -s5 <Picture> -r
  301.  
  302.  
  303.     -s<n>  Display picture for n seconds
  304.  
  305. This option will remove the picture after n seconds.  You can still 
  306. continue by pressing the right mouse button or ESC key.  This option 
  307. and the -d option work well together.
  308.  
  309. Example:
  310.  
  311. 1> SuperView -s10 <Picture>
  312. 1> SuperView -s10 -d df1:
  313.  
  314.  
  315.     -t[<n>]    Double Buffer
  316.  
  317. This option will take two (default) or more pictures and cycle them to the 
  318. front as fast as possiable.  This may not seem useful,  but there are some 
  319. reasons for including it.  Double Buffering is mostly used to hide the area 
  320. that you are drawing in until it is ready to be displayed.  Most of the 
  321. time it is a animation.  Durring some test with Double Buffering I found 
  322. that if you swap complete screens,  you can also change the colors.
  323. Try this,  load up a paint program,  make a red (filled) box in the middle
  324. of the screen.  Now save this as pic1.  Next change the box to blue and
  325. save as pic2.  Then type the following line
  326.  
  327. 1> SuperView -t pic1 pic2
  328.  
  329. Notice that the box is now a different color.  This is real useful in
  330. smoothing out pictures and you can make it look like you have more than
  331. 32 colors on the screen at once.  More info on how to use this option
  332. will be made available on the AmigaLine BBS at (405) 354-8061 including
  333. a way to make Hi-Res 4096 color photos from the amiga.
  334.  
  335. If you want to buffer more than two pictures,  supply the number of 
  336. pictures after the -t option like
  337.  
  338. 1> SuperView -t4 pic1 pic2 pic3 pic4
  339.  
  340.  
  341.     -u    Dual Playfield
  342.  
  343. Did you ever wonder what dual playfield was like.  Well with this option,
  344. you can take any two pictures that are three bit planes (or less) and 
  345. display them in dual playfield mode.  After the picture is displayed, 
  346. you can scroll around in each picture (if the picture is larger than the
  347. screen).  To do this, hold down the left mouse button and slide the mouse
  348. around.  The back ground picture will scroll,  now release the button and
  349. hold it down again,  this time the front picture will scroll.  Each time
  350. you press the left button the scrolling picture will change.  To use this 
  351. option,  type in the fore ground picture first and then the back ground
  352. picture like
  353.  
  354. 1> SuperView -u pic1 pic2
  355.  
  356.     -v    Play once only.
  357.  
  358. This option will cause SuperView to play through an Animation only
  359. one time.  Some Animations do not loop and need this flag to display
  360. correctly.
  361.  
  362.  
  363.     -x<n>    Change the position of the display area x
  364.     -y<n>    Change the position of the display area y
  365.  
  366. The -x and -y options are used to position the display area on the screen. 
  367. For overscan, you need to shift the picture to the left and up from the 
  368. normal 0x 0y so you use  -x-16 to shift left and -y-8 to shift up. Also, 
  369. if you want to change the display size with the -w and -h options, you 
  370. can center the smaller screen with these options.
  371.  
  372. Example:
  373.  
  374. 1> SuperView -x20 -y10 <Picture>
  375. 1> SuperView -w200 -h100 -x60 -y50 <Picture>
  376.  
  377.  
  378. *NEW*
  379.  
  380. About the animation.  SuperView will now display type 5 animations.
  381. Type 5 animations are the ones use by DPaintIII and VideoScape2.0
  382. All of the other options execpt -t and -u will still function with
  383. the animation.  To stop an animation, press the spacebar.
  384. After the animation is stopped, you can step through it using the return
  385. key.  ColorCycling remains in active durring the animation unless you 
  386. press the TAB key or use the -c option.  Due to the size of animation
  387. files, when you move from an animation to the next picture/animation
  388. the animation will stop while the next is loaded.  Before loading the 
  389. next picture/animation, SuperView will free all of the animation data,
  390. free the second bitmap (double-buffer), and leave the last frame still
  391. showing like a normal picture while loading the next.
  392.  
  393. I hope to add the Byte-by-Byte type animations as soon as I can find 
  394. the specs for them.
  395.  
  396.  
  397. Also fixed in 3.0
  398. Overscan now works correctly.
  399.  
  400. You can now start the color cycling even it you use the -c option.
  401.  
  402. The delay function now waits for the correct time between two pictures
  403. even if you press the right mouse button.
  404.  
  405.  
  406.  
  407. If you have any problems with the program, you can leave me a message
  408. on AmigaLine BBS at (405) 354-8061....
  409.  
  410.  
  411.