home *** CD-ROM | disk | FTP | other *** search
/ Amiga GigaPD 3 / Amiga_GigaPD_v3_1of3.iso / vt / vt.doc < prev    next >
Text File  |  1994-03-30  |  15KB  |  375 lines
  1.                Viewtek 1.04 - Another Picture/Animation Viewer
  2.  
  3.                          Written by Thomas Krehbiel
  4.                              Updated March 1993
  5.  
  6.  
  7.    (See the end of this document for changes since the previous version.)
  8.  
  9.  
  10. INTRODUCTION
  11. ~~~~~~~~~~~~
  12.    Some of you may remember an ILBM/ANIM viewer program I wrote a while back
  13. called "TIV".  Some would say that "Viewtek" is TIV 2.0, but I consider it a
  14. totally different and much improved program (no part of TIV is in Viewtek; it
  15. is all rewritten from scratch).  (If you're using TIV now under 2.0 I
  16. *strongly* suggest you dump it in favor of Viewtek.)
  17.  
  18.    Viewtek was written with a few objectives in mind.  I wanted a program
  19. that first and foremost was totally 2.0 (and 3.0) compatible. I wanted it to
  20. take advantage of 3.0 and the AGA chips wherever possible.  I wanted it to
  21. show ANIMs as good or better than TIV did, with support for any and all
  22. display modes.  I also wanted to be able to render decent (if not
  23. spectacular) representations of 24-bit ILBMs, GIFs, and JPEGs.  And I wanted
  24. to keep the program internally modular enough to support 3rd party display
  25. devices fairly easily (just in case).
  26.  
  27.    The result you have before you.
  28.  
  29.  
  30. FEATURES
  31. ~~~~~~~~
  32.    o Requires Workbench 2.04 or greater.
  33.    o Shows most ILBM's (including 24-bit ILBM's).
  34.    o Shows most Compuserve GIF format images.
  35.    o Shows most JFIF format JPEG images.
  36.    o Shows most ANIM Op5/Op7 format animations, with support for
  37.      different palettes for each frame.
  38.    o Supports SHAM, CTBL, and PCHG images.
  39.    o Full support of ECS/AGA display modes (ie. show 256 color GIF's
  40.      directly, show 800x600xHAM animations, etc.).
  41.    o Supports viewing contents of clipboard.
  42.    o Iconifies to a Workbench AppIcon.
  43.    o Includes a version written for GVP's Impact Vision 24, to support
  44.      true 24-bit display.
  45.    o And even includes a stripped-down version that doesn't show GIF's
  46.      or JPEG's for those who don't need it.
  47.  
  48.  
  49. NOTE
  50. ~~~~
  51.    I have no intention of supporting ANIM8 as long as there is an infinitely
  52. superior ANIM7 format around.  You, the animation user, would be wise to
  53. petition those who would use ANIM8 to use ANIM7 instead.  Unless you *want* a
  54. less efficient animation format.  'Nuff said.
  55.  
  56.    The included utility MakeAnim7 can be used to convert existing animations
  57. (5's or 8's) into the ANIM7 format.
  58.  
  59.    I have also included the documentation I received that describes the
  60. ANIM7 format.  To the best of my knowledge, there are no limitations on
  61. its distribution.
  62.  
  63.  
  64. DISTRIBUTION
  65. ~~~~~~~~~~~~
  66.    Viewtek is being distributed as Freeware.  It may be freely distributed to
  67. any bulletin board service, network, or public domain collection, so long as
  68. no fees (beyond reasonable media fees) are charged for such distribution.
  69. I'm not asking for donations on this one, but feel free to drop me a note
  70. (preferably e-mail) or something if you want.
  71.  
  72.    Note, however, that Viewtek is NOT public domain.  The author retains all
  73. rights to the program.
  74.  
  75.  
  76. OOPS!
  77. ~~~~~
  78.    Previous versions of the Viewtek documentation left out a very important
  79. statement:
  80.  
  81.    This software is based in part on the work of the Independant JPEG Group.
  82.  
  83.    I'd just like to apologize to the Independant JPEG Group for not having
  84. included this, they deserve full credit for their work in bringing this
  85. popular compression format to the computer world at large.
  86.  
  87.  
  88. INSTALLATION
  89. ~~~~~~~~~~~~
  90.    Viewtek requires no special libraries or fonts or anything to run. Simply
  91. drag the Viewtek icon to wherever you wish to install it.  It may be run from
  92. a Shell, Workbench, or even your favorite dirutil.
  93.  
  94.    The IV-24 version of Viewtek, however, requires that you have a copy of
  95. GVP's "fye.library" in your LIBS: directory.  (If you have an IV-24, chances
  96. are pretty good you have this installed already.)
  97.  
  98.  
  99.  
  100. DISABILITIES
  101. ~~~~~~~~~~~~
  102.    Okay, what *doesn't* it do?
  103.  
  104.    - No color cycling (yet?).  Why?  I have exactly one picture that
  105.      color cycles out of hundreds of images and I never look at it
  106.      anyway, so it wasn't a high priority.
  107.  
  108.    - Some CTBL images may not quite show properly, more than likely
  109.      due to more palette changes per line than can be shown properly
  110.      with the copper.  Same may be true for SHAM pictures.  I probably
  111.      will not fix this because I don't really see much value in these
  112.      types of pictures anyway.  It may help to force the images
  113.      to be shown in NTSC/PAL on an A4000, or move the picture
  114.      to the right (with control arrow keys).  With better displays
  115.      becoming more widely available, this is also not a priority
  116.      to work on.
  117.  
  118.    - Does not (yet?) support a non-existant first-frame BODY as
  119.      specified for ANIM7 animations.  (Personally, I think this is
  120.      a bad thing anyway.)
  121.  
  122.    - Known incompatibility:  VT doesn't interact well with the Commodore
  123.      mouse blanker supplied with 3.0 when showing animations.  When
  124.      you move the mouse after it has been blanked (eg. after hitting some
  125.      keys during the animation), the screen goes black.
  126.  
  127.  
  128.  
  129. USEAGE FROM SHELL
  130. ~~~~~~~~~~~~~~~~~
  131.    Files/M        One or more files/directories/patterns.  Standard
  132.                   AmigaDOS wildcards are supported.
  133.  
  134.    Delay/N        Time in seconds to show each file before moving on.
  135.                   Default is to wait for user to click a button.
  136.  
  137.    LowMem/S       Do not double-buffer pictures, saves some chip memory.
  138.  
  139.    Repeat/N       Number of times to repeat showing the pictures.
  140.  
  141.    Hide/S         Hide the process of reading the pictures; by default you
  142.                   can watch as VT scans in the image.  Note that for large
  143.                   GIF's and IFF24's, scanning in the image can take a
  144.                   while, so hiding the process can cause some confusion.
  145.                   Also note that when viewing on the IV24, hide is
  146.                   automatically enabled (due to the nature of the IV24).
  147.  
  148.    All/S          Recursively enter subdirectories to show pictures.
  149.  
  150.    Iconify/S      Launch VT in iconified mode (handy for putting VT in
  151.                   your WBStartup drawer).
  152.  
  153.    Forever/S      Repeat showing the pictures forever and ever and ever.
  154.  
  155.    Clip/S         Show contents of clipboard instead of a file.
  156.  
  157.    Unit/N         Select clipboard unit number, default is 0.
  158.  
  159.    Loop/N         Number of times to loop animation before proceeding,
  160.                   default is to loop forever.
  161.  
  162.    Speed/N        Animation playback speed, in jiffies/frame.
  163.  
  164.    Cont/S         Force animations to be considered "continuous", that is,
  165.                   the animations are assumed to have 2 looping frames
  166.                   built onto the end.  Normally, VT will only play an
  167.                   animation in continuous mode if a DPAN chunk is found
  168.                   (DPaint animations are always continuous).  There is no
  169.                   other way that I know of to tell if an animation is
  170.                   continuous or not.
  171.  
  172.    Lores/S        Force an image or animation into lores.
  173.  
  174.    Hires/S        Force an image or animation into hires.
  175.  
  176.    NoLace/S       Force an image or animation into non-interlace.
  177.  
  178.    Lace/S         Force an image or animation into interlace.
  179.  
  180.    NoBusy/S       Normally, VT displays a busy pointer as it reads in
  181.                   images.  This option disables that busy pointer.
  182.  
  183.    Default/S      Force images to use Default monitor (useful for forcing
  184.                   NTSC stuff to promote to scan-doubled on an AGA machine).
  185.  
  186.    NTSC/S         Force images to use NTSC monitor.
  187.  
  188.    PAL/S          Force images to use PAL monitor.
  189.  
  190.    ILBM/S         Force VT to look for FORM ILBM's, regardless of
  191.                   what the file actually is.  Can be used to show the first
  192.                   frame of an ANIM as a static picture.
  193.  
  194.    NoScroll/S     Force VT not to make picture screens autoscroll.
  195.                   For some reason, making a Super72 or SuperHires screen
  196.                   autoscroll shifts it way over to the left (at least on
  197.                   my machine), so here is the somewhat kludgy solution
  198.                   until I figure out what gives here.
  199.  
  200.    Save/K         After looking at Steve Hines' "QuickGrab" program (an
  201.                   excellent utility, BTW), I realized that it could be
  202.                   useful to save the resulting images that VT renders of
  203.                   GIF's and JPEG's for posterity.  So, this option
  204.                   (which must be followed by a filename) will save the
  205.                   screen that VT produces to a standard ILBM file.  Just
  206.                   keep in mind that the images VT renders aren't nearly
  207.                   as good as can be done with a dedicated renderer (like,
  208.                   say, ImageFX or Rend24 :).
  209.  
  210.    Super72/S      Force images to use the Super72 monitor.
  211.  
  212.    SuperHires/S   Force an image or animation into super hires.
  213.  
  214.    ScreenMode/K   Gives you ultimate control over the display mode that
  215.                   pictures are shown in.  This lets you enter a screenmode
  216.                   by name so that all pictures are forced into this mode.
  217.                   The name must be given exactly (except for case).  A
  218.                   list of mode names can be found in the ScreenMode prefs
  219.                   program.
  220.  
  221.    Paused/S       When playing animations, they will come paused on the
  222.                   first frame.
  223.  
  224.    FPS/N          Directs VT to play an animation at the rate specified,
  225.                   given as frames per second.  This is different frame
  226.                   the SPEED option, which is in jiffies/frame.
  227.  
  228.  
  229. EXAMPLES
  230. ~~~~~~~~
  231. 1> VT picdir
  232.  
  233.    Show all files in the "picdir" directory.
  234.  
  235. 1> VT picdir ALL
  236.  
  237.    Show all files in "picdir", including subdirectories.
  238.  
  239. 1> VT picdir SUPER72 SUPERHIRES LACE
  240.  
  241.    Show all files in "picdir", forcing them into Super72 800x600 mode.
  242.  
  243. 1> VT myjpeg SAVE ram:mypic
  244.  
  245.    Show "mpjpeg", and save the resulting screen to "ram:mypic".
  246.  
  247. 1> VT picdir HIDE
  248.  
  249.    Show all files in "picdir", but don't show each picture until it is
  250.    fully read into memory.
  251.  
  252. 1> VT picdir FOREVER DELAY 2
  253.  
  254.    Show each file in "picdir" for 2 seconds, repeat forever.
  255.  
  256. 1> VT picdir SCREENMODE "MULTISCAN:Productivity"
  257.  
  258.    Show all files in "picdir", forcing each one into Productivity mode.
  259.  
  260.  
  261.  
  262. USEAGE FROM WORKBENCH
  263. ~~~~~~~~~~~~~~~~~~~~~
  264.    All of the options above may be used (except Files/M) as a tool type.
  265. The following additional tool type may be set:
  266.  
  267.    DEFAULTDIR     Choose default directory where file requester opens.
  268.  
  269.  
  270.  
  271. VIEWING COMMANDS
  272. ~~~~~~~~~~~~~~~~
  273.    ESCAPE         Abort viewing immediately.
  274.  
  275.    BACKSPACE      Abort viewing current directory (when using 'ALL').
  276.  
  277.    LMB/RMB        Go to next picture.
  278.  
  279.    SPACE          Will hold on the current picture, when using DELAY.
  280.  
  281.    CTRL+Arrows    Move image/anim around on the display (overscan position).
  282.  
  283.    Up Arrow       (Anim Only) Return to beginning of the animation.
  284.  
  285.    Right Arrow    (Anim Only) Pause/single step animation.
  286.  
  287.    Down Arrow     (Anim Only) Resume playing animation after paused.
  288.  
  289.    C              (Anim Only) Toggle "continuous" mode.
  290.  
  291.    F1             (Anim Only) Play animation as fast as possible.
  292.    F2             (Anim Only) Play animation at 60fps.
  293.    F3             (Anim Only) Play animation at 30fps.
  294.    F4             (Anim Only) Play animation at 24fps.
  295.    F5             (Anim Only) Play animation at 15fps.
  296.    F6             (Anim Only) Play animation at 12fps.
  297.    F7             (Anim Only) Play animation at 10fps.
  298.    F8             (Anim Only) Play animation at 5fps.
  299.    F9             (Anim Only) Play animation at 1fps.
  300.    F10            (Anim Only) Play animation at rate specified in ANIM file.
  301.  
  302.  
  303. THE AUTHOR
  304. ~~~~~~~~~~
  305.    I can be reached on BIX as "tkrehbiel" if you want to email me about
  306. something (like, say, bugs).  BIX is now connected to the Internet, so my
  307. Internet address is "tkrehbiel@bix.com".
  308.  
  309.    You can also reach me on the Late Nite BBS (804-262-9944) as Tom Krehbiel
  310. (user #13).
  311.  
  312.    As a last resort my U.S. Mail address is:
  313.  
  314.       Thomas Krehbiel
  315.       10747 Surry Road
  316.       Chester, VA  23831
  317.  
  318.    (Don't expect quick mail response.)
  319.  
  320.  
  321. SHAMELESS PLUG
  322. ~~~~~~~~~~~~~~
  323.    Buy ImageFX.  You won't regret it.  Honest.  :)
  324.  
  325.  
  326.  
  327. REVISION HISTORY
  328. ~~~~~~~~~~~~~~~~
  329. 1.04     2/20/93     Supports ANIM7 (short & longword) animations.
  330.                      Supports ANIM brushes.
  331.                      Now uses the latest version of Tom Lane's JPEG code.
  332.                      Fixed SAVE option (CMAP specifically) under < V39.
  333.                      Added SUPER72, SUPERHIRES, and SCREENMODE keywords.
  334.                      Changed the way it picks JPEG viewmodes.
  335.                      Tells you how many frames are in the anims it plays.
  336.                      Now uses new graphics double buffering under V39.
  337.                      Added PAUSED option for animations.
  338.                      Added a FPS option to set frame rate in fps.
  339.  
  340. 1.03b    1/10/93     Now allows showing directories via. file requester.
  341.                      Shows >= 800x600 GIF's in Super72 mode if available.
  342.                      More robust error messages on display open fail.
  343.                      Now uses BestModeID to show undisplayable modes.
  344.                      Doesn't close screen on first click of LMB after inactivity.
  345.  
  346. 1.03a    12/15/92    Fixed unbelievably stupid bug in AppIcon stuff.
  347.  
  348.  
  349. 1.03     12/10/92    Fixed hanging locks when used as AppIcon.
  350.                      Added LORES,NOLACE,ILBM options.
  351.                      Always sets autoscroll now, and still centers 'em.
  352.                      Added NOSCROLL option to disable autoscroll.
  353.                      Added SAVE option to save rendered pictures.
  354.                      Handles animation playback a bit better.
  355.  
  356. 1.02a    11/25/92    More accurate overscan calculation.  (Maybe not)
  357.  
  358. 1.02     11/24/92    Stock version renders to HAM8 mode if available.
  359.                      Oops, fixed so you can select just one file from ASL freq.
  360.                      Fixed problem with VT's abort "sticking".
  361.                      Fixed problems with centering AGA animations.
  362.                      Added NTSC/PAL/DEFAULT options.
  363.                      Now examines DPAN chunks for frame rates.
  364.                      Fixed problems with 'odd' sized anims on AGA.
  365.                      Defers allocating ASL struct until needed.
  366.                      More generalized copper stuff.
  367.  
  368. 1.01     11/10/92    Now more intelligent about picking JPEG viewmodes.
  369.                      Handles ANIMs with masking planes.
  370.                      Now able to respect ANIM's reltime by pressing F10.
  371.                      Added busy pointer while loading images.
  372.  
  373. 1.00     11/4/92     Initial version.
  374.  
  375.