home *** CD-ROM | disk | FTP | other *** search
/ CD-ROM Magazin 1995 October / CD_10_95.BIN / share / dos / vid4dos / vfd.doc < prev    next >
Text File  |  1995-04-13  |  35KB  |  716 lines
  1.  
  2.                             VFD(tm) Video for DOS 
  3.                             Release 1.6g (4/13/95)
  4.              Copyright (c) 1994,95 by Bob Williamson  CIS 76570,2752
  5.                
  6.       VFD(tm) is a DOS command-line motion video cross-compiler for creating 
  7.       .FLC, .FLI and .AVI files from:
  8.  
  9.       Windows .DIB files (all BMP & RLE)
  10.       Windows .RDI files (RIFF DIB)
  11.       Windows .BMP files (1, 4, 8, 16 & 24-bit)
  12.       Windows .RLE files (4 & 8-bit, including deltas)
  13.       IBM OS/2 .BMP files (1, 4, 8 & 24-bit)
  14.       Truevision .TGA files (8, 16, 24 & 32-bit rle & uncmp)
  15.       Zsoft .PCX files (8 & 24-bit)                     *registered version*
  16.       Autodesk .FLC and .FLI files (all)
  17.       Windows .AVI files (RLE and 8, 16, & 24-bit DIB)
  18.       MPEG .RAW files produced by DMPEG.EXE v1.1 (8 & 24-bit)
  19.  
  20.       VFD will extract a numpic file series from FLC, FLI, RAW, and AVI 
  21.       (RLE & DIB only) in BMP, RLE, GIF, PCX or TGA formats.  Direct 
  22.       conversion of FLC, FLI, AVI and single image formats is also supported.
  23.  
  24.       VFD uses an advanced method of color quantitization called Hilite
  25.       Promotion (Scaleable Adaptive, Histogram-based).  Hilite Promotion 
  26.       produces 8-bit motion video with high color fidelity and image 
  27.       resolution from a diverse range of image files and palettes by using 
  28.       scaleable quantitization (color reduction) and variable dither 
  29.       intensity.  Hilite Promotion can be used to create an optimum palette 
  30.       containing both the most popular colors and the most diverse colors 
  31.       from the input images.
  32.  
  33.       Hilite Promotion was developed as a solution to the motion video color 
  34.       quantitization problem of multiple images and palettes.  It may be 
  35.       used for building compatible Windows identity palettes for one or more 
  36.       bit-mapped images to be displayed by Windows, as well as motion video.
  37.  
  38.       PARAMS:
  39.  
  40.       VFD options may be invoked by use of command-line parameters.  The
  41.       parameters follow the infile, preceded by a space and either a forward 
  42.       slash '/' or a hyphen '-'.  The params may be in any order and are case 
  43.       insensitive.  Typing 'VFD <enter>' will display a list of the options: 
  44.       
  45.   VFD infile [params]
  46.   -I         create .FLI (default is .FLC)
  47.   -An        create .AVI n=1 8-bit DIB, n=2 RLE 
  48.   -En        Extract numpic series n=1 8-bit .BMP, n=2 .RLE delta, n=3 .GIF
  49.              n=4 8-bit .PCX, n=5,6,7: 8,16,24-bit .TGA uncmp
  50.   -Sn        playback Speed in frm/sec n=0.1 to 99 (default=15)
  51.   -Ofname    Outpath [d:\path\]fname (default fname=infile w/ outtyp .ext)
  52.   -Tn1[,n2]  Total frames n1=start, n2=total count (disables B2 pingpong)
  53.   -Mn        CoMpression n=1 50%, n=2 67%, n=3 75%, n=4 80%, ..., n=99 99%
  54.   -Kn        Keyframe interval n=1 to 65535 (Default is no keyframes)
  55.   -Bn        Backward n=1, pingpong n=2, mirror n=3, flip n=4 (B1,B2:numpic)
  56.   -Rn        Resize n=1 1/2, n=2 2x n=3 override dflt FLI aspect correction
  57.   -Cn        Color count n=2 to 255 (default=256)
  58.   -Hn        Hilite promotion (range 0 to 255) Use to override default.
  59.   -Dn        Dither (intensity range 0 to 255) Use to override default.
  60.   -L±n[,c]   Luminance n=1 to 255 (+ lite, - dark) (c=r,g,b: red,green,blue)
  61.   -Wn        Windows id palette n=1 mapped (default), n=2 not map, n=0 no id
  62.   -Fn        Fixed Windows id pal n=1 Indeo, n=2 gray, n=3 hlftne, n=4 b&w
  63.   -Pn        write Pal n=1 RIFF .PAL, n=2 DIB .PAL, n=3,4 AA,AAPro .COL,
  64.              n=5 PicLab .MAP, n=6 PSP .PAL, n=7 NeoPnt .PAL, n=8 generic .PAL
  65.  
  66.       The infile may be any of the above listed image file formats.  VFD 
  67.       will read a numpic series if wildcards ('*' or '?') are used in the 
  68.       file name. The infile may include the path. The output file path is 
  69.       the current default.  Examples:
  70.  
  71.       VFD pretty00.bmp                     (produce a one frame .FLC
  72.                                            PRETTY.FLC)
  73.  
  74.       VFD pretty*.rle                      (produce a 100 frame .FLC
  75.                                            starting w/ pretty00.rle
  76.                                            thru pretty99.rle named
  77.                                            PRETTY.FLC)
  78.  
  79.       VFD d:\pretty\pretty??.rle -a2 -w1   (produce PRETTY.AVI with a 
  80.                                            Windows identity palette)
  81.  
  82.       VFD pretty.avi -i                    (produce PRETTY.FLI)
  83.                                            
  84.       MAKEFILE:
  85.  
  86.       Typing 'VFD -? <enter>' will display the following:
  87.  
  88.       The infile for VFD may be a text file with the extension of .MAK which 
  89.       lists the source image files and optional keywords.  If a motion video 
  90.       file is used in the makefile, it must be the only input image file.  
  91.       The keywords are: 
  92.       
  93.             REPEAT_n (repeat the previous input file 'n' times)
  94.             PINGPONG (read the previous numpic series in reverse order) 
  95.             BACKWARD (read the following numpic series in reverse order)
  96.             MIRROR_ON (the following frames will be mirror-image)
  97.             MIRROR_OFF (turn mirror-image off)
  98.             FLIP_ON (the following frames will be inverted)
  99.             FLIP_OFF (turn inverted off)
  100.             TRANSPARENT_r,g,b (the rgb color will be transparent - AVI only)
  101.             TRANSPARENT_OFF (turn transparent off)
  102.             KEYFRAME (the following frame will be a keyframe)
  103.             CD-ROM (the AVI video chunks will be padded for CD-ROM playback)
  104.             CROP_n1,n2,n3,n4 (n1=top, n2=left, n3=width, n4=height) zero base
  105.       
  106.       Keywords are not case-sensitive.  The comment character is a semicolon.
  107.  
  108.       Example text of PRETTY.MAK:
  109.                                  ;216 frames, 320x240, identity pal
  110.                                  pretty.pal
  111.                                  d:\pretty\pretty00.bmp
  112.                                  REPEAT_8
  113.                                  d:\pretty\pretty??.bmp
  114.                                  d:\pretty\pretty99.bmp
  115.                                  REPEAT_8
  116.                                  PINGPONG
  117.  
  118.      The above example will produce PRETTY.FLC containing 10 frames of 
  119.      pretty00.bmp, 98 frames of pretty01.bmp thru pretty98.bmp, 10 frames 
  120.      of pretty99.bmp and 98 frames of pretty98.bmp thru pretty01.bmp.  The
  121.      palette file pretty.pal will be used for the motion video palette.
  122.      PINGPONG repeats the previous numpic series in reverse, omitting the 
  123.      first and last frames.  
  124.  
  125.      The maximum frame count is 65535.  The maximum makefile size is 16kb.
  126.      Numpic series with the same base name are limited to a maximum of 5460 
  127.      frames.  VFD reads stdin for response to input prompts.  VFD may be 
  128.      invoked in a batch file (.BAT) using redirection of a text file for 
  129.      input response.  The system date, time and command line params are 
  130.      inserted as the first comment line in the makefile each time the 
  131.      makefile is processed by VFD.  Input image files are opened read-only.
  132.      
  133.      The .MAK extension is not required on the command line.  'VFD pretty' 
  134.      is equivilent to 'VFD pretty.mak'.
  135.  
  136.      HILITE PROMOTION:
  137.       
  138.      Any combination of input image types and color formats (1 to 32 bit) 
  139.      may be combined in a VFD makefile.  If the total color count exceedes 
  140.      256, Hilite Promotion and dither should be used to obtain the optimum 
  141.      output for 8-bit video.  VFD builds a popularity histogram of all the 
  142.      colors from the input images.  The motion video palette consists of the 
  143.      256 most popular colors less the Hilite Promotion value.  The Hilites 
  144.      are then added to the motion video palette from the remaining colors in 
  145.      the histogram.  The Hilites are selected as those colors in the 
  146.      histogram having the greatest difference from the colors already 
  147.      included in the motion video palette.  If the '-Cn' (color count) option 
  148.      is used, the Hilite value is subtracted from the color count.  Black, by 
  149.      default, is always the first color in the motion video palette.
  150.  
  151.      A Hilite value of 255 (true-cut) will produce results similar to the 
  152.      standard unbiased median-cut method of color reduction.  With Hilite 
  153.      promotion, the palette colors are actual colors from the input images, 
  154.      not averaged colors.  Lower Hilite values (-H128) will often produce the 
  155.      best results for motion video and generate a smaller file, as less 
  156.      dither is required.  The lower value guarantees inclusion of the true 
  157.      most popular colors in the video palette.  If reducing a single image, 
  158.      or making a slide show, use -H255 -D128 for best results.
  159.  
  160.      Motion video created from digital video capture (16/24-bit color) can be 
  161.      converted to  8-bit color motion video with very good results by using 
  162.      Hilite Promotion and dither.  Start with -H128 -D20 and adjust up or 
  163.      down to produce the best result.  For ray trace input, start with -H160  
  164.      -D8. As Hilite value increases, the dither requirement decreases.
  165.  
  166.      A default Hilte and Dither value is used if the color count exceeds
  167.      255 and no Hilite and Dither values are given on the command line.
  168.      The default is replaced by the command line values when they are given.
  169.      Params of -H0 and -D0 will disable the defaults.
  170.  
  171.      DITHER:
  172.  
  173.      Dither will reduce or eliminate 'color banding'.  Dither may be used 
  174.      even when the total color count is less than 256.
  175.  
  176.      VFD uses the 'Floyd-Steinberg' dither pattern in alternating direction
  177.      (serpentine).  The dither intensity (-Dn) is the maximum difference 
  178.      between the true pixel value and the motion video palette value that 
  179.      will be used in the error dispersion.  Lower dither values produce less 
  180.      'background animation'.
  181.  
  182.      COMPRESSION:
  183.  
  184.      Motion video compression (data rate reduction) may be achieved in two 
  185.      ways: Reduce the data content (image quality) of each frame, or by 
  186.      reducing the frame count and the playback speed by a corresponding 
  187.      amount.  VFD uses the second of the two compression methods.  VFD motion 
  188.      video image quality is always 100%.  The range (-Mn) is n=1 50% to n=99 
  189.      99%.  Compression may be used with Extraction of a numpic series as well 
  190.      as motion video output.  Example:
  191.  
  192.               -M1    write 1, skip 1, write 1, ...    Speed/2     50%
  193.               -M2    write 1, skip 2, write 1, ...    Speed/3     67%
  194.               -M3    write 1, skip 3, write 1, ...    Speed/4     75%
  195.               ...
  196.               -M99   write 1, skip 99, write 1, ...   Speed/100   99%
  197.  
  198.      Use of compression is recommended when processing 24 or 30 frame/sec
  199.      input.
  200.  
  201.      PALETTES:
  202.  
  203.      The motion video palette may be output with the '-Pn' param. VFD reads
  204.      and writes the following palette formats: 
  205.  
  206.                   -P1     RIFF .PAL (VFW PalEdit)
  207.                   -P2     DIB .PAL (Windows Paintbrush)
  208.                   -P3,4   AA,AAPro .COL (Autodesk Animator, AA Pro)
  209.                   -P5     ascii .MAP (PicLab - DOS Public Domain)
  210.                   -P6     ascii .PAL (Paint Shop Pro - Windows Shareware)
  211.                   -P7     ascii .PAL (NeoPaint - DOS Shareware)
  212.                   -P8     generic .PAL (Improcess - DOS Shareware)
  213.  
  214.      The programs in parentheses are applications that can read and edit the 
  215.      specific palette format.  Ascii palette files may also be edited with a 
  216.      text editor.  The edited palette may be used as the motion video palette 
  217.      by including it as the first file in the makefile.  The Color count 
  218.      (-Cn) and Windows id pal (-Wn) params are disabled when a palette is 
  219.      read from the makefile.  Windows Paintbrush will only read DIB palette 
  220.      files with 28 colors maximum.
  221.  
  222.      ID PALETTES:
  223.  
  224.      The Windows identity palette option (-Wn) will add the 20 reserved 
  225.      Windows system colors to the motion video palette.  The 20 colors are 
  226.      subtracted from the color count prior to subtracting the Hilite 
  227.      Promotion value.  The identity pal may be mapped (-W1) or not mapped 
  228.      (-W2) to the motion video palette.  VFD maps the closest color in the 
  229.      motion video palette to the color in the input image using the spherical
  230.      distance method.  
  231.  
  232.      Some motion video, while requiring the identity pal for compatibility 
  233.      under Windows, will look better when mapped only to the colors from the 
  234.      input file (-W2).  
  235.  
  236.      FIXED PALETTES:
  237.  
  238.      VFD provides 4 fixed palettes:    -F1 = 256 color Indeo Win identity pal
  239.                                        -F2 = 32 color grayscale Win id pal
  240.                                        -F3 = 32 color halftone Win id pal
  241.                                        -F4 = black & white Windows id pal
  242.  
  243.      The -F1 default is mapped identity pal.  The -F2, -F3 and -F4 defaults 
  244.      are not mapped identity pal.  The defaults may be overridden by use of 
  245.      the -W1 or -W2 params.  Example:
  246.  
  247.                                      -F4 -W1 will use the 20 color Windows
  248.                                      identity palette (b&w are id colors)
  249.  
  250.                                      -F4 -D128 for dithered b&w output
  251.  
  252.      The Luminance '-L±n[,c]' param color channel option '[,c]' may be used 
  253.      to change the tint of the grayscale and halftone palettes.  The '-Cn'
  254.      color count param is disabled when a fixed palette '-Fn' is used.
  255.  
  256.      RESIZE & ASPECT:
  257.  
  258.      The '-R1' param will halve the vertical and horizontal dimensions of 
  259.      the input image.  Example: 640x480 -> 320x240.  The -R2 param will 
  260.      double the vertical and horizontal dimensions of the input file.
  261.      Example: 320x240 -> 640x480.
  262.  
  263.      VFD prompts for screen aspect correction to high resolution mode if 
  264.      the source files are 320x200 and the output format is .FLC or AVI. If 
  265.      the source files are not 320x200 or 160x100 and the output is .FLI, the 
  266.      images are corrected from high resolution mode to FLI aspect by default.
  267.      Default FLI aspect correction may be overridden by using the -R3 param.
  268.  
  269.      The maximum input and output image size is 1024x768.  Input image size 
  270.      for .FLC and .AVI output must be consistant.  Input image size for .FLI 
  271.      output may vary from a maximum of 640x480 (the output for .FLI will 
  272.      always be 320x200, with image centered).
  273.  
  274.      Sequence of geometic operations:   Resize 1/2
  275.                                         Mirror
  276.                                         Resize 2x
  277.                                         Crop
  278.                                         Aspect
  279.      CONVERTING AVIs:
  280.  
  281.      Many .AVI files are compressed with formats for which there are no  
  282.      Public DOS drivers.  These files must be converted to RLE or Full
  283.      Frames with VFW VidEdit or a similar Windows program for use with VFD.  
  284.      If the AVI is 8-bit color, save the file as RLE or 8-bit DIB.  
  285.      For 16 & 24-bit AVIs, save the file as a 16 or 24-bit DIB.
  286.  
  287.      When saving in RLE format for VFD input, set the target to custom, no 
  288.      data rate, no keyframes, no CD-ROM padding, and set quality at 100%.  
  289.      If the data rate is not set to a high value, data may be lost when 
  290.      converting to RLE compression using VidEdit.
  291.  
  292.      Capture files created with a capture card may be converted to full frame
  293.      compression option for processing with VFD.
  294.  
  295.      AVIs created with VFD may be converted to other compression options 
  296.      with VidEdit.  If VidEdit returns 'out of memory' errors when converting 
  297.      RLE compressed AVIs, use VFD to add keyframes (-K15 -A2).
  298.  
  299.      If you do not already have Video for Windows, it is free for the asking,
  300.      and includes VidEdit, PalEdit, and WavEdit. (VFW is no longer offered for
  301.      retail sale by MS.)  On CIS, download JSCD.TXT, 305 bytes, 13-Jul-94, 
  302.      from the WINMM forum.
  303.  
  304.      For those without CIS access, this is the text file verbatim:
  305.  
  306.      >> To get the Jumpstart CD:
  307.  
  308.      >> 1. Send a Fax to (206)936-7329 attn: MMDRG/Jumpstart.
  309.      >> 2. Send an Internet Email message to mmdinfo@microsoft.com
  310.  
  311.      >> The CD is free for a limited time only. Act today, operators
  312.      >> are standing by, etc, etc.
  313.  
  314.      >> Happy Coding,
  315.  
  316.      >> Rick Segal, Manager, Developer Relations
  317.      >> Microsoft
  318.  
  319.      ** Make sure to include your snail mail address (street addr - no POB)
  320.      & telephone number.  Delivery in U.S. usually takes 2 or 3 weeks.
  321.  
  322.      The Jumpstart CD is also included in the Sirus 5 ft 10 pack #2 avaliable
  323.      from discount retailers and mail order for about $35.
  324.  
  325.      RLE DELTAS:
  326.  
  327.      Deltas are the differences between the current frame and the previous 
  328.      frame.  Delta encoding uses line and column skips to create 
  329.      transparency.  When a delta input series is processed, the frames are
  330.      overlayed with the transparent portion unchanged from the previous 
  331.      frame.  Delta input series may not be dithered with VFD.  If dither is
  332.      required, the delta series should be extracted from a motion video that 
  333.      was created using dither. 
  334.      
  335.      VFW BitEdit, Paint Shop Pro (Windows Shareware), and AAWIN (Freeware 
  336.      Autodesk player for Windows) read and display RLE deltas correctly.
  337.  
  338.      The first frame of a RLE delta series is a keyframe (opaque), and the 
  339.      following frames are all deltas (transparent except for changes from the 
  340.      previous frame).  Full frame (opaque) RLE series may be extracted by 
  341.      using the Keyframe param: -E2 -K1.
  342.  
  343.      RLE delta input files should not be used with the Backward, Pingpong 
  344.      coMpress, or Total (where n1 > 1) options.
  345.  
  346.      CHROMA KEY OVERLAYS:
  347.  
  348.      Titles, copyright notices, etc. may be added to AVI motion video using
  349.      transparent RLE delta overlays.  First, make a title frame using any
  350.      paint or drawing program, and save it as TITLE1 (in RLE image format). 
  351.      Extract a RLE image series from the target video. Then create a make 
  352.      file using the TRANSPARENT_rgb keyword to set the title frame background 
  353.      invisible.  The makefile (pretty.mak) should look like this:
  354.  
  355.      first.rle                  ;first frame renamed
  356.      TRANSPARENT_0,0,0          ;black
  357.      title1.rle                 ;title frame 
  358.      REPEAT_20                  ;optional
  359.      TRANSPARENT_OFF
  360.      pretty*.rle                ;second thru last frame
  361.  
  362.      'VFD pretty -a2' will produce a new AVI with the title frame overlaying 
  363.      the first frame.  
  364.  
  365.      SPEED:
  366.  
  367.      VFD may be used to produce slideshows as well as motion video.  Playback 
  368.      speed range is from 0.1 to 99 frames/sec.  Fractional rates above 1 
  369.      frame/sec are not supported.  Some .FLC & .FLI players do not accept 
  370.      speed values less than 1 frm/sec.  VFD produced .AVIs with speeds less 
  371.      than 1 frm/sec may be converted with VFW VidEdit to other compression 
  372.      types and retain a speed of less than 1 frm/sec, even though VidEdit 
  373.      v1.1 will only set rates of 1 to 99 frames/sec. Example: 
  374.      
  375.                       -S.1 = 10 seconds per frame 
  376.                       -S.2 =  5 seconds per frame  
  377.                       -S10 = 10 frames per second
  378.      
  379.      When using VFD to create looping AVI slideshows, the REPEAT_1 makefile 
  380.      keyword should be used to repeat the last frame for play with Win MCI. 
  381.  
  382.      DATA RATE:
  383.  
  384.      The data rate required for playback is displayed for .FLC, .FLI. & .AVIs
  385.      when they are rendered by VFD.  The first frame of .FLCs & .FLIs is  
  386.      ommitted from the calculation because it is displayed only one time,
  387.      and then replaced by the ring frame.  The ring frame is a delta of the
  388.      last and first frames.  AVIs do not have a ring frame.
  389.  
  390.      The coMpress (-Mn) param may be used with a corresponding percentage 
  391.      reduction in playback speed to reduce the data rate (and file size) 
  392.      while maintaining the same apparent speed.  
  393.      
  394.      TOTAL FRAMES:
  395.  
  396.      If extracting from motion video when the start frame (-Tn1) is greater
  397.      than 1, the first extracted frame will be a delta.  To make the first
  398.      frame a keyframe, use VFD to create a video with a Keyframe interval 
  399.      (-Kn) syncronized with the start frame value (n1), and then the start 
  400.      frame will hit the keyframe.  Example: to extract a 100 frame FLC 
  401.      starting at frame 157, use 'VFD pretty.flc -k157 -otmpfle', then 'VFD 
  402.      tmpfle.flc -t157,100 -opretty2'.
  403.  
  404.      If the Total frames param is used with the Backwards param (-B1), the
  405.      start frame is the highest numbered frame defined by the Total frame
  406.      param.  Example: to skip the first file in a 100 frame series using the
  407.      -B1 param: -T1,99. (its backwards)
  408.  
  409.      KEYFRAME INTERVAL:
  410.  
  411.      Keyframes (-Kn where n=1 to 65535) and the KEYFRAME makefile keyword may 
  412.      be used when creating FLC, FLI, RLE compressed AVI, and for RLE delta 
  413.      extraction.  The default is no Keyframes.  Keyframes may be useful in 
  414.      video editing, but are not necessary for playback in VFD produced motion 
  415.      video, as the image quality is always 100%.
  416.  
  417.      Keyframes may also be useful in AVIs with a programmed or script-driven 
  418.      player that seeks to specific frames in response to user input.
  419.  
  420.      Extraction of all full frame RLE images may be accomplished by using the
  421.      -E2 -K1 params.
  422.      
  423.      PADDING:
  424.  
  425.      Padding will improve the data through-put of AVIs when played from 
  426.      CD-ROM.  To add padding, place the 'CD-ROM' keyword in the makefile 
  427.      prior to the image files.  The default is no padding.  The CD-ROM 
  428.      keyword is ignored for FLC and FLI output.
  429.  
  430.      CTRL-BRK:
  431.  
  432.      Use of CTRL-BRK will terminate VFD at any point in processing.
  433.  
  434.      AUDIO:
  435.  
  436.      VFD skips over audio tracks in input files.  VFW VidEdit and WavEdit or 
  437.      similar Windows programs may be used to add audio to VFD produced .AVIs.
  438.      See Converting AVIs for info on how to obtain a free copy of VFW.
  439.  
  440.      AVITXT:
  441.  
  442.      AVITXT.EXE adds plain text comments to AVI files. The comment text is
  443.      limited to 28,000 bytes, and is padded to a 2Kb boundary by default.
  444.      Existing comment text may be replaced with AVITXT. To remove comments, 
  445.      use AVITXT with a text file of zero length (as created with DOS EDIT).
  446.      The Shareware version is limited to DIB, RLE, and msvc AVIs. The AVITXT
  447.      included with the registered VFD will add comment text to all AVIs.
  448.  
  449.      MPEG:
  450.  
  451.      DMPEG v1.1, a Public Domain MPEG viewer and extractor by Stefan Eckart, 
  452.      is included with VFD.  DMPEG.EXE will extract a .RAW file from MPEG Type 
  453.      1 files (see the DMPEG.DOC file).  For best results, the .RAW file 
  454.      should be extracted in 24-bit format for VFD input (DMPEG -d4).  VFD 
  455.      Hilite value of 128 and dither value of 20 usually produce very good 
  456.      results from 24-bit RAW input.  Compress (-M1) and Speed (-S15) will 
  457.      convert the frame rate from 30 frm/sec to 15 frm/sec while retaining the 
  458.      apparent speed of the origional MPEG video.  Many .RAW files can be 
  459.      compressed even more by using '-M2 -S10' or -M3 -S8'.  The Luminance 
  460.      param '-L±n[,c]' will be useful with some MPEG conversions.
  461.  
  462.      JPEG:
  463.  
  464.      VFD does not accept .JPG input files.  JPG files are 24-bit color lossy
  465.      compression and must be converted to another file format for input to
  466.      VFD.  For best results, use Paint Shop Pro (Shareware by JASC, Inc.), to 
  467.      reduce the JPG file to 8-bit color and save as a 8-bit compressed TGA 
  468.      file.  Then use VFD with Highlite promotion to render the TGAs.
  469.  
  470.      PSP.ZIP is avaliable on CompuServe in the GRAPHSUP forum, Format 
  471.      Conversion library.
  472.  
  473.      MEMORY & SYSTEM REQUIREMENTS:
  474.  
  475.      VFD.EXE is a DOS real-mode application requiring 500Kb free conventional
  476.      memory and 96Kb XMS memory for processing 320x200 images.  Larger image 
  477.      sizes require additional XMS memory.
  478.      
  479.      DOS 3.1 or greater, 80286 or greater, 4Mb RAM required.  At least 2Mb
  480.      XMS memory should be configured using HIMEM.SYS or equivilent.  A SVGA 
  481.      video card is required to play 256 color .FLC and .AVI files.  FLI files
  482.      use only the standard VGA video modes.  The VFW runtime and 8Mb Ram is 
  483.      required to play AVIs with the Windows v3.1 MCI player.
  484.  
  485.      MOTION VIDEO SOURCES:
  486.  
  487.      The following CompuServe forums are sources for motion video: 
  488.      
  489.      ENERGY: AVI 
  490.      ARCFILM: AVI
  491.      ASOFT: FLC, FLI 
  492.      COMANIM: FLC, FLI, MPG, AVI    
  493.      SPACE: MPG, AVI (NASA uploads)  
  494.      WINMM: AVI (also VFW DK, incl full VFW)
  495.      WINAV: AVI 
  496.  
  497.      The latest VFW runtime for Windows may be found in the COMANIM forum. 
  498.  
  499.      TECHNICAL SOURCES:
  500.  
  501.      VFD is written in MASM 6.1 using file format specifications found in the 
  502.      Windows SDK and the following:
  503.  
  504.      CIS:ASOFT: FLCSPC.ZIP
  505.      CIS:WINMM: VFW SDK v1.1 
  506.      Zsoft Corporation Technical Reference Manual, 1991
  507.      Truevision Targa File Format Specification v2.0, 1991
  508.  
  509.      Much credit is due David Hoffmann, Michael Koch, and Vince Pilgrim for 
  510.      their patient counsel and beta test bug reports.
  511.  
  512.      SUPPORT:
  513.  
  514.      VFD continues to be upgraded with new features.  For the latest version,
  515.      GO GRAPHSUP on CompuServe and download VFD.ZIP from the Format Conversion
  516.      library section.
  517.  
  518.      VFD support is provided on CompuServe in the Graphics Support forum 
  519.      (GO GRAPHSUP).  Leave a message in the Format Conversion section for 
  520.      prompt response.  Direct support is also provided from Internet at: 
  521.      
  522.                          76570.2752@compuserve.com
  523.  
  524.      The author of VFD may be reached at the following address:
  525.      (For credit card registration orders, see below.)
  526.  
  527.                              Bob Williamson
  528.                              PO Box 172349
  529.                              Arlington, TX  
  530.                              76003-2349
  531.                              U.S.A.
  532.  
  533.      Developers wanting to add FLI, FLC, and/or AVI edit or playback, 
  534.      including codecs, to their applications are encouraged to contact the 
  535.      author for information on porting.
  536.  
  537.      SHAREWARE:
  538.  
  539.      VFD is copyrighted software that is marketed as Shareware.  The 
  540.      Shareware version of VFD may be used for a 30 day trial period, after 
  541.      which registration is required for continued use.  The registered 
  542.      version of VFD includes input/output file formats that are not included 
  543.      in the Shareware version.
  544.  
  545.      The Shareware version of VFD may be placed on computer bulletin boards 
  546.      and distributed on diskette by Shareware vendors, if priced less than 
  547.      $7.00.  VFD may not be distributed bundled with other software or 
  548.      hardware, on CD-ROM, or included on diskette with a book, magazine or 
  549.      other product without the written permission of the author.
  550.  
  551.      VFD(tm) is a trademark of Bob Williamson, CIS 76570,2752.
  552.  
  553.      REGISTRATION:
  554.  
  555.      The registered version of VFD includes the following features:
  556.  
  557.      * PCX and TIF input and output.
  558.      * 16 and 24-bit TGA extract from 16 and 24-bit DIB AVIs and MPEG .RAW.
  559.      * AVITXT.EXE for adding text comments to all AVIs (all codecs). 
  560.        The text comments are displayed with GeeWiz.
  561.  
  562.      Single-copy registration of VFD is $39.00.  The following discount
  563.      schedule applies to quantity and site licenses:
  564.  
  565.                      2 to 4 copies      $29.00 each
  566.                      5 to 9 copies      $24.00 each
  567.                      10 or more copies  $19.00 each
  568.  
  569.      One copy of the VFD software and documentation file is shipped with each 
  570.      quantity order.  The license provides for the stated number of copies 
  571.      to be in use at the site of the purchaser. 
  572.  
  573.      Registered users will be notified by mail of upgrade opprotunities and
  574.      new products as they become avaliable.  The next VFD upgrade following
  575.      registration is sent free to registered users.  Subsequent upgrades are
  576.      half-price to registered users if ordered directly from the author, with 
  577.      the following upgrade free.
  578.  
  579.      Corporate Purchase Orders and checks for VFD registration may be mailed
  580.      directly to the author at the PO Box address listed under Support.  
  581.      Checks should be payable to Bob Williamson in US dollars and drawn on a 
  582.      US bank.  International Postal money orders are also accepted.
  583.  
  584.      Please include $4.00 S&H ($6.00 overseas) with each order.
  585.  
  586.      CREDIT CARD ORDERS:
  587.  
  588.      You can order with M/C, VISA, AMEX, or DISCOVER from Public software
  589.      Library by calling 800-242-4775 or 713-524-6394 or by FAX to 
  590.      713-524-6398 or by CIS Email to 71355,470.  You can also mail credit
  591.      card orders to: 
  592.                                PsL 
  593.                                PO Box 35705
  594.                                Houston, TX 
  595.                                77235-5705 
  596.                                U. S. A.
  597.  
  598.      There is a $4.00 S&H charge ($6.00 overseas) on all orders.  The above 
  599.      numbers are for orders only.
  600.  
  601.      ORDERS FROM UK:
  602.  
  603.      Registration and/or orders can be sent by phone, fax, mail or email to:
  604.      
  605.                                Digital Workshop
  606.                                First Floor
  607.                                8 West Bar
  608.                                BANBURY
  609.                                Oxon
  610.                                OX16 9RR
  611.                                England
  612.  
  613.                                Tel: +44 (0)1295 258335
  614.                                Fax: +44 (0)1295 254590
  615.                                CIS: 74431,1160
  616.                           Internet: 74431.1160@compuserve.com
  617.  
  618.      Access, Mastercard, VISA, American Express, and Delta welcome.
  619.  
  620.      Cheques, money orders and postal orders payable to Digital Workshop.
  621.  
  622.      ORDERS FROM GERMANY, AUSTRIA, SWITZERLAND:
  623.  
  624.                                 Holin Datentechnik
  625.                                 Buchrainweg 61
  626.                                 63069 Offenbach Germany
  627.  
  628.                                 Tel: ++49 69 833587
  629.                                 Fax: ++49 69 845242
  630.                                 CIS: 100441,1366
  631.                            Internet: mholin@bla.robin.de
  632.  
  633.      MasterCard, Visa, American Express, Diners Club welcome.
  634.  
  635.      Checks, money orders and postal orders payable to Holin Datentechnik.
  636.  
  637.      NOTICE:
  638.  
  639.      You accept this program and files with the understanding that the
  640.      author makes no representations or warranties as to the suitability
  641.      of this program for your particular purpose, and that to the extent
  642.      you use or implement this program in your own setting, you do so at
  643.      your own risk.  In no event will the author be liable for any damages,
  644.      whether consequential, incidental, or special, arising out of the
  645.      use or inability to use the program.
  646.      
  647.      REVISION HISTORY:
  648.  
  649.      Version 1.0 05/16/94 (CD-ROM release Aug '94)
  650.      ______________________________________________________________________
  651.      Version 1.1 07/05/94
  652.      General revision too extensive to detail.
  653.      _______________________________________________________________________
  654.      Version 1.2 07/23/94
  655.      Maximum image size increased from 640x480 to 1024x768.
  656.      _______________________________________________________________________
  657.      Version 1.3 08/25/94
  658.      Verifies AVI infile index - if bad, walks RIFF chunks for processing.
  659.      Reduced XMS requirement.
  660.      Included GeeWiz, the Freeware AVI player for DOS.
  661.      _______________________________________________________________________
  662.      Version 1.4 10/10/94
  663.      Improved processing speed for Repeat frames & compress (skipped frames).
  664.      Improved processing speed for Luminance option.
  665.      Write Palette option is now independent from extract/create options.
  666.      Writes AVI index records for 64k frames maximum (was 4096).
  667.      Added FLIP_ON and FLIP_OFF makefile keywords.
  668.      Added doc reference on how to obtain free copy of Video for Windows.
  669.      -----------------------------------------------------------------------
  670.      Version 1.5 10/31/94
  671.      Added Flip command line param (-B4).
  672.      Numpic series are sorted on filename & extension (was filename only).
  673.      Added TRANSPARENCY_r,g,b makefile keyword.
  674.      Added 16 and 24-bit TGA extract (*registered* version).
  675.      _______________________________________________________________________
  676.      Version 1.6 12/01/94
  677.      Added default Hilite Promotion and Dither values.
  678.      Added text comment display and SVGA video mode to GeeWiz 1.3.
  679.      Included AVITXT 1.0, a utility to add text comments to AVIs.
  680.      _______________________________________________________________________
  681.      Version 1.6a 12/05/94
  682.      Bugfix for palette extraction (-Pn) when -Cn param is used.
  683.      GeeWiz v1.3a is compatible with more SVGA cards.
  684.      ________________________________________________________________________
  685.      Version 1.6b 12/20/94
  686.      Added read compatiblity for Corel RLE AVIs (VFD and Geewiz).
  687.      Increased GeeWiz v1.4 max frame size to 640x480, & added single-step.
  688.      Allowed VFD Hilite & Dither param value of '0', to override defaults.
  689.      Added msvc codec to the Shareware version of AVITXT v1.1.
  690.      ________________________________________________________________________
  691.      Version 1.6d 12/30/94
  692.      Added 8-bit msvc codec playback to GeeWiz 1.5.
  693.      Added developer porting information to VFD.DOC.
  694.      Removed GIF i/o due to license requirements.
  695.      ________________________________________________________________________
  696.      Version 1.6e 3/02/95
  697.      Adopted Intel's Indeo fixed palette for the 256 color fixed pal option.
  698.      Revised Chroma Key Overlay doc section.
  699.      CROP width & height values are adjusted if they exceed frame limits.
  700.      Added .RDI (RIFF DIB) input file format.
  701.      ________________________________________________________________________
  702.      Version 1.6f 3/15/95
  703.      VFD reads FLIs captured with ComputerEyes correctly now.
  704.      ID palettes are preserved from input->output and with the luminance param.
  705.      GeeWiz 1.6 has silver screen option (-i) and improved CD-ROM performace.
  706.      ________________________________________________________________________
  707.      Version 1.6g 4/13/95
  708.      VFD reads FLCs created with PhotoMorph correctly now.
  709.      Color reduction default values for Hilight Promotion & Dither improved.
  710.      Luminance control is improved.
  711.      Win identity palette is now the default. '-W0' will override (no id pal).
  712.  
  713.  
  714.      
  715.  
  716.