home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 180.lha / SuperView.doc < prev    next >
Encoding:
Text File  |  1988-04-28  |  8.7 KB  |  307 lines
  1.  
  2. SuperView,   A IFF display program.  by  David  Grothe  V 2.0
  3.  
  4. *
  5. * Copyright 1988 by David Grothe
  6. * All rights reserved.
  7. *
  8. * This program is Shareware,  if you use this program
  9. * please send $10 to: 
  10. *
  11. * David Grothe
  12. * 20 SW 39th
  13. * Okla City, OK  73109
  14. *
  15. * You may pass the program around as long as this Doc file 
  16. * remains a part of it.
  17. *
  18. * If you would like to distribute this program with your 
  19. * software, you must contact me first.
  20. * 
  21.  
  22.  
  23. SuperView is a program that will display IFF pictures of all types 
  24. on the Amiga.  The program supports the following features:
  25.  
  26.    Multiple files on one command line.
  27.    WorkBench  (icons) are supported.
  28.    All display modes supported.
  29.    Auto Overscan
  30.    Color Cycle ( DPaint and GraphiCraft types)  CRNG  CCRT
  31.    AmigaBasic  ACBM  type files
  32.    Author chunk is supported
  33.    Displays the first cell in a ANIM file
  34.    Written in Assembly, PURE code that can be resident under 1.3
  35.  
  36. New for version 2.0
  37.  
  38. Display options that include the following:
  39.  
  40. -aSuppress Author Text
  41. -cSuppress Color Cycling
  42. -d <dir>Display all pictures in a directory
  43. -f <file>Read a text file for picture names
  44. -h<n>   Change the display height of a picture
  45. -l   List picture information
  46. -m<x>   Select view modes.
  47. -o   Override the Auto Overscan 
  48. -p   Disables Pointer Clearing
  49. -r   Repeat command line
  50. -s<n>Display picture for n seconds
  51. -w<n>Change the display width
  52. -x<n>Change the position of the display area x
  53. -y<n>Change the position of the display area y
  54.  
  55. Also new to version 2.0 is:
  56.  
  57. Smooth transition between pictures.
  58. Color Cycling continues while next picture is loaded.
  59. Scroll around in large pictures.
  60. Pointer Clearing during picture viewing.
  61.  
  62. Overscan sizing and positioning has also been improved.
  63.  
  64. New controls:
  65.  
  66. Left Mouse Button Scrolls around in a picture
  67. Right Mouse Button Continues to next picture
  68. Spacebar Starts and stops the color cycling
  69. ESC Aborts the command line
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76. Using SuperView from WorkBench.
  77.  
  78. SuperView has a complete WorkBench (Icon) interface built in.  
  79. To use SuperView from WorkBench, you must have an icon for your picture. 
  80. Most all paint programs build icons for you as you save a picture, so 
  81. this should not be a problem.  There are two ways to view pictures at 
  82. this point.  The easy way is to click once on the picture icon, hold 
  83. down the shift key, and then double click the SuperView icon.  You can 
  84. reverse this and click once on the SuperView icon and double click your 
  85. picture icon.  To view more that one picture,  you hold down the shift 
  86. key and click each picture that you want to show and the SuperView icon.  
  87. You don't have to select the icons in any kind of order as long as you 
  88. double click the last icon you select.  The pictures will be displayed 
  89. in the order that you select them.  You can also make the picture icon 
  90. itself run SuperView by putting SuperView in the default tool of the 
  91. icon.  This way you can just double click the picture icon to view it.  
  92. For a detailed description of how this is done, see the article in 
  93. Ami Exchange Mag V1.4.  
  94.  
  95. After the picture is loaded from workbench, you can stop and start the 
  96. color cycling with the spacebar, hold down the left mouse button to 
  97. scroll around in a large bitmap picture, press the right mouse button 
  98. to go to the next picture,  or press the ESC key to abort. Pressing the 
  99. ESC key will remove the current picture and cancel out any pictures that 
  100. you had selected that you have not viewed yet.
  101.  
  102.  
  103. Using SuperView from the CLI
  104.  
  105. Here is where the real power of SuperView comes out.  
  106. From the CLI,  you can choose many display options that allow you to 
  107. view a picture in different ways.  The command line from the CLI is
  108.  
  109. 1> SuperView [option[...]] <fileName> [[option[...]] <fileName>].... 
  110.  
  111. You can use up to 255 characters on the command line.  
  112. Here is a list of the options and how to use them.
  113.  
  114. -aSuppress Author Text
  115.  
  116. If you use this option, no Author text will be displayed from the AUTH 
  117. chunk in the IFF file.  
  118.  
  119. Example: 
  120.  
  121. 1> SuperView -a Mickey
  122.  
  123.  
  124. -cSuppress Color Cycling
  125.  
  126. This option will prevent the picture from color cycling.  If you use this 
  127. option,  the spacebar will not start color cycling.  
  128.  
  129. Example:
  130.  
  131. 1> SuperView -c Spray
  132.  
  133.  
  134. -d <dir>Display all pictures in a directory
  135.  
  136. The -d option will take the name of a directory instead of a picture 
  137. name and display every picture that if finds in that directory.  
  138. SuperView will overlook files that are not pictures, so you wont have 
  139. to worry about having non-picture files in the directory.  Any options 
  140. that you select before the directory name will stay in effect for each 
  141. picture in the directory.  After the directory has been displayed, 
  142. SuperView will continue on with the rest of the command line.  This 
  143. option works well with the -s option. 
  144.  
  145. Example:
  146.  
  147. 1> SuperView -d df0:
  148. 1> SuperView -s10 -c -d df0:
  149. 1> SuperView -s10 -d -a df1: -r
  150.  
  151.  
  152. -f <file>Read a text file for picture names
  153.  
  154. This option will read a text file and use it as a script to display 
  155. pictures.  The format of the file is the same as the format of each 
  156. picture on the command line.  
  157.  
  158. Example:
  159.  
  160. -a Mickey
  161. -s10 MyPicture
  162. -d -s10 -c df0:
  163. GreatPic
  164. -x200 -y100 BigPic
  165.  
  166. Each picture in the file can have its own options.  When all of the files 
  167. have been displayed,  SuperView will continue with the rest of the 
  168. command line.
  169.  
  170. Example:
  171.  
  172. 1> SuperView -f MyScript
  173. 1> SuperView -f MyScript -r
  174. 1> SuperView -f MyScript -s10 Spray
  175.  
  176.  
  177. -h<n>   Change the display height of a picture
  178. -w<n>Change the display width
  179.  
  180. These two options change the display size of a picture.  You can use one 
  181. or both of them on a picture.  These options change the display size of 
  182. the picture, not the size of the picture.   If you tell it to use a 
  183. smaller display size than the picture is, you will be able to scroll 
  184. around in the smaller display area.  The best way to under stand this may 
  185. be to try it.   
  186.  
  187. Example:
  188.  
  189. 1> SuperView -w320 -h200 Mickey
  190. 1> SuperView -w320 -h200 -m Mickey
  191. 1> SuperView -w200 -h100 -x60 -y50 Spray
  192.  
  193.  
  194. -l   List picture information
  195.  
  196. If you want to know the size of a picture, or if it is HAM or HalfBrite, 
  197. then this is your option.  This will list out the size of the display 
  198. area,  the size of the picture, what type of file it is (ILBM, ACBM, 
  199. ANIM), any display modes, number of colors and bit planes. 
  200.  
  201. Example:
  202.  
  203. 1> SuperView -l Mickey
  204. 1> SuperView -l -s10 Mickey
  205. 1> SuperView -l -w400 Mickey
  206.  
  207.  
  208.  If you want to save this information to disk or printer,  you may 
  209. redirect the output:
  210.  
  211. 1> SuperView >Prt: -d -l df1:
  212.  
  213. This line will show each picture on drive df1: and list the information 
  214. to the printer.
  215.  
  216.  
  217. -m<x>   Select view modes  
  218. h = HAM 
  219. r = HiRes 
  220. l =Lace
  221. b = HalfBrite
  222.  
  223. This will allow you to change any display modes that you want.  The 
  224. display modes that are supported are,  Hi-Res (640 display), 
  225. Lace (interlace), HAM (Hold And Modify), and Extra-HalfBrite.  If you 
  226. just select -m option without any letters following it, all modes will be 
  227. cleared.  If the modes are clear, you will get a standard lo-res screen.  
  228. This is good for taking a Hi-Res, Lace picture and making it Lo-Res.
  229.  
  230. Example:
  231.  
  232. 1> SuperView -w320 -h200 -m Mickey
  233. 1> SuperView -w320 -h200 -ml Mickey
  234.  
  235. This will give you a 320 X 200 picture of Mickey that you can scroll 
  236. around in.  
  237.  
  238. -o   Override the Auto Overscan 
  239.  
  240. This will cause SuperView to display the picture exactly like the IFF 
  241. file said to.  No attempt to size or place the picture is made.
  242.  
  243. Example:
  244.  
  245. 1> SuperView -o Spray
  246.  
  247.  
  248. -p   Disables Pointer Clearing
  249.  
  250. If you don't want your pointer to disappear when showing the picture,  
  251. then use this option.
  252.  
  253. Example:
  254.  
  255. 1> SuperView -p Mickey
  256.  
  257.  
  258. -r   Repeat command line
  259.  
  260. This will cause SuperView to repeat the command line in a loop.  With 
  261. this option, the -s and -d or -f options, you can make a slide show.  
  262. This is the only option that you put after everything else and everything 
  263. past the -r is ignored.  The only way to stop this is to hit the ESC key.
  264.  
  265. Example:
  266.  
  267. 1> SuperView Mickey Spray -r
  268. 1> SuperView -s10 Mickey -s5 Spray -r
  269.  
  270.  
  271. -s<n>  Display picture for n seconds
  272.  
  273. This option will remove the picture after n seconds.  You can still 
  274. continue by pressing the right mouse button or ESC key.  This option 
  275. and the -d option work well together.
  276.  
  277. Example:
  278.  
  279. 1> SuperView -s10 Mickey
  280. 1> SuperView -s10 -d df1:
  281.  
  282.  
  283.  
  284.  
  285. -x<n>Change the position of the display area x
  286. -y<n>Change the position of the display area y
  287.  
  288. The -x and -y options are used to position the display area on the screen. 
  289. For overscan, you need to shift the picture to the left and up from the 
  290. normal 0x 0y so you use  -x-16 to shift left and -y-8 to shift up. Also, 
  291. if you want to change the display size with the -w and -h options, you 
  292. can center the smaller screen with these options.
  293.  
  294. Example:
  295.  
  296. 1> SuperView -x20 -y10 Mickey
  297. 1> SuperView -w200 -h100 -x60 -y50 Spray
  298.  
  299.  
  300. If you have any problems with the program, you can leave me a message
  301. on AmigaLine BBS at (405) 354-8061....
  302.  
  303.  
  304.  
  305.  
  306.  
  307.