home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 500.lha / TIV_v1.51 / TIV.doc < prev    next >
Text File  |  1991-04-09  |  57KB  |  1,276 lines
  1.                            TEKSoft Presents...
  2.  
  3.                  _____________    ___      ___     ____
  4.                 |             |  |   |    |   |   /   /
  5.                 |____     ____|  |   |    |   |  /   /
  6.                      |   |       |   |    |   | /   /
  7.                      |   |       |   |    |   |/   /
  8.                      |   |       |   |    |       /
  9.                      |   |       |   |    |      /
  10.                      |___| O     |___| O  |_____/ O
  11.  
  12.                               Version 1.5l
  13.  
  14.  
  15.                         Released March 10, 1991
  16.  
  17.                        Written by: Thomas Krehbiel
  18.  
  19.                      Copyright © 1990,1991  TEKSoft
  20.  
  21.                            All Rights Reserved
  22.  
  23.  
  24.  
  25.               
  26.         * - * - * - * - * - * - * - * - * - * - * - * - * - * - *
  27.               
  28.  
  29.                          0.  TABLE OF CONTENTS
  30.  
  31.  
  32. 1. Introduction
  33.    1.1. Distribution Information
  34.    1.2. Quick Overview
  35.    1.3. Requirements
  36. 2. Installation and Useage
  37.    2.1. Installation
  38.    2.2. CLI Useage
  39.    2.3. Workbench Useage
  40.    2.4. View Controls
  41. 3. Options
  42.    3.1. Options Table
  43.    3.2. Option Defaults File
  44. 4. Tips, Tricks, and Examples
  45.    4.1. ANIM Brushes
  46.    4.2. Slideshows
  47.    4.3. DeluxePaint3 Animations
  48.    4.4. TIV and Workbench 2.0
  49.    4.5. TIV and HAM-E
  50.    4.6. More Examples
  51. 5. Acknowledgements
  52. 6. The Future
  53. 7. The Author
  54.  
  55.  
  56.               
  57.         * - * - * - * - * - * - * - * - * - * - * - * - * - * - *
  58.               
  59.  
  60.                            1.  INTRODUCTION
  61.  
  62.  
  63.  
  64. 1.1.  Distribution Information
  65.  
  66.  
  67.      TIV 1.5l is being distributed as Shareware for non-commercial
  68. use only.  Try the program for a week or so and see if you like it.
  69. If you find yourself using it, please consider sending a donation of
  70. $20 or so (see `Register.doc' for details) to compensate me for the
  71. considerable amount of time I have put into this program.  I believe
  72. it is well worth the price.
  73.  
  74.      The files in this archive may be freely distributed for non-
  75. commercial purposes only in their unaltered form.  No charges may be
  76. made (beyond reasonable media and distribution costs) for said
  77. distribution.  The author makes no warranties expressed or implied as
  78. to the use or misuse of this program.
  79.  
  80.      If you wish to distribute this program with any commercial
  81. product of yours, please contact me at one of the locations given at
  82. the end of this document.  I'm sure we can work something out.
  83.  
  84.  
  85. 1.2.  A Quick Overview
  86.  
  87.  
  88.      What is TIV?  TIV is a very complete general purpose IFF viewer.
  89. It combines an ILBM picture viewer, ANIM Op5 animation player, and
  90. 8SVX sampled sound player all in one hopefully convenient program.
  91. TIV can be run from CLI or from WorkBench, with many different options
  92. available in either environment.
  93.  
  94.      A partial list of features follows:
  95.  
  96.      * Can show any type of ILBM picture, including overscan,
  97.        HAM, Halfbright, SHAM, and Super Bitmap, with Color Cycling.
  98.        Also includes an optional kludge hook into Dyna-Show to show
  99.        Dynamic Hires and Dynamic HAM pictures.  Also supports
  100.        HAM-E Super Bitmap pictures.
  101.  
  102.      * Can view any ANIM Op5 animation, including overscan, HAM, 
  103.        Halfbright.  Supports palette changes on every frame, and
  104.        supports color cycling during playback.  Also boasts very high
  105.        frame rates.  Can also show DeluxePaint3 ANIM Brushes
  106.        correctly!  Contains an optional kludge hook into Movie to show
  107.        Sculpt-Animate movies.
  108.  
  109.      * Can play any length sound sample in either IFF 8SVX format or
  110.        Raw format, including support for Fibonnaci-Delta compressed 
  111.        8SVXs and stereo 8SVXs.
  112.  
  113.      * Capable of scanning a given directory for pictures, animations,
  114.        and/or sounds for quick slideshow presentations.
  115.  
  116.      * Supports a variety of user options covering a wide range
  117.        of applications, all accessable from CLI or Workbench.
  118.  
  119.      * Extensive WorkBench support.
  120.  
  121.      * And MUCH More...
  122.  
  123.  
  124.  
  125. 1.3.  Requirements
  126.  
  127.      TIV should work on any model Amiga with as little as 512K (it
  128. might even work in 256K).  However, there are certain limiting
  129. factors:  Some pictures will require a large amount of Chip memory
  130. to be viewable (especially interlaced HAM/HalfBrite pictures or
  131. animations).  Also, some animations might require a large amount
  132. of Fast memory to load completely off of disk.  In addition,
  133. the Slideshow mode requires a generally large amount of chip memory.
  134.  
  135.      TIV requires either Workbench 2.0's "ASL.Library" or the
  136. freely distributable "ARP.Library" in the current LIBS: directory
  137. for it to work in Interactive Mode.  Other than this mode, neither
  138. library is required.  Interactive mode lets you select files to
  139. view from a file requester, one at a time.
  140.  
  141.      At this time, TIV is *NOT* able to be made resident.  Sorry.
  142.  
  143.      TIV 1.5l is largely Workbench 2.0 compatible (tested under 
  144. Kickstart Release 36.303).  There are, however, certain idiosyncrasies 
  145. that crop up especially displaying brushes or ANIM brushes and when 
  146. using View mode in general.  I am researching these problems and will 
  147. attempt to correct them in the next version (if anybody has any
  148. suggestions, please don't hesitate to contact me).  See the section
  149. below on Workbench 2.0 for details.
  150.  
  151.  
  152.               
  153.         * - * - * - * - * - * - * - * - * - * - * - * - * - * - *
  154.  
  155.  
  156.                         2. INSTALLATION AND USEAGE
  157.  
  158. 2.1.  Installation
  159.  
  160.      TIV is easy to install.  If you plan to use TIV from the CLI,
  161. then you can simply copy the TIV program to your C: directory by
  162. using the command:
  163.  
  164.      1> Copy TIV C:
  165.  
  166.      If you will be using TIV from Workbench, then you can simply
  167. drag the TIV icon to wherever is convenient for you.  An appropriate
  168. place would be your Workbench Utilities or Tools drawer.
  169.  
  170.      TIV is a self-contained program, so there are no other files to
  171. copy other than the executable.  However, I have included a few
  172. sample project icons that can be used to attach to your pictures,
  173. animations, or sounds.  You can save these somewhere if you want to
  174. use them, perhaps on your Workbench disk somewhere.  Simply drag them
  175. where you want them.
  176.  
  177.      Also included in the archive is a version of TIV that has been
  178. "crunched" with PowerPeak's PowerPacker 2.3a.  It is approxiamately
  179. half the size of the regular executable but still retains all of the
  180. same features.  If you wish to use this version (floppy users in
  181. particular might), then simply rename it to `TIV' and copy it as
  182. above.
  183.  
  184.               
  185. 2.2.  CLI Useage
  186.  
  187.      From CLI, TIV can be run like any other command.  It should work
  188. in the default Stack setting of 4000 bytes.  Here is the general
  189. format for running TIV from CLI:
  190.  
  191.      1> TIV [options] [file(s)] [[options] [file(s)] ... ]
  192.  
  193.      Notice that any number of files to view may be given on the
  194. command line.  In addition, TIV supports Unix-style pattern matching
  195. so you can use such filenames as `*.pic' or `My*.anim'.  Notice also
  196. that options may fall anywhere in the command line.  The command line
  197. is parsed in a left to right order, so options specified will modify
  198. the following files, NOT all files in the command line.
  199.  
  200.      Filenames may optionally be enclosed in SINGLE quotes.  This
  201. is not necessary unless you are trying to view a file whose name
  202. matches a TIV option.  For example, if you were to try to view a
  203. file called "Hal", TIV will think you are trying to give it the
  204. HALFBRITE option.  The correct thing to do in this case is to enclose
  205. the filename in single quotes, ie. "TIV 'Hal'".
  206.  
  207.      Options are given in standard AmigaDOS template format.  That
  208. is, each option is a word like `RATE' or `VIEW'.  There are boolean
  209. options and there are options that require a string or numeric
  210. argument.  Where an option requires an argument, the argument must
  211. follow immediately after the option keyword, with at least one space
  212. seperating them.  For example, `RATE 2' or `DELAY 5'.  Option
  213. keywords are not case sensitive, so you can use lowercase if you
  214. want.  Keywords can also be abbreviated from CLI to save you some
  215. typing; see the Option Table below for further details.
  216.  
  217.      Some information may be displayed in your CLI window while TIV is
  218. running.  In particular, if any fatal errors develop, you will receive
  219. a message informing you of the type of error and TIV will exit.  You may
  220. also see various warning messages when there are less serious errors
  221. encountered.
  222.  
  223.      Also, when viewing a directory recursively (RECURSIVE ALL) you will
  224. see a listing of all the subdirectories entered similar to a Dir
  225. command output.  Sifting files (SIFT) will also display it's output to
  226. the CLI window.
  227.  
  228.      If no files are given on the command line, then TIV will startup
  229. in Interactive mode.  This will bring up a file requester (either
  230. the Arp.Library requester or the ASL.Library requester, depending on
  231. whether you are running under 1.3 or 2.0) which will allow you to
  232. interactively select files to view.  Any options you specify on the
  233. command line will affect the files you select to view.  If you do not
  234. have either ASL.Library or Arp.Library, TIV will fail if not given
  235. any files.
  236.  
  237.      Here is the CLI "search" order for options:
  238.  
  239.           1. Read `S:TIV.Defaults' if present (see below).
  240.           2. Read Command Line options.
  241.           3. Read options from target file's .info file, unless
  242.              the NOINFO option is in effect.
  243.  
  244.  
  245. 2.3.  Workbench Useage
  246.  
  247.      TIV provides extensive Workbench support.  There are several
  248. ways of running TIV from the Workbench, as described below:
  249.  
  250.      A.  TIV Icon.  The first way involves just double-clicking the
  251.          TIV program icon.  This will open TIV in Interactive mode,
  252.          which will open a file requester allowing you to choose one
  253.          or more files to view.  The Tool Types for the TIV icon will
  254.          be read and the information there will be used to affect the
  255.          files selected for viewing.  Therefore, your default TIV
  256.          viewing options should be placed in the TIV Tool Types.  If
  257.          you do not have either the Arp.Library under 1.3 or
  258.          Asl.Library under 2.0, TIV will fail, since that is where
  259.          TIV gets the file requester.
  260.          
  261.      B.  Extended Selection.  A second way of invoking TIV uses the
  262.          Workbench's extended selection method.  Select one or more
  263.          IFF file's icon, hold down the shift key, and then double
  264.          click on the TIV icon.  TIV will then attempt to view the
  265.          file.  TIV will first read options information from the TIV
  266.          Tool Types array, then it will attempt to glean some more
  267.          information out of the IFF file's Tool Types array before
  268.          showing the file (unless you specify NOINFO=YES in the TIV
  269.          Tool Types).  So you can specify unique information about
  270.          the file in it's Tool Types (such as cycling, loops, rate,
  271.          etc.) and it will be used automatically.
  272.  
  273.      C.  IFF Icon.  A third way of running TIV is to make a project 
  274.          icon for the IFF file you want to view.  Set the path to the
  275.          TIV program as the default tool, then enter the options you
  276.          want to use for this IFF file in it's Tool Types array.  Once
  277.          this is done, all you need to do is double-click on the IFF
  278.          file's icon and it will be shown.  It will first read options
  279.          out of the Default Tool's icon, then it will look for options
  280.          in the IFF file's Tool Types.
  281.  
  282.      In all cases, here is the "search" order for options:
  283.          
  284.          1. Read `S:TIV.Defaults' if present (see below).
  285.          2. Read TIV Tool Types.
  286.          3. Read target file's Tool Types, unless the NOINFO option
  287.             is in effect.
  288.  
  289.      If TIV needs to display a warning or fatal error message to you
  290. from the Workbench, it will open a small console window and print out
  291. the message(s).  When TIV exits, this window will remain open for a
  292. second or two before closing to allow you time to read the text in it.
  293.  
  294.  
  295. 2.4. Information Window
  296.  
  297.      When TIV goes to show a file, it will open a small Information 
  298. Window on the Workbench screen.  In this window, TIV displays various
  299. relevant information about the file it is loading.  It does this
  300. partly to give you something to look at while it is loading and partly
  301. to convey some useful information about the file.
  302.  
  303.      The following is a list of the actions that can be taken while
  304. TIV is running if the Information Window is open and active:
  305.  
  306.      General:
  307.  
  308.      ESCAPE Key               Abort current file, exit TIV.
  309.      Left Mouse Button        Skip current file, move on to next (*).
  310.      Right Mouse Button       Skip current file, move on to next.
  311.      Other Keys               Skip current file, move on to next.
  312.  
  313.      While Viewing Picture:
  314.  
  315.      TAB Key                  Toggle color cycling on or off.
  316.      Arrows                   Scroll around in Super-Bitmap pictures.
  317.      Shift + Arrows           Scroll quickly in Super-Bitmap pictures.
  318.      Control + Arrows         Shift display's overscan offset.
  319.  
  320.      While Viewing Animation:
  321.  
  322.      TAB Key                  Toggle color cycling on or off.
  323.      Down Arrow               Freeze frame animation.
  324.      Up Arrow                 Resume animation playing.
  325.      Right Arrow              Single frame advance animation.
  326.      F1 - F10                 Speed control (F1 = Fast, F10 = Slow)
  327.      Control + Arrows         Shift display's overscan offset.
  328.  
  329.      (*) The Left Mouse Button can be disabled by using the `NOLMB' 
  330. option.  See the description of that option below for reasons why you
  331. might want to disable this.
  332.  
  333.      NOTE:  The Information Window *MUST* be active for these
  334. keystrokes and mouse button clicks to be accepted.  If for some
  335. reason the Information Window becomes inactive (a common mistake is
  336. to hit the Left Mouse Button to skip a file) then you will have to
  337. bring the Workbench screen to the front (Left Amiga N) and activate
  338. the Information Window again before using the above controls.  Note
  339. that if you have the LMB option on (the default) then the Information
  340. Window can never be made inactive, so you shouldn't have anything
  341. to worry about.
  342.  
  343.      Suppose you are running TIV without the Information Window
  344. enabled (by using the NOWINDOW or WINDOW=NO option).  You will lose
  345. most of the above control capability.  Here is what is left that you
  346. can do:
  347.  
  348.      Control-C                Abort current file, exit TIV.
  349.      Control-D                Skip current file, move on to next.
  350.  
  351.      Note that you can skip a file or abort TIV while a file is
  352. loading, but TIV only checks for user input once every IFF chunk.
  353. Therefore, if TIV is reading a large chunk (for example, a picture,
  354. animation, or sound BODY chunk), there might be some delay before TIV
  355. will respond to your abort request.
  356.  
  357.      Also note:  In version 1.5l, TIV contains optional kludges to call 
  358. on the external programs "Dyna-Show" and "Movie" to view certain types
  359. of files (specifically, Dynamic Hires and Opcode J movies, respectively).
  360. These programs do not contain the same control capability as TIV (in
  361. fact they contain little to no control whatsoever), and the above
  362. controls will NOT work while viewing these types of files.  For
  363. complete details, see the documentation to those programs.
  364.  
  365.  
  366.         * - * - * - * - * - * - * - * - * - * - * - * - * - * - *
  367.               
  368.  
  369.                               3. OPTIONS
  370.               
  371.  
  372. 3.1.  TIV Option Table
  373.  
  374.      The following options are given in a format that can be used
  375. for CLI or Workbench reference.  All boolean options can be set
  376. on or off at any position on the command line.
  377.  
  378.      From CLI, to turn on an option you would use just the keyword
  379. by itself.  For example, `CYCLE' or `VIEW'.  To turn the option
  380. off, precede the option keyword with `NO'.  For example, `NOCYCLE' or
  381. `NOVIEW'.  From CLI, the keyword may be abbreviated a certain
  382. amount to save typing as indicated in the descriptions below.
  383. The abbreviation is given after the keyword in parenthesis. 
  384. Arguments to keywords must immediately follow the keyword, with at
  385. least a single space seperating them.  For example, `RATE 1' or
  386. `ALL fh2:pics'.
  387.  
  388.      From Workbench in a Tool Types array, you specify the option
  389. keyword followed by an equals sign and the word `ON' or `OFF'.
  390. For example, `CYCLE=ON' or `VIEW=OFF'.  No abbreviation is allowed
  391. from Workbench.  Non-boolean keywords have their argument follow the
  392. equals sign.  For example, `RATE=1' or `ALL=fh2:pics'.
  393.  
  394. ------------------------------------------------------------------------
  395.  
  396.     Keyword:  REPEAT (REP)
  397.        Type:  Switch
  398. Description:  If this option is specified, this means that the
  399.               commands given to TIV will be repeated over and over
  400.               again until you stop it.  This is NOT a boolean option;
  401.               that is, there is no such thing as `NOREPEAT'.  This
  402.               affects the entire command line from CLI or the entire
  403.               Tool Types array from Workbench.
  404.  
  405. ------------------------------------------------------------------------
  406.  
  407.     Keyword:  ANIM (ANIM)
  408.        Type:  Boolean (Default On)
  409. Description:  This is a mask option to allow masking out certain
  410.               types of files.  In this case, if the ANIM option is
  411.               set, animations will be played.  If it is not set
  412.               (NOANIM or ANIM=NO) then animations will not be played.
  413.  
  414. ------------------------------------------------------------------------
  415.  
  416.     Keyword:  ILBM (ILBM)
  417.        Type:  Boolean (Default On)
  418. Description:  This is a mask option to allow masking out certain
  419.               types of files.  In this case, if the ILBM option is
  420.               set, pictures will be shown.  If it is not set (NOILBM
  421.               or ILBM=NO) then pictures will not be shown.
  422.  
  423. ------------------------------------------------------------------------
  424.  
  425.     Keyword:  8SVX (8SVX)
  426.        Type:  Boolean (Default On)
  427. Description:  This is a mask option to allow masking out certain
  428.               types of files.  In this case, if the 8SVX option is
  429.               set, samples will be played.  If it is not set (NO8SVX
  430.               or 8SVX=NO) then samples will not be played.
  431.  
  432. ------------------------------------------------------------------------
  433.  
  434.     Keyword:  CONTINUOUS (CO)
  435.        Type:  Boolean (Default Off)
  436. Description:  Animations are generally of two types.  Those that are
  437.               built to loop and those that are not.  Those that are
  438.               constructed to loop automatically will have the first
  439.               two frames of the animation attached to the end of
  440.               the animation.  This option allows you to specify
  441.               whether the animation is of the looping variety.
  442.               All DeluxePaint3 animations should have this option
  443.               set on, and Sculpt-Animate 4D Anim5 animations should
  444.               usually also have this option set.  If you do not set
  445.               this option for these looping animations, nothing 
  446.               disasterous will happen, but you will see an odd screen 
  447.               pattern at the end of the animation at the loop point.
  448.  
  449. ------------------------------------------------------------------------
  450.  
  451.     Keyword:  CYCLE (CY)
  452.        Type:  Boolean (Default On)
  453. Description:  This controls whether or not TIV will automatically
  454.               turn on color cycling for the following pictures or
  455.               animations.  If set on, pictures will color cycle
  456.               according to the information given in one or more
  457.               CRNG chunks in the file.  If set off, then TIV will
  458.               not cycle the picture or animation no matter what is
  459.               given in the file.  According to the IFF Standard for
  460.               ILBMs, this option should not be necessary, but because
  461.               DeluxePaint breaks this standard and saves ALL of
  462.               its pictures with color cycling tagged as active,
  463.               this option is required for those pictures.
  464.               
  465. ------------------------------------------------------------------------
  466.  
  467.     Keyword:  DYNA (DY)
  468.        Type:  Boolean (Default Off)
  469. Description:  This option, when set, will cause TIV to attempt to load
  470.               the program "Dyna-Show" when it encounters a Dynamic
  471.               Hires or Dynamic HAM picture.  Currently, TIV does not
  472.               support these types of ILBMs, largely due to the fact
  473.               that I cannot find any documentation on them.  After
  474.               much experimentation, I decided to include this kludge
  475.               in order to speed the release of TIV.  If this option
  476.               is off (the default), then TIV will simply report that
  477.               it cannot show the picture in question and move on.
  478.               NOTE:  You will lose a lot of the controls that TIV has
  479.               over pictures when you run Dyna-Show.  In fact, the
  480.               only control you will get is to stop viewing the
  481.               picture.  You will also lose the automation features of
  482.               TIV while viewing with Dyna-Show; specifically, the DELAY
  483.               option will not work while viewing a picture with
  484.               Dyna-Show; you will have to exit manually. To stop
  485.               viewing a Dynamic Hires picture in Dyna-Show, you must
  486.               press the *LEFT* mouse button as opposed to the right. 
  487.               This is why this defaults to off; it can get a bit
  488.               confusing having to decide which mouse button to press
  489.               to end the display.
  490.  
  491. ------------------------------------------------------------------------
  492.  
  493.     Keyword:  GIF (GI)
  494.        Type:  Boolean (Default Off)
  495. Description:  This option, when set, will cause TIV to attempt to
  496.               load an external program called `TGV' when it encounters
  497.               a file that is not IFF.  My intention for this feature
  498.               is to use it to support viewing GIF files, at least in
  499.               some way.  Since this is not a native Amiga format, it's
  500.               not high on my priority list at the moment.  However,
  501.               I'm providing this hook for the future.  For now, you
  502.               can use any GIF viewer program (HamGif, for example) and
  503.               rename it as `TGV' and TIV will call it for files it
  504.               doesn't recognize.  Note that the RAWSOUND option below
  505.               will override this option if it too is set.  That is, if
  506.               a file is found that is not IFF, and both the GIF and
  507.               RAWSOUND options are on, then TIV will assume the file
  508.               is a raw sample.  
  509.               
  510. ------------------------------------------------------------------------
  511.  
  512.     Keyword:  HALFBRITE (HA)
  513.        Type:  Boolean (Default Off)
  514. Description:  This option, when set, will cause TIV to assume that 
  515.               any file with 6 bitplanes that does not specifically
  516.               state what it is to be HalfBrite as opposed to HAM.
  517.               Sometimes you will find an animation or picture that is
  518.               supposed to be HalfBrite but TIV is trying to display it
  519.               as HAM.  The reason is that whatever program saved the
  520.               picture or animation did not specifically state (with a
  521.               CAMG chunk) whether the picture or animation was HAM or
  522.               HalfBrite.  TIV will see only that the file has 6
  523.               bitplanes and will have to guess whether it is HAM or
  524.               HalfBrite.  The default is to assume 6 bitplanes is HAM,
  525.               but this option will cause TIV to assume 6 bitplanes is
  526.               HalfBrite.  I have found that some VideoScape HalfBrite
  527.               animations fall into this category and you will have to
  528.               use the HALFBRITE option on them to make them display
  529.               correctly. 
  530.  
  531. ------------------------------------------------------------------------
  532.  
  533.     Keyword:  HIRES (HI)
  534.        Type:  Boolean (Default Off)
  535. Description:  This option, when set, will force TIV to display a
  536.               picture or animation in HIRES, no matter what is
  537.               contained in the CAMG chunk of the file.  This is
  538.               particularly useful for brushes or ANIM brushes, which
  539.               don't contain ANYTHING in the CAMG chunk.
  540.  
  541. ------------------------------------------------------------------------
  542.  
  543.     Keyword:  HOLDFIRST (HOLDF)
  544.        Type:  Boolean (Default Off)
  545. Description:  This option only has meaning when playing an animation.
  546.               When set, it will cause TIV to freeze the animation on
  547.               the first frame until you tell it to continue (by
  548.               using the animation control keys).  This can be useful
  549.               for recording an animation to videotape where you wish
  550.               to hold on the first frame for a while.  This option
  551.               cannot be used if the TIV Information Window is not
  552.               displayed.
  553.  
  554. ------------------------------------------------------------------------
  555.  
  556.     Keyword:  HOLDLAST (HOLDL)
  557.        Type:  Boolean (Default Off)
  558. Description:  This is only used for animations.  When set, it causes
  559.               TIV to freeze the animation on it's last played frame
  560.               until you tell it to continue by pressing the right
  561.               mouse button or pressing a key.  The `last frame' could
  562.               simply be the point at which you tell TIV to continue on
  563.               to the next file.  To cause TIV to halt on the REAL last
  564.               frame of the animation, you must specify a LOOP value of
  565.               something besides zero.  This option cannot be used if
  566.               the TIV Information Window is not displayed.
  567.  
  568. ------------------------------------------------------------------------
  569.  
  570.     Keyword:  INFO (IN)
  571.        Type:  Boolean (Default On)
  572. Description:  When set, this will allow TIV to try to find an .info
  573.               file associated with each file it attempts to display. 
  574.               If it finds an .info file, it will attempt to read
  575.               information out of it to use in displaying the file. 
  576.               If this option is turned off, then .info files will be
  577.               ignored.
  578.  
  579. ------------------------------------------------------------------------
  580.  
  581.     Keyword:  LACE (LA)
  582.        Type:  Boolean (Default Off)
  583. Description:  This option, when set, will force TIV to display a
  584.               picture or animation in interlace, no matter what is
  585.               contained in the CAMG chunk of the file.  This is
  586.               particularly useful for brushes or ANIM brushes, which
  587.               don't contain ANYTHING in the CAMG chunk.
  588.  
  589. ------------------------------------------------------------------------
  590.  
  591.     Keyword:  LMB (LM)
  592.        Type:  Boolean (Default On)
  593. Description:  When this option is specified, it allows you to use
  594.               the Left Mouse Button to skip pictures in addition
  595.               to the Right Mouse Button.  In order to do this, TIV
  596.               senses when the Information Window becomes inactive
  597.               and assumes this to be a left button press to skip a
  598.               picture.  It then reactivates the TIV Information
  599.               Window and moves on to the next picture.  This has a
  600.               possibly undesirable side-effect of not allowing you to
  601.               activate other windows while TIV is viewing pictures,
  602.               which is why this is an option.
  603.  
  604. ------------------------------------------------------------------------
  605.  
  606.     Keyword:  MOVIE (MO)
  607.        Type:  Boolean (Default Off)
  608. Description:  This option, when set, will tell TIV to attempt to load
  609.               the program "Movie" whenever it encounters an animation
  610.               with an unknown compression technique.  9 times out of
  611.               10, this will be an Opcode J (Movie) animation as
  612.               generated by Sculpt-Animate or Movie.  This is included
  613.               only as a kludge, I make no guarantees about the Movie
  614.               program.  If I can find documentation for the Opcode J
  615.               format, then I will make an attempt to include it in my
  616.               player, but for now this is the temporary solution. 
  617.               Note that Movie requires you to press the ESCAPE key to
  618.               end viewing the movie, as opposed to TIV's normal
  619.               convention of pressing the right mouse button.  This is
  620.               why this option defaults to off, to avoid confusion.
  621.               Also note that, as noted under the DYNA option above,
  622.               some options will cease to function for these movies. 
  623.               Specifically, the RATE, LOOPS, and DELAY options have
  624.               no effect on the Movie program.  You will have to exit
  625.               Movie manually, by pressing the escape key.
  626.  
  627. ------------------------------------------------------------------------
  628.  
  629.     Keyword:  POINTER (PO)
  630.        Type:  Boolean (Default Off)
  631. Description:  Normally TIV will try to blank the pointer while
  632.               displaying pictures or animations.  This option, when
  633.               set, will cause TIV to keep the mouse pointer visible
  634.               while showing pictures or animations.  Note that under
  635.               AmigaDos 1.3, the pointer is pretty nasty about
  636.               remaining visible when using a regular Intuition
  637.               Screen, despite what TIV tells it to do.
  638.  
  639. ------------------------------------------------------------------------
  640.  
  641.     Keyword:  RAWSOUND (RAW)
  642.        Type:  Boolean (Default Off)
  643. Description:  This option, when set, will cause TIV to assume that
  644.               any file found that is not IFF is a raw sound sample
  645.               file.  Normally, when this option is off, TIV will warn
  646.               you that a file is not IFF and skip it.  This option
  647.               must be set to play raw sound sample files.
  648.  
  649. ------------------------------------------------------------------------
  650.  
  651.     Keyword:  RECURSIVE (REC)
  652.        Type:  Boolean (Default Off)
  653. Description:  This option only has meaning when showing all files in
  654.               a directory with the `ALL' keyword.  If this option is
  655.               set, then TIV will enter all subdirectories in the ALL
  656.               directory attempting to find more IFF files.  This is
  657.               useful if you have a main Pictures directory with
  658.               several subdirectories off of it containing different
  659.               types of pictures (like the way DeluxePaint likes
  660.               things).
  661.  
  662. ------------------------------------------------------------------------
  663.  
  664.     Keyword:  SHOW (SH)
  665.        Type:  Boolean (Default On)
  666. Description:  This allows you to just view information about a file,
  667.               and not the file itself.  If this option is off, then
  668.               only information about the file will be printed to the
  669.               TIV Infomation Window.  Note that this option cannot be
  670.               used unless the TIV Information Window is open.
  671.  
  672. ------------------------------------------------------------------------
  673.  
  674.     Keyword:  SIFT (SI)
  675.        Type:  Boolean (Default Off)
  676. Description:  With this option, you can print out a structured
  677.               breakdown of the contents of *ANY* IFF file.  This
  678.               option will only work from the CLI, as it needs the
  679.               console to print the information.  With this option
  680.               set, the file is not shown, but a breakdown of the
  681.               chunks within the IFF file are displayed.  This can be
  682.               used to see what is actually in an IFF file, or it can
  683.               be used to determine where a file is corrupted for
  684.               possible recovery attempts.  The following is a sample
  685.               output from a Sculpt-Animate 4D `Take' file:
  686.  
  687.                     File: `fh2:anims/orbit.take'
  688.                     FORM 4030 TAKE
  689.                     . THDR 362
  690.                     . TFRM 3648
  691.  
  692. ------------------------------------------------------------------------
  693.  
  694.     Keyword:  SLIDESHOW (SL)
  695.        Type:  Boolean (Default Off)
  696. Description:  With this option turned on, TIV will display pictures
  697.               and animations in "slideshow" mode.  This is basically
  698.               just a double-buffering mechanism.  While one picture or
  699.               animation is being displayed, the next is being loaded. 
  700.               Normally TIV will load and display one file, then unload
  701.               it, then begin loading the next file.  This has the
  702.               disadvantage of showing your Workbench between pictures.
  703.               With slideshow set, then you avoid popping back to the
  704.               Workbench screen between pictures.  However, because TIV
  705.               has to maintain two pictures in memory at once,
  706.               slideshow mode uses more of your memory (specifically
  707.               chip memory).  You also can't see the TIV Information
  708.               Window while pictures are being loaded.
  709.  
  710. ------------------------------------------------------------------------
  711.  
  712.     Keyword:  SOUND (SO)
  713.        Type:  Boolean (Default On)
  714. Description:  Don't worry about this one.  It's reserved for future
  715.               expansion.  It doesn't do anything at this time.
  716.  
  717. ------------------------------------------------------------------------
  718.  
  719.     Keyword:  TIMING (TI)
  720.        Type:  Boolean (Default Off)
  721. Description:  It is sometimes useful to be able to know more or less
  722.               how fast an animation is being played.  When this
  723.               option is set, TIV will approxiamately calculate the
  724.               frame rate the animations are being played.  When the
  725.               animation is finished, TIV will print the frame rate in
  726.               the Information Window next to the number of frames in
  727.               the animation.  You must then press the right mouse
  728.               button or a key to continue.  Note that if you are in
  729.               slideshow mode, you will not see the timing information
  730.               (unless you bring Workbench to the front), but you must
  731.               still click twice to continue.
  732.  
  733. ------------------------------------------------------------------------
  734.  
  735.     Keyword:  VIEW (VI)
  736.        Type:  Boolean (Default Off)
  737. Description:  TIV is capable of showing pictures and animations in
  738.               two modes.  The default mode renders  the imagery into
  739.               an ordinary Intuition Screen.  This has the benefit of
  740.               allowing you to depth arrange it and drag it around. 
  741.               However, playing an animation in a Screen is generally
  742.               not very fast.  Thus there is the capability to use View
  743.               mode, which will render pictures or animations into a
  744.               View/ViewPort.  The benefits are much faster animation
  745.               playing and slightly less chip memory requirements.  The
  746.               bad part is that you can't jump back to Workbench (well,
  747.               you can, but you won't be able to get back to the
  748.               picture).  I would reccommend not using View mode unless
  749.               you want to play an animation as fast as possible or you
  750.               are short on chip memory.  By the way, you can probably
  751.               expect nearly a two times speed increase in animation
  752.               playback when in View mode.
  753.  
  754. ------------------------------------------------------------------------
  755.  
  756.     Keyword:  WB (WB)
  757.        Type:  Boolean (Default On)
  758. Description:  This option, when not set, tells TIV to attempt to 
  759.               close the Workbench when showing pictures and
  760.               animations.  This will only work if the TIV Information
  761.               Window is suppressed (see below).  This will slightly
  762.               increase the amount of chip memory available to TIV for
  763.               showing pictures.
  764.  
  765. ------------------------------------------------------------------------
  766.  
  767.     Keyword:  WINDOW (WI)
  768.        Type:  Boolean (Default On)
  769. Description:  When this option is turned off, TIV will not open the
  770.               Information Window which it uses to display relevant
  771.               information about the files it is showing.  With the
  772.               Information Window closed, you do not have the picture
  773.               or animation control keys available anymore.  You are
  774.               also not able to skip files with the right mouse
  775.               button.  With the Information Window closed, you must
  776.               use Control-D to skip a file and Control-C to exit TIV
  777.               altogether.
  778.  
  779. ------------------------------------------------------------------------
  780.  
  781.     Keyword:  ZOOM (ZO)
  782.        Type:  Boolean (Default Off)
  783. Description:  When turned on, this option will tell TIV to play
  784.               animations with their priority set to maximum (127). 
  785.               This can slightly increase the speed of playback, but
  786.               generally does not help all that much.  I would not
  787.               recommend using until you have tried everything else.
  788.  
  789. ------------------------------------------------------------------------
  790.  
  791.     Keyword:  ALL (AL)
  792.        Type:  String (No Default)
  793. Description:  This option tells TIV to show all IFF files in the
  794.               specified directory.  TIV will go through each file in
  795.               the directory and, if it is a type of IFF that TIV can
  796.               understand, will show it.  To mask out certain types of
  797.               files, see the ANIM, ILBM, and 8SVX options.  To show
  798.               all files in the current directory, used `TIV ALL ""'.
  799.               From Workbench in a Tool Types array, you MUST specify
  800.               the complete pathname to the directory where the files
  801.               are, no matter where the icon is.  If an Options
  802.               Defaults File (TIV.Defaults) exists in the directory
  803.               which you specify, then TIV will read it and use any
  804.               options found there.  See Options Defaults File below
  805.               for more information.
  806.  
  807. ------------------------------------------------------------------------
  808.  
  809.     Keyword:  DELAY (DE)
  810.        Type:  Numeric (Default 3)
  811. Description:  This specifies a delay time in seconds that files will
  812.               remain onscreen.  This is subject to a few caveats,
  813.               though.  If you are showing an animation or sound with
  814.               a specific number of loops given (LOOPS > 0), then no
  815.               delay will be used and TIV will go to the next file
  816.               when the loops are exhausted.  If the number of loops
  817.               is zero (that is, repeat forever), and a DELAY is found
  818.               in the options list, then TIV will timeout after the
  819.               delay time and go on to the next file.  If the loop
  820.               count is zero and there is NO delay option, then you
  821.               will have to continue manually by clicking the right
  822.               mouse button (with the Information Window) or pressing
  823.               CTRL-D (without the Information Window).
  824.  
  825. ------------------------------------------------------------------------
  826.  
  827.     Keyword:  LOOPS (LO)
  828.        Type:  Numeric (Default 0)
  829. Description:  This will tell TIV how many times to loop an animation
  830.               or a sound.  If the argument is zero (0), then TIV will
  831.               loop the animation or sound until you tell it to stop
  832.               with the right mouse button, or until a delay amount
  833.               has expired (see DELAY above).  Any other positive value
  834.               will tell TIV to loop the file that many times and then
  835.               continue.  This has no effect for pictures, obviously.
  836.  
  837. ------------------------------------------------------------------------
  838.  
  839.     Keyword:  PERIOD (PE)
  840.        Type:  Numeric (Default -1)
  841. Description:  For sounds, this tells TIV the period at which to play
  842.               the sample.  If the argument is -1, then TIV will use
  843.               whatever period can be determined from the file itself.
  844.               Otherwise, TIV will use the period given to play the
  845.               sample.  The period must be between 124 and 65536.
  846.               The higher the period, the lower the pitch of the
  847.               sound.  A good starting place would be around 300 to
  848.               400.
  849.  
  850. ------------------------------------------------------------------------
  851.  
  852.     Keyword:  RATE (RAT)
  853.        Type:  Numeric (Default -1)
  854. Description:  For animations, this tells TIV the number of jiffies
  855.               that each frame will be displayed.  A jiffy is one
  856.               1/60th second.  The default value of -1 will cause TIV
  857.               to get timing information from the file.  A rate of 0
  858.               will tell TIV to play the animation as fast as it
  859.               possibly can (up to 60 frames/second).  Any other 
  860.               positive value indicates the number of jiffies that
  861.               each frame will remain onscreen.  To get the number of
  862.               frames per second, divide the value you give this
  863.               option into 60.  For example, `RATE 2' is 60 / 2 = 30
  864.               frames per second.
  865.  
  866. ------------------------------------------------------------------------
  867.  
  868.     Keyword:  SOUNDPATH (SOUNDP)
  869.        Type:  String (No default)
  870. Description:  Reserved for future expansion.  Does nothing.
  871.  
  872. ------------------------------------------------------------------------
  873.  
  874.     Keyword:  XOFFSET (XO)
  875.        Type:  Numeric (Default 0)
  876. Description:  When displaying pictures and animations, the value
  877.               given here will be added to the horizontal overscan
  878.               position of the image.  Thus positive values move the
  879.               picture to the right, negative values move the picture
  880.               to the left.  I added this feature to correct for some
  881.               HAM-E pictures that overscan out of the detection range
  882.               of the HAM-E hardware.
  883.  
  884. ------------------------------------------------------------------------
  885.  
  886.     Keyword:  YOFFSET (YO)
  887.        Type:  Numeric (Default 0)
  888. Description:  When displaying pictures and animations, the value
  889.               given here will be added to the vertical overscan
  890.               position of the image.  Thus positive values move the
  891.               picture downward, negative values move the picture
  892.               upward.  I added this feature to correct for some HAM-E
  893.               pictures that overscan out of the detection range of
  894.               the HAM-E hardware.
  895.  
  896. ------------------------------------------------------------------------
  897.  
  898.      As you can see, the options are pretty extensive.  Most times,
  899. however, it will be sufficient to run the program with few options.
  900. However...
  901.  
  902.  
  903. 3.2.  Option Defaults File
  904.  
  905.      A lot of times you might find yourself using the same options
  906. over and over again on the command line.  TIV allows you to place
  907. these frequenty-used options in an `Options Defaults File'.  Before
  908. examining command line options, TIV will read in this Options
  909. Defaults File and use any options that it finds there.  This will
  910. eliminate the need for you to type them every time you need them.
  911.  
  912.      The file is a standard ASCII text file which resides in your
  913. current S: directory, called `TIV.Defaults'.  Each line of the file
  914. can contain an option for TIV, but only one option can be on each
  915. line.  Blank lines and lines beginning with a semi-colon (;) are
  916. ignored by TIV, so you can place comments in the file.  The options
  917. must be in the same format that you would type from CLI; that is, you
  918. must use (for example) `VIEW' or `NOCYCLE' rather than `VIEW=YES' or
  919. `CYCLE=NO'.
  920.  
  921.      Here is a sample TIV.Defaults file:
  922.  
  923. ;~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  924. ; TIV Defaults File
  925. ;
  926. ; Each option MUST be on a seperate line.
  927. ;
  928. ; Ignore object's .info files...
  929. NOINFO
  930. ;
  931. ; Picture Options:
  932. NOCYCLE
  933. ;
  934. ; Animation Options:
  935. CONTINUOUS 
  936. RATE 0
  937. ;
  938. ;~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  939.  
  940.      Options specified on the command line or in a file's Tool Types 
  941. array will override what is given in the defaults file. So if, with
  942. the above defaults file, you specify `CYCLE' on the command line, then
  943. pictures will be color cycled despite what it says in the defaults
  944. file.
  945.  
  946.      The Options Defaults File is read from Workbench as well as CLI,
  947. although it is less necessary from Workbench, as frequently used
  948. options can be placed into the TIV program's Tool Types.  From
  949. Workbench, options in the TIV program's Tool Types will override what
  950. is found in the TIV.Defaults file.
  951.  
  952.      In addition to the Defaults File in the S: directory, you can also 
  953. place an Options Defaults File in any subdirectory.  If you tell TIV
  954. to show all pictures in that subdirectory, it will read in the
  955. options found in that file and use them.  This allows you to have
  956. specific options for certain directories.
  957.  
  958.               
  959.         * - * - * - * - * - * - * - * - * - * - * - * - * - * - *
  960.  
  961.  
  962.                     4. TIPS, TRICKS, AND EXAMPLES              
  963.  
  964.  
  965. 4.1. Brushes and ANIM Brushes
  966.  
  967.      TIV can display all kinds of brushes and ANIM brushes.  However,
  968. at least DeluxePaint brushes and ANIM brushes do not save in their
  969. CAMG chunks the screen format that the brush came from.  TIV will do
  970. its best to guess at the proper screen resolution by looking at the
  971. source page width/height of the image.  In most cases this should
  972. suffice, but there are times when a brush still might fool TIV.
  973. Therefore, you might need to use the `HIRES' or `LACE' options in
  974. order for TIV to display the brush or ANIM brush correctly.  If you
  975. know that a particular brush came from an interlaced screen, for
  976. example, and TIV is displaying it as non-interlaced and the image is
  977. stretched vertically, then you will have to specify the `LACE' option.
  978.  
  979.      A note on ANIM brushes:  ANIM brushes use a really odd format
  980. for storage, which took considerable hacking and a few hints from
  981. various people before they became operational.  Anyway, you must have
  982. the CONTINUOUS option OFF to display ANIM brushes correctly (at least
  983. the ones that come from DeluxePaint3).  This is directly opposite from
  984. the way DeluxePaint3 (regular) animations are.
  985.  
  986.  
  987. 4.2. Slideshows
  988.  
  989.      TIV can be used to create quick and simple slideshows, with
  990. varying degrees of sofistication.  For example, suppose you have a disk
  991. in drive DF0: that contains a bunch of pictures.  To create a
  992. slideshow, from CLI you can type:
  993.  
  994.      1> TIV DELAY 2 ALL DF0:
  995.  
  996.      Presto!  All the pictures on the disk will be viewed, each one
  997. for 2 seconds before moving on.  You will see the Workbench between
  998. the pictures, though, so you might want to give it another option:
  999.  
  1000.      1> TIV SLIDESHOW DELAY 2 ALL DF0:
  1001.  
  1002.      With the addition of the SLIDESHOW option, TIV will double
  1003. buffer the picture show, preventing Workbench from being visible
  1004. between pictures.  As noted above, this looks better, but uses more
  1005. chip memory.
  1006.  
  1007.      In reality, the above commands would show ALL IFF files on the
  1008. disk, not just pictures.  So if you happen to have animations or
  1009. sounds mixed in with the pictures, they will be displayed too.  You
  1010. can, however, mask them out:
  1011.  
  1012.      1> TIV NOANIM NO8SVX SLIDESHOW DELAY 2 ALL DF0:
  1013.  
  1014.      `NOANIM NO8SVX' will mask out animations and sounds in the
  1015. slideshow.  You can see that after a while the options get cumbersome
  1016. to type.  There are two ways to get around this:  1) Create a small
  1017. script file that performs the above command, or 2) Create a Workbench
  1018. project icon that, when double-clicked, launches into the slideshow.
  1019.  
  1020.      To make the icon, you need to make a Project icon (a few are
  1021. supplied in the TIV archive).  Make sure the Default Tool for the
  1022. icon is set to where you are keeping the TIV program.  Then you need
  1023. to add a bunch of Tool Types to reflect what you were typing on the
  1024. command line:
  1025.  
  1026.      ANIM=NO
  1027.      8SVX=NO
  1028.      SLIDESHOW=YES
  1029.      DELAY=2
  1030.      ALL=DF0:
  1031.  
  1032.      Once these are added, save the icon.  Then double-click on it
  1033. and there you have your slideshow from Workbench.
  1034.  
  1035.  
  1036. 4.3.  DeluxePaint3 Animations
  1037.  
  1038.      I have noted a probem with DeluxePaint3's saving of animations. 
  1039. I believe that if you save only a portion of a larger animation, that
  1040. DeluxePaint somehow trashes the last few frames where the "loop"
  1041. frames should be.  Playing this animation with CONTINUOUS on can
  1042. cause strange results.  I would suggest loading the partial animation
  1043. back into DPaint, then saving it back out.  This should correct the
  1044. problem.
  1045.  
  1046.  
  1047. 4.4.  TIV and Workbench 2.0
  1048.  
  1049.      TIV has been tested and works largely as expected under
  1050. Workbench 2.0.  It has been tested under Kickstart versions 2.02 and
  1051. 2.04.
  1052.  
  1053.      However, there are a few problems that appear in certain
  1054. circumstances.  They are documented below:
  1055.  
  1056.      A.  View Mode - Apparently, there have been considerable changes
  1057.          in the way 2.0 handles Views and Viewports, especially
  1058.          overscanned.  In TIV, this manifests itself in vertically
  1059.          overscanned pictures or animations.  The image will not be
  1060.          centered vertically, and using the Control + Arrows do not
  1061.          affect it.  This may require a special version of TIV
  1062.          written for 2.0 only.
  1063.  
  1064.      B.  Brushes and ANIM Brushes - Another odd problem is in the
  1065.          viewing of brushes.  Under 2.0, a double-image appears to
  1066.          the right of the brush, out of the range of the screen or
  1067.          view.
  1068.  
  1069.      These are the only problems I have encountered.  I am in the 
  1070. process of researching them, and hope to have them fixed in the next
  1071. release of TIV.  If you have any suggestions, I'd be glad to hear
  1072. them.  My knowledge of 2.0 programming at this point is rather limited, 
  1073. I'm afraid, especially in the area of graphics.
  1074.  
  1075.      I apologize to you Amiga 3000 owners out there, but TIV has been
  1076. in Beta for so long and the massively buggy and featureless TIV 1.4 
  1077. has been out for so long that I felt I should release TIV 1.5 now.
  1078.  
  1079.  
  1080. 4.5.  TIV and HAM-E
  1081.  
  1082.      TIV is capable of viewing HAM-E images, as is any viewer program
  1083. worth its byte count.  However, you might notice that TIV can sometimes
  1084. overscan the HAM-E "magic cookie" out of the hardware's ability to detect
  1085. it.  This can be fixed several ways:
  1086.  
  1087.      A.  Adjust your Preferences screen position until HAM-E images
  1088.          "lock in", since TIV gets its idea of where the center of
  1089.          the screen is from your Preferences.  This may, however,
  1090.          cause your regular Workbench screen to be a little offset.
  1091.  
  1092.      B.  Adjust TIV's overscan offset using the options `XOFFSET'
  1093.          and `YOFFSET'.  Once you determine the proper offset, you
  1094.          can place these options into the `S:TIV.Defaults' file so
  1095.          that TIV will automatically add the proper offsets for
  1096.          every picture you view.
  1097.  
  1098.      C.  Or you could simply use the Control + Arrows to adjust the
  1099.          overscan position for every picture or animation you view.
  1100.  
  1101.      TIV is also capable of viewing HAM-E super bitmap pictures,
  1102. which is something that not every viewer program can do.  You might be
  1103. wondering why this is a big deal.  If you own a HAM-E you probably
  1104. know why it's a big deal.  If not, well don't worry about it.
  1105.  
  1106.      At this time, TIV does not support HAM-E color cycling pictures.
  1107. Sorry for the inconvenience.  It will in the future.
  1108.  
  1109.  
  1110. 4.6.  More Examples
  1111.  
  1112.      The following are some random examples for CLI useage.
  1113.      
  1114.      `TIV VIEW CONT RATE 0 myanim.anim'
  1115.  
  1116.           This line will play `myanim.anim' in the current
  1117.           directory as fast as TIV can possibly play it.  Speed
  1118.           will vary depending on the amount of changes from frame
  1119.           to frame, the resolution of animations, and the speed
  1120.           of your CPU.  60 FPS for low resolution animations is
  1121.           not uncommon.  And 30+ FPS for higher resolution is
  1122.           also not unheard of.
  1123.  
  1124.      `TIV NOCONT my.animbrush'
  1125.  
  1126.           Play the given ANIM brush.  Note that you MUST specify
  1127.           the `NOCONT' option when playing ANIM brushes,
  1128.           otherwise they will not play properly.  If you have a
  1129.           directory of ANIM brushes, place an Option Defaults
  1130.           File in that directory with the `NOCONT' option in it.
  1131.           TIV will then turn off continuous mode whenever you
  1132.           show all the ANIM brushes in that directory.
  1133.                     
  1134.      `TIV RECURSIVE ALL dh0:pictures'
  1135.  
  1136.           This will view all IFF pictures in the directory
  1137.           `dh0:pictures', AND it will show all IFF files in any
  1138.           subdirectories within `dh0:pictures'.  This is handy
  1139.           if you have your pictures broken down into
  1140.           subdirectories of Hi-Res, Lo-Res, HAM, etc.  The
  1141.           `RECURSIVE' option will go into each subdirectory to
  1142.           show pictures.
  1143.           
  1144.      `TIV NOANIM ALL dh0:iff_files'
  1145.  
  1146.           View pictures and sounds within the directory
  1147.           `iff_files'.  The `NOANIM' option given will cause TIV
  1148.           to skip any animations that it finds in this
  1149.           directory.
  1150.           
  1151.      `TIV RAWSOUND rawsample'
  1152.           
  1153.           Play the raw sound sample `rawsample' in the current
  1154.           directory.  You MUST specify the `RAWSOUND' option if
  1155.           you want to play raw sound samples, otherwise TIV will
  1156.           skip them saying they are not IFF files.  Note that
  1157.           TIV has no way of knowing the sampling rate of a raw
  1158.           sample, so it just guesses at 10,000KHz for all raw
  1159.           samples.  You may need to adjust this using the
  1160.           `PERIOD' option.
  1161.           
  1162.      `TIV NOWINDOW LOOPS 1 neatsound'
  1163.           
  1164.           This command is useful if you want to play a sample
  1165.           from you startup-sequence.  `NOWINDOW' will prevent
  1166.           TIV from opening its Information Window, and `LOOPS 1'
  1167.           will play `neatsound' 1 time only and then exit.
  1168.  
  1169.      `TIV SLIDESHOW LOOPS 1 DELAY 2 ALL df0:'
  1170.           
  1171.           Here is a basic slideshow presentation command line. 
  1172.           The `SLIDESHOW' option will double-buffer pictures and
  1173.           animations.  The combination of `LOOPS 1' and `DELAY 2'
  1174.           means that TIV will never have to wait for you to
  1175.           click a mouse button to continue, making this an
  1176.           automatic slideshow.  `ALL df0:' specifies where all
  1177.           the files are, in this case the internal floppy drive.
  1178.           
  1179.  
  1180.                         
  1181.         * - * - * - * - * - * - * - * - * - * - * - * - * - * - *
  1182.  
  1183.               
  1184.                          5. ACKNOWLEDGEMENTS
  1185.  
  1186.  
  1187.      Thanks to the following group for beta testing and giving
  1188. me (usually :) helpful suggestions and ideas:
  1189.  
  1190.      Kermit Woodall
  1191.      Mike Vunck
  1192.      Bob Fisher
  1193.      David Krehbiel
  1194.      Stuart Ragland
  1195.  
  1196.      Also thanks to Kermit for the icons.  If you remember the icons
  1197. supplied with TIV 1.4 and below, you'll notice what an enormous
  1198. improvement these icons are over the old ones.
  1199.  
  1200.      There are also numerous people who have been kind enough to 
  1201. publicly distribute source code examples that I have used and adapted
  1202. into this program.  I wish I could remember all of them but as this
  1203. program has been under development for quite some time now (at least
  1204. a year and a half, off and on) I tend to forget all of my sources. 
  1205. Some of the more notable ones are:  Jim Kent for his invaluable
  1206. `unvscomp.asm' animation uncompression code, Gary Bonham for general
  1207. animation code, the guys at EA for their IFF reading code, Dan Silva
  1208. for his color cycling code, the authors of the Rom Kernel Manuals for
  1209. sample audio code, and all those other bits and pieces that I can't
  1210. remember.
  1211.  
  1212.      TIV started as just a little program to test out some ILBM
  1213. routines I'd written for another program... now it's gone completely
  1214. out of control... :)
  1215.      
  1216.  
  1217.         * - * - * - * - * - * - * - * - * - * - * - * - * - * - *
  1218.  
  1219.  
  1220.                             7. THE FUTURE
  1221.  
  1222.  
  1223.      There are a few things I'd like to do to TIV in the future as I
  1224. get time.  They include:
  1225.  
  1226.      - Fix all the 2.0 problems.  Might take a while, unfortunately.
  1227.  
  1228.      - Add internal Dynamic Hires and Dynamic HAM support.  Need some
  1229.        more docs and code on this.
  1230.  
  1231.      - Support HAM-E color cycling.
  1232.           
  1233.      - Play ANIM's directly from disk at a reasonable rate.
  1234.  
  1235.      - Play 8SVX's directly from disk.
  1236.  
  1237.      If you have a suggestion or two, send them in along with your
  1238. Shareware donation.  I can't guarantee that I will implement your
  1239. suggestions but I will certainly make a note of them.  Bug reports will
  1240. be given immediate attention.
  1241.  
  1242.  
  1243.         * - * - * - * - * - * - * - * - * - * - * - * - * - * - *
  1244.  
  1245.               
  1246.                             6. THE AUTHOR
  1247.  
  1248.  
  1249.      I can be reached via. U.S. Mail at the following address:
  1250.  
  1251.      Thomas Krehbiel
  1252.      10747 Surry Road
  1253.      Chester, VA  23831
  1254.  
  1255.      I can be also be reached at the Late Nite Amiga BBS (804-262-9944)
  1256. as "Tom Krehbiel".  This is the Richmond Area's largest Amiga
  1257. supporting BBS and also happens to be the home of the Richmond Amiga
  1258. Group, Richmond's largest Amiga supporting user group.  Late Nite
  1259. is also connected to WWIVnet, so if you have access to a local
  1260. BBS running WWIV software which is also connected to WWIVnet, then
  1261. you can netmail me at the following address: Tom Krehbiel #13 @ 8405.
  1262.  
  1263.      Or, as a last resort, if you subscribe to a major network,  you can
  1264. relay a message to me through Kermit Woodall (thanks again, Kermit) on
  1265. the following networks:
  1266.  
  1267.      Plink          CAPT*VIDEO
  1268.      BIX            kermitwoodall
  1269.  
  1270.      Sorry, I don't have any network accounts myself... yet.
  1271.  
  1272.  
  1273.      Hope you find this program useful.  Have fun!
  1274.  
  1275.                                                   - Tom
  1276.