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