home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 16 / 16.iso / w / w023 / 3.ddi / FLI.001 / FP_SPEC8.DOC < prev    next >
Encoding:
Text File  |  1991-05-14  |  35.3 KB  |  1,219 lines

  1.  
  2.  
  3. FLIPAPER.EXE  Version 0.01  1/18/91
  4. ___________________________________
  5.  
  6.  
  7.  
  8. Specification Document for FLIPAPER.EXE a 'FLI' File Output Program
  9.  
  10.  
  11.  
  12.     USAGE:
  13.  
  14.  
  15.  
  16. usage: flipaper filename [options]
  17.        flipaper -s scriptfile [options]
  18.        flipaper -?[+] [options]
  19.  
  20. Options allowed:
  21.  
  22. -l logfile  - Create log logfile      │ -f[+]      - Fit shorter dimension
  23. -n frameset - Frames to be printed    │ -ro[+]     - Rotate output 90 degrees
  24. -i images   - Frames printed per page │ -r[+]      - Renderer(Screen) output
  25. -b r g b    - Border color            │ -c         - Configure output device
  26. -t r g b    - Transparent color       │ -o tgafile - Output Targa File
  27. -m margin   - Margin                  │ -d wid hgt - Targa file dimensions
  28. -k keycolor - Transparent color index │ -a aspect  - Targa file aspect ratio
  29.  
  30. NOTE: Put spaces between the switches and arguments.
  31.           For example:    -i 7 -m 0.1  not  -i7-m0.1
  32.       But do NOT put spaces inside an argument.
  33.           For example:    -n 1,2-5     not  -n 1, 2, -5
  34.  
  35.  
  36.  
  37.  
  38.     NOTE:  BNF-like notation used below is as follows:
  39.  
  40.  
  41.     [x] - 'x' is optional
  42.     {x}*    - 0 or more 'x's
  43.     {x}+    - 1 or more 'x's
  44.     {x | y} - either 'x' or 'y'
  45.     #   - '#' is a decimal digit character
  46.     'x'     - the character 'x'
  47.  
  48.  
  49.  
  50.        Example:
  51.  
  52.  
  53.     [ '+' | '-' ] {#}+ [ '.' {#}+ ]       -- real number
  54.  
  55.  
  56.  
  57.  
  58.     PURPOSE :
  59.  
  60.     FLIPAPER.EXE is a command line driven program designed to
  61.     read ".FLI" and ".FLC" files and 1) output then to a
  62.     hardcopy output device or 2) output them to the screen or
  63.     2) create a ".TGA" raster file for later output. Since .FLI
  64.     files are in fact animations composed of a series of
  65.     individual images, provisions are made to 1) selectively
  66.     output individual images ( frames ), or 2) output several
  67.     images on a single page of output.  This program will be
  68.     able to read both original Autodesk Animator files and the
  69.     new variable resolution "PJ" files.
  70.  
  71.  
  72.  
  73.     REQUIREMENTS :
  74.     This program will be implemented as a "protected mode" 80386 application
  75.     using ADI 4.1 or greater for its device interface.  The program will be
  76.     able to optionally use an 80x87 math coprocessor.
  77.  
  78.  
  79.  
  80.    USAGE MESSAGE:
  81.     If the program is invoked with no arguments, a "usage banner"
  82.     briefly describing the program's arguments will be printed on the
  83.     screen.
  84.  
  85.  
  86.  
  87.     ARGUMENT DESCRIPTIONS:
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.     filename
  95.     
  96.     File name of the input file, whose the file name extension
  97.     determines the type of input file. Mandatory unless, the -s
  98.     or -? option is used, in which case it is ignored. The
  99.     available input extensions are the following:
  100.  
  101.  
  102.         *.flc   Animator/3D Studio image file
  103.         *.fli   Animator/3D Studio image file
  104.  
  105.  
  106.  
  107.     Default:  The filename is mandatory, but if the
  108.           extension is missing, '.flc' or '.fli'
  109.           is the assumed extension. If filename.flc
  110.           exists and is a valid input file, it is used.
  111.           Otherwise the .fli extension is used.
  112.           To prevent FLIPAPER from using either
  113.           .flc or .fli, end the filename with a dot.
  114.  
  115.  
  116.  
  117.  
  118.     -?[+]
  119.     Prompt the user for the arguments to the command. The defaults last
  120.     used when the user was prompted are restored and then any other
  121.     command line arguments are set to form the new set of defaults. If
  122.     the '+' is present, the orginal program defaults are used, instead
  123.     of the defaults set the last time the -? option was used. See
  124.     PROMPTING FOR USER ARGUMENTS below for more details. When this
  125.     option is used, the filename, -s option and -o option are ignored.
  126.  
  127.  
  128.     Example:
  129.         -?
  130.  
  131.  
  132.     Default: The program is run with the command line arguments.
  133.  
  134.  
  135.  
  136.  
  137.     -n frameset
  138.     Optional 'fli' index which ranges from 1 to n.  This
  139.     also determines how many cells will be in the output
  140.     image.    There can be no more than 9 cells per page.
  141.     The 'flicnumbers' argument has the following form:
  142.  
  143.  
  144.  
  145.         # { {',' | {'-' | ':'} # }*
  146.  
  147.  
  148.     The ',' separator delimits individual frame numbers to be printed.
  149.     The '-' separator delimits the "start" and "stop" values of a range
  150.        of frame numbers to be prited.
  151.     The ':' separator appears only in conjunction with the '-'
  152.     separator.  This token can be thought of as a "by" modifier,
  153.     ( 'start'-'stop':'by' ) describing how to increment from "start" to
  154.     "stop".
  155.  
  156.  
  157.  
  158.     Example:
  159.  
  160.  
  161.         -n 3,9-12,1
  162.         frame sequence:  3, 9, 10, 11, 12, 1
  163.  
  164.  
  165.  
  166.         -n 20-52:5
  167.         frame sequence:  20, 25, 30, 35, 40, 45, 50
  168.  
  169.  
  170.  
  171.  
  172.  
  173.     Default:  The first picture in a 'fli' file.
  174.  
  175.  
  176.  
  177.  
  178.     -o outputfile
  179.     
  180.     Optional Targa file output specification. The name "none" is
  181.     used to indicate that no output file is desired.  If a full,
  182.     unambiguous file specification is not given, the output file
  183.     will be created in the current directory.  If no extension is
  184.     specified ".tga" will be assumed.  If a file exists with the
  185.     given file name, the existing file will be overwritten. The
  186.     number of frames put in a Targa file image is set by the -i
  187.     option. If more than a single Targa file image is required to
  188.     output all of the frames specified in the frame set, multiple
  189.     Targa files are output. The name of the first targafile is
  190.     exactly the name specified by the -o option.  Additional Targa
  191.     file names are generated by appending a 3 digit number to the
  192.     first five character of the file name specified by the -o
  193.     option. The 3 digit number starts at 1 if the specified file
  194.     name doesn't end in a number. If the file name does end in a
  195.     number, the next consecutive number is used.  If no suffix is
  196.     given, .tga is supplied. This option is ignored when the -?
  197.     option, -s option, or -r option is used.
  198.  
  199.  
  200.  
  201.     Example:
  202.         -o xxx    Would create xxx.tga, xxx001.tga, xxx002.tga,
  203.             etc.
  204.         -o abcdefg5    Would create abcdefg5.tga, abcde006.tga,
  205.             abcde007.tga, etc.
  206.  
  207.  
  208.  
  209.  
  210.     -d width height
  211.     Optional output pixel-dimensions of Targa output file. This option
  212.     is not used when output is directed to a device.
  213.  
  214.  
  215.  
  216.     Example:
  217.  
  218.  
  219.         -d 640 480
  220.  
  221.  
  222.     Default:  400 by 400 pixels.
  223.  
  224.  
  225.  
  226.  
  227.     -a aspect
  228.     Optional output pixel aspect ratio.  This option is used only if the
  229.     -o switch (above) is being used.  The "aspect" values is expressed as
  230.     a real number representing the ratio of pixel width:height.
  231.  
  232.  
  233.  
  234.  
  235.  
  236.    -i framesperpage
  237.     Optional number of images to be placed on a page.  The range for this
  238.     value is [1..9].  The default value is 1 image per page.
  239.  
  240.  
  241.  
  242.         case -i = 1:    +-------+       case -i = 2:    +-------+
  243.                         |       |                       |       |
  244.                         |       |                       +-------+
  245.                         |       |                       |       |
  246.                         +-------+                       +-------+
  247.  
  248.         case -i = 3:    +---+---+       case -i = 4:    +---+---+
  249.                         |   |   |                       |   |   |
  250.                         +---+---+                       +---+---+
  251.                         |   |                           |   |   |
  252.                         +---+                           +---+---+
  253.  
  254.         case -i = 5:    +---+---+       case -i = 6:    +---+---+
  255.                         |   |   |                       |   |   |
  256.                         +---+---+                       +---+---+
  257.                         |   |   |                       |   |   |
  258.                         +---+---+                       +---+---+
  259.                         |   |                           |   |   |
  260.                         +---+                           +---+---+
  261.  
  262.         case -i = 7:    +---+---+       case -i = 8:    +---+---+
  263.                         |   |   |                       |   |   |
  264.                         +---+---+                       +---+---+
  265.                         |   |   |                       |   |   |
  266.                         +---+---+                       +---+---+
  267.                         |   |   |                       |   |   |
  268.                         +---+---+                       +---+---+
  269.                         |   |                           |   |   |
  270.                         +---+                           +---+---+
  271.  
  272.         case -i = 9:    +---+---+---+
  273.                         |   |   |   |
  274.                         +---+---+---+
  275.                         |   |   |   |
  276.                         +---+---+---+
  277.                         |   |   |   |
  278.                         +---+---+---+
  279.  
  280.  
  281.     -ro[+]
  282.     Optional rotated output. This option control whether the image is
  283.     rotated 90 degrees when output. -ro will rotate the image 90
  284.     degrees clockwise, and -ro+ will prevent this rotation. This
  285.     rotation is in addition to any orientation set in the device
  286.     at configuration when it is configured.
  287.  
  288.  
  289.  
  290.     Default:  Unrotated output.
  291.  
  292.  
  293.  
  294.  
  295.  
  296.     -f[+]
  297.     Optional change of fit style.  Scale (and crop if necessary) the image
  298.     to make the SHORTER dimension completely fill the media.  The default
  299.     is to scale the image so that the LONGER dimension will fill the media
  300.     without cropping. If the '+' is present the default fit style is
  301.     used.
  302.  
  303.  
  304.  
  305.     Example :  If the output media is 8"x11", the "-ro" rotated
  306.            mode switch is being used, and the image to output
  307.            is 512x485 pixels in size :
  308.  
  309.  
  310.  
  311.     Default:   In the default case the image will fill the page left to
  312.            right, leaving blank space at the top and bottom.
  313.  
  314.  
  315.  
  316.            With the "-f" switch, the image will fill the entire page,
  317.            by scaling the vertical axis of the image to fill the page.
  318.            The sides of the image will be cropped.
  319.  
  320.  
  321.  
  322.  
  323.  
  324.     -t red green blue
  325.     Optional transparent color rgb levels which can range from 0 to 255.
  326.     This color is used in place of the key color for a fli. It should
  327.     be set to the color the output device doesn't output (e.g. white
  328.     usually does not deposit ink on paper for printers, so white
  329.     is usually the transparent color for a printer).
  330.  
  331.  
  332.  
  333.     Example:
  334.  
  335.  
  336.         -t 255 255 255 (white)
  337.  
  338.  
  339.  
  340.     Default:   It's default depends on the output format. It is black
  341.     when rendering to the screen, and white when rendering to hard copy
  342.     devices or to a Targa file.
  343.  
  344.  
  345.  
  346.     -k keycolor
  347.     Optional key color index. This option causes pixels whose color
  348.     index set in the option to be replaced by the transparent color
  349.     set with the -t option above. When the transparent color is
  350.     correctly set this will cause these pixels to become transparent,
  351.     and allow any image or color already on the page to show through.
  352.     If the transparent color set incorrectly, this will cause these
  353.     pixels to print in the transparent color. The word "none" can
  354.     be used to indicate that no key color is desired.
  355.  
  356.  
  357.     Example:
  358.  
  359.  
  360.         -k 130
  361.  
  362.     Default:   None. If the option is not specified, all pixels are
  363.     printed in their original colors.
  364.  
  365.  
  366.     -b red green blue
  367.     Optional background color rgb levels which can range from 0 to 255.
  368.     This color is used in the margins around images.
  369.  
  370.  
  371.  
  372.     Example:
  373.  
  374.  
  375.  
  376.         -b 255 128 0 (loud orange)
  377.  
  378.  
  379.  
  380.     Default:  The transparent color set by the -t option above.
  381.  
  382.  
  383.  
  384.  
  385.  
  386.     -m margin
  387.     Optionally apply an extra margin outside of the normal image.  Space for
  388.     the margin is accomplished by scaling the image down.
  389.  
  390.  
  391.  
  392.     The value "margin" specifies the amount of the image's space set aside
  393.     for a margin.  The margin is expressed as a number in the range
  394.     [0.0 .. 0.3], where 0.0 is no margin.
  395.  
  396.  
  397.  
  398.     Example :
  399.  
  400.  
  401.         -m 0.1
  402.  
  403.  
  404.         would yield a reduction of the image size, in both the X and Y
  405.         directions of 10%
  406.  
  407.  
  408.  
  409.     Default : no margin added, adjacent images will abut.
  410.  
  411.  
  412.  
  413.  
  414.     -s scriptfile
  415.     Optional script file name (indicate full path name if
  416.     necessary).  The scriptfile can set any command line argument,
  417.     except -?, -s, or -c. Options in the script line overrides any
  418.     options on the command line. FLIPAPER will scan the entire
  419.     script file looking for errors before beginning output. As the
  420.     script file is scanned, the script line numbers are displayed
  421.     on the screen.  When this scan is finished, FLIPAPER will
  422.     terminate if any errors were found in the script file. If a log
  423.     file is specified on the command line, the errors found are
  424.     also output to the log file.  When the -s switch appears on the
  425.     command line, the other arguments of the command line replace
  426.     the defaults while the script is running.  So putting -i 3 on
  427.     the command line with a -s argument will cause the default
  428.     images per page to become 3 while the script is running. This
  429.     option is ignored if the -?  option is used. When this option
  430.     is set the filename and the -o option are ignored.
  431.  
  432.  
  433.  
  434.     Example:
  435.  
  436.  
  437.         -s dorun5.scr
  438.  
  439.  
  440.         The example file, dorun5.scr, may contain the following lines:
  441.  
  442.  
  443.         d:\fli\eternal.fli -r -m 0.01 -b 64 0 128 -ro -i 4 -n 1-3
  444.         d:\fli\test.fli -i 9 -n 1-9
  445.         d:\fli\chrome.fli -o d:\fli\chrome.tga -d 8000 8000
  446.  
  447.  
  448.  
  449.  
  450.  
  451.     Default:  not activated
  452.  
  453.  
  454.         The format of the script file is identical to that for the command
  455.         line options with the follow exceptions:
  456.  
  457.  
  458.  
  459.          The program name, FLIPAPER, should not be included.
  460.          The '-s' switch should not be included.
  461.          The '-?' switch should not be included.
  462.  
  463.  
  464.  
  465.  
  466.  
  467.     -l [logfile]
  468.     Optional log file name (indicate full path name if necessary).
  469.     If no extension is given .log is assumed. If the logfile name
  470.     is "none", logging will be stopped. FLIPAPER output is logged
  471.     in the log file from the time the -l option is found until
  472.     another -l option is found, or FLIPAPER exits. So, a -l option
  473.     on the command line will log all of the commands in a script to
  474.     the log file. If you want errors detected in a script file to
  475.     appear in the log, the -l option must appear on the command
  476.     line. Any errors detected while scanning the script file will
  477.     be output to the log file specified on the FLIPAPER command
  478.     line. When using the -? option, the log file previously    used is
  479.     kept. This log file will only be used to log responses to the
  480.     prompts. In order to include the command line arguments in the
  481.     log file, the -l option must be specified on the command line.
  482.  
  483.  
  484.  
  485.     Example:
  486.         -l testflis.log        -l
  487.  
  488.  
  489.  
  490.     Default:  no log file is created
  491.  
  492.  
  493.     For the sake of defining the log file, we'll call each command line
  494.     parsed or each line of the script file to be a "job".
  495.  
  496.  
  497.  
  498.     The contents for the log file will be in the following format:
  499.  
  500.  
  501.         ----------------------------------------------------
  502.  
  503.  
  504.         FLIPAPER version x.xx.xx, Autodesk, Inc. (c) 1991
  505.  
  506.  
  507.  
  508.         filename:     'the FLI file name'     (omitted if script line)
  509.         arguments:     'the command line options'
  510.         start time:  'date and time of start of job'
  511.         Page xxxx:     'Frames output on page' ... Done at HH:MM:SS
  512.         stop time:     'date and time of the end of the job'
  513.  
  514.  
  515.  
  516.         duration:     'time in hours, minutes, and seconds'
  517.  
  518.  
  519.  
  520.  
  521.  
  522.         If the flipaper invokes a script file, then the log file will
  523.         insert the following lines between the above start and stop time
  524.         lines:
  525.             BEGIN SCRIPT
  526.  
  527.  
  528.  
  529.         (for every script line, these will be output)
  530.             filename:    ...
  531.             arguments:    ...
  532.             start time: ...
  533.             Page xxx:    ...
  534.             stop time:    ...
  535.  
  536.  
  537.  
  538.             duration:    ...
  539.  
  540.  
  541.  
  542.  
  543.             END SCRIPT
  544.  
  545.         In scripts, if log files are specified on the script lines
  546.         using the -l option, any log file given on the command line
  547.         is closed, when the new log file is opened. When the first
  548.         line of a script specifies a log file, the BEGIN SCRIPT and
  549.         END SCRIPT lines are not put in a log file given on the
  550.         command line since all of the logging for the script is placed
  551.         in a different log file.
  552.  
  553.     -r[+]
  554.     Optionally render the images to the screen. If the '+' is present
  555.     causes the images to be rendered to the default device which is
  556.     the hard copy device. When rendering images to the screen, FLIPAPER
  557.     will pause when each image is displayed and wait for a key to be
  558.     struck before continuing to the next images. The keys that will
  559.     continue are ESCPAPE, SPACE, or ENTER. This option is ignored
  560.     if the -o option is used.
  561.  
  562.  
  563.     Example:
  564.  
  565.  
  566.         -r
  567.     Default: The hard copy device is the default rendering device.
  568.  
  569.  
  570.     -c
  571.     Optionally configure ADI driver. This option can not be used
  572.     in script files, and is ignored is the -o option is used.
  573.  
  574.  
  575.  
  576.     Example:
  577.  
  578.  
  579.         -c        configure the ADI hard copy device
  580.  
  581.  
  582.         -c -r    configure the ADI rendering device
  583.  
  584.  
  585. MEMORY REQUIREMENTS:
  586.  
  587. FLIPAPER requires the follow amounts of memory. Small miscelaneous
  588. allocations are not included.
  589.  
  590. FLC/FLI input:
  591.     8K + flic width * (2 * flic height + 1)
  592.  
  593. User Prompt:
  594.     4K bytes are allocated if -? is used on the command line.
  595.  
  596. Color Conversion:
  597.     256K bytes are always allocated
  598.  
  599.     Varying amount is allocated if output is not TrueColor. The
  600.     largest amount is 768K, the smallest is 0. Realisticly probably
  601.     somewhere around 20K.
  602.  
  603. Targa output:
  604.     Image buffer = 3 * width of output * height of output
  605.  
  606.     Line buffer = 3 * width of output
  607.  
  608.     Scale buffer = 12 * width of output
  609.  
  610.  
  611. Driver output:
  612.     Size of driver = approximately the file size of driver
  613.  
  614.     Image buffer for driver = (driver dependent, 0 for rcpvga41.exp
  615.     and configured width * configured height for rdppj.exp)
  616.  
  617.     Image buffer for flipaper = 3 * configured width
  618.  
  619.     Scale buffer = 12 * width of output
  620.  
  621.     If the driver is not TrueColor, an additional
  622.     768 + flic width * flic height bytes are required.
  623.     
  624.  
  625.  
  626. DEFINITIONS:
  627.  
  628.  
  629. #define COPYRIGHT_DATES "1991"    /* copyright dates */
  630.  
  631. #define MIN_KEY_INDEX    0
  632. #define MAX_KEY_INDEX    255
  633. #define MIN_FRAME_NUM    0        /* minimum frame number */
  634. #define MAX_FRAME_NUM    1000000000    /* maximum frame number */
  635. #define MIN_PIX_LENGTH    1        /* minimum pixel width or height */
  636. #define MAX_PIX_LENGTH    16000        /* maximum pixel width or height */
  637. #define MIN_INTENSITY    0        /* minimum r, g, or b value */
  638. #define MAX_INTENSITY    255        /* maximum r, g, or b value */
  639. #define MIN_MARGIN    0.0        /* minimum margin */
  640. #define MAX_MARGIN    0.3        /* maximum margin */
  641. #define MIN_PAGE_IMAGES 1        /* minimum # of frames per page */
  642. #define MAX_PAGE_IMAGES 9        /* maximum # of frames per page */
  643. #define MAX_FN_SIZE    128        /* maximum file name size */
  644. #define MIN_ASPECT    0.1        /* minimum aspect ratio */
  645. #define MAX_ASPECT    10.0        /* maximum aspect ratio */
  646.  
  647. #define FIT_LONGER_DIM    0        /* fit to longer dimension */
  648. #define FIT_SHORTER_DIM 1        /* fit to shorter dimension */
  649.  
  650. #define DFLT_FRAME_SET    "1"             /* default frame set of 1 image */
  651. #define DFLT_PIXWID    400        /* default pixel width */
  652. #define DFLT_PIXHGT    400        /* default pixel height */
  653. #define DFLT_MARGIN    0.0        /* default margin */
  654. #define DFLT_ASPECT    1.0        /* default aspect */
  655. #define DFLT_FIT    FIT_LONGER_DIM    /* default fit */
  656.  
  657. #define DFLT_REND_BACKG_RED   MIN_INTENSITY    /* background for screen */
  658. #define DFLT_REND_BACKG_GREEN MIN_INTENSITY    /* background for screen */
  659. #define DFLT_REND_BACKG_BLUE  MIN_INTENSITY    /* background for screen */
  660.  
  661. #define DFLT_HARD_BACKG_RED   MAX_INTENSITY    /* background for hardcopy */
  662. #define DFLT_HARD_BACKG_GREEN MAX_INTENSITY    /* background for hardcopy */
  663. #define DFLT_HARD_BACKG_BLUE  MAX_INTENSITY    /* background for hardcopy */
  664.  
  665. #define DFLT_TGA_BACKG_RED    MAX_INTENSITY    /* background for targa file */
  666. #define DFLT_TGA_BACKG_GREEN  MAX_INTENSITY    /* background for targa file */
  667. #define DFLT_TGA_BACKG_BLUE   MAX_INTENSITY    /* background for targa file */
  668.  
  669.  
  670.  
  671.  
  672. ENVIRONMENT VARIABLES:
  673.  
  674.  
  675. Two environment variables are used to locate the rendering and hard copy
  676. ADI device drivers:
  677.  
  678. set RDPADI=driver-path
  679. set RHPADI=driver-path
  680.  
  681. RDPADI is the path name of the driver used when -r is specified on the
  682. command line, or Yes is answered to the Render to Screen question when
  683. -? is used.
  684.  
  685. RHPADI is the path name of the driver used when -r is missing from the
  686. command line, -r+ is specified on the command line, or No is answered
  687. to the Tender to Screen question when -? is used.
  688.  
  689. If no suffix is given for a path name, .EXP is assumed.
  690.  
  691.  
  692. CONFIGURATION FILE:
  693.  
  694.  
  695. A configuration file, FLIPAPER.CFG, is maintained by FLIPAPER in the
  696. directory containing the FLIPAPER program. I contains the following
  697. data:
  698.  
  699. 1)    The configuration of the hard copy ADI device driver.
  700.  
  701. 2)    The configuration of the rendering ADI device driver.
  702.  
  703. 3)    The defaults last set when -? was used on the FLIPAPER
  704.     command line.
  705.  
  706. 4)    The previous responses to questions when -? is used on
  707.     the FLIPAPER command line.
  708.  
  709.  
  710.  
  711.  
  712. PROMPTING FOR USER ARGUMENTS
  713. ____________________________
  714.  
  715.  
  716.  
  717. When the -? argument is put on the command line Flipaper enters a mode
  718. where the user is prompted for the arguments to be used. When replying
  719. the keypad keys are used as follows:
  720.  
  721.     UP ARROW     - Recall the previous response.
  722.     DOWN ARROW   - Recall next response.
  723.     LEFT ARROW   - Move cursor to the left.
  724.     RIGHT ARROW  - Move cursor to the right.
  725.     DELETE     - Delete character under cursor.
  726.     BACKSPACE     - Delete character to left of cursor.
  727.     HOME     - Move cursor to beginning of reply.
  728.     END         - Move cursor to end of reply.
  729.     ESCAPE     - Erase reply.
  730.     PAGE DOWN     - Stop asking for arguments. Will terminate program
  731.            if used when entering the FLI file name.
  732.     CTRL-C     - Abort the entry.
  733.  
  734.  
  735. Flipaper remembers the previous responses you made to the
  736. questions and allows you to recall these responses using UP
  737. ARROW. The response to images per page and yes/no questions
  738. cannot be recalled because they are only a single character.
  739. When a response is recalled, it is high lighted and if any
  740. character is typed, the entire response will be erased. You can
  741. modify the response by using the DELETE, BACKSPACE or cursor
  742. positioning keys. When one of these keys are used, the high
  743. light is removed, and characters are inserted at the cursor
  744. position. Responses to the transparent and background color are
  745. kept together.
  746.  
  747.  
  748. MEMORY LIMITS
  749.  
  750. The most significant use of memory in FLIPAPER is when the -o option
  751. is used. FLIPAPER requires 3 x pixel height x pixel width bytes of
  752. memory just to hold the image to be output. FLIPAPER uses a virtual
  753. memory manager and will allow images larger than the available physical
  754. memory to be output. The maximum size available is approximately
  755. equal to the amount of free space on the hard disk or logical drive
  756. containing the FLIPAPER program.
  757.  
  758.  
  759. FATAL ERROR MESSAGES
  760.  
  761. Fatal errors will cause FLIPAPER to immediately terminate. If a log file
  762. is opened, the error is printed to the log file. A line number may also be
  763. included for any of these error messages, if the error was caused by a
  764. script line.
  765.  
  766.  
  767. ERROR: '-?' -?: not allowed in script
  768.  
  769.     Printed when -? is found on a line in a script file.
  770.  
  771. ERROR: 'iii' -k: bad key index value
  772.  
  773.     Printed when the argument to the -k option is not a number.
  774.  
  775. ERROR: 'iii' -k: key index tanges from 0 to 255
  776.  
  777.     Printed when the argument to the -k option is out of range.
  778.  
  779. ERROR: 'nnnnn' -n: frame set already specified
  780.  
  781.     Printed for the second and subsequent -n options.
  782.  
  783. ERROR: 'no set' -n: missing frame set specification
  784.  
  785.     Printed when the argument to the -n option is missing.
  786.  
  787. ERROR: 'too long' -n:  frame set string exceeds 128 characters
  788.  
  789.     Printed when the argument to the -n option is longer than
  790.     128 characters.
  791.  
  792. ERROR: 'nnnnn' -n: start of malformed expression
  793.  
  794.     Printed when the argument to the -n option contains an invalid
  795.     character.
  796.  
  797. ERROR: 'nnnnn' -n: frame number must be in the range from 0 to 1000000
  798.  
  799.     Printed when the argument to the -n option contains an frame
  800.     number out of range.
  801.  
  802. ERROR: 'nnnnn' -n: fffff-fffff is invalid use of the dash
  803.  
  804.     Printed when the argument to the -n option contains two frame
  805.     numbers separated by a dash, and the first number is larger
  806.     than the second.
  807.  
  808. ERROR: 'ooooo' -o: multiple output file names
  809.  
  810.     Printed for second and subsequent -o options.
  811.  
  812. ERROR: 'no name' -o: missing output file name
  813.  
  814.     Printed when the argument to -o is missing.
  815.  
  816. ERROR: 'ooooo' -o: file names cannot start with '-'
  817.  
  818.     Printed when the argument following the -o option starts with '-'.
  819.  
  820. ERROR: 'oooooo' -o: Could not create TGA file
  821.  
  822.     Printed only when the close of the TGA file fails. Usually
  823.     indicates a disk error, or full disk.
  824.  
  825. FATAL ERROR: Could not create TGA file
  826.  
  827.     Printed if the TGA file could not be opened. Usually indicates
  828.     a full disk, or read only file.
  829.  
  830. FATAL ERROR: Could not write TGA file header
  831.  
  832.     Printed if the write of the TGA file header fails. Usually
  833.     indicates a full disk.
  834.  
  835. FATAL ERROR: Could not write compressed line to TGA file
  836.  
  837.     Printed if a write to the TGA file fails. Usually indicates
  838.     a full disk.
  839.  
  840. FATAL ERROR: Could not write uncompressed line to TGA file
  841.  
  842.     Printed if a write to the TGA file fails. Usually indicates
  843.     a full disk.
  844.  
  845. FATAL ERROR: Could not allocate TGA work area
  846.  
  847.     There was insufficient memory for a work area used for writing
  848.     TGA files. The memory required is 3 x pixel width.
  849.  
  850.  
  851.  
  852. ERROR: 'too long' -o: bad output file name
  853.  
  854.     Printed when the output file name exceeds 128 characters.
  855.  
  856. ERROR: 'iii' -i:  Number of images per page range from 1 to 9
  857.  
  858.     Printed when the argument to the -i option is out of range.
  859.  
  860. ERROR: 'iii' -i:  bad number of images per page
  861.  
  862.     Printed when the argument to the -i option is invalid.
  863.  
  864. ERROR: 'www' -d:  Pixel width must be in the range of 1 to 16000
  865.  
  866.     Printed when the first argument to the -d option is out of range.
  867.  
  868. ERROR: 'www' -d:  bad pixel width
  869.  
  870.     Printed when the first argument to the -d option is invalid.
  871.  
  872. ERROR: 'www' -d:  Pixel height must be in the range of 1 to 16000
  873.  
  874.     Printed when the second argument to the -d option is out of range.
  875.  
  876. ERROR: 'www' -d:  bad pixel height
  877.  
  878.     Printed when the second argument to the -d option is invalid.
  879.  
  880. ERROR: 'aaa' -a:  Apsect must be between .1 to 10.0
  881.  
  882.     Printed when the argument to the -a option is out of range.
  883.  
  884. ERROR: 'aaa' -a:  bad aspect ratio
  885.  
  886.     Printed when the argument to the -a option is invalid.
  887.  
  888. ERROR: 'rrr' -b:  bad red background value
  889.  
  890.     Printed when the red argument to the -b option is invalid.
  891.  
  892. ERROR: 'rrr' -b:  red background values range from 0 to 255
  893.  
  894.     Printed when the red argument to the -b option is out of range.
  895.  
  896. ERROR: 'ggg' -b:  bad green background value
  897.  
  898.     Printed when the green argument to the -b option is invalid.
  899.  
  900. ERROR: 'ggg' -b:  green background values range from 0 to 255
  901.  
  902.     Printed when the green argument to the -b option is out of range.
  903.  
  904. ERROR: 'bbb' -b:  bad blue background value
  905.  
  906.     Printed when the blue argument to the -b option is invalid.
  907.  
  908. ERROR: 'bbb' -b:  blue background values range from 0 to 255
  909.  
  910.     Printed when the blue argument to the -b option is out of range.
  911.  
  912. ERROR: 'rrr' -t:  bad red transparent value
  913.  
  914.     Printed when the red argument to the -t option is invalid.
  915.  
  916. ERROR: 'rrr' -t:  red transparent values range from 0 to 255
  917.  
  918.     Printed when the red argument to the -t option is out of range.
  919.  
  920. ERROR: 'ggg' -t:  bad green transparent value
  921.  
  922.     Printed when the green argument to the -t option is invalid.
  923.  
  924. ERROR: 'ggg' -t:  green transparent values range from 0 to 255
  925.  
  926.     Printed when the green argument to the -t option is out of range.
  927.  
  928. ERROR: 'bbb' -t:  bad blue transparent value
  929.  
  930.     Printed when the blue argument to the -t option is invalid.
  931.  
  932. ERROR: 'bbb' -t:  blue transparent values range from 0 to 255
  933.  
  934.     Printed when the blue argument to the -t option is out of range.
  935.  
  936. ERROR: 'mmm' -m:  margin values range from 0.0 to 0.3
  937.  
  938.     Printed when the argument to the -m option is out of range.
  939.  
  940. ERROR: 'mmm' -m:  bad margin value
  941.  
  942.     Printed when the argument to the -m option is invalid.
  943.  
  944. ERROR: 'ssssss' -s:  multiple script file names
  945.  
  946.     Printed for second and subsequent -s options.
  947.  
  948. ERROR: 'no name' -s:  missing script file name
  949.  
  950.     Printed if there is no argument for the -s option.
  951.  
  952. ERROR: 'ssssss' -s:  file names cannot start with '-'
  953.  
  954.     Printed the the argument to the -s option starts with a '-'
  955.  
  956. ERROR: 'too long' -s:  file names cannot exceed 128 chars
  957.  
  958.     Printed when the filename for the script file is longer than
  959.     128 characters.
  960.  
  961. FATAL ERROR: SCRIPT FILES CANNOT RUN SCRIPT FILES
  962.  
  963.     Printed if the -s option appears in a script file.
  964.  
  965. ERROR: 'ssssss' -s: Can not open script file
  966.  
  967.     Printed if the script file specified could not be opened.
  968.  
  969. ERROR: 'llllll' -l:  multiple log file names
  970.  
  971.     Printed for second and subsequent -l options.
  972.  
  973. ERROR: 'no name' -l:  missing log file name
  974.  
  975.     Printed if there is no argument for the -l option.
  976.  
  977. ERROR: 'llllll' -l:  file names cannot start with '-'
  978.  
  979.     Printed the the argument to the -l option starts with a '-'
  980.  
  981. ERROR: 'too long' -l:  file names cannot exceed 128 chars
  982.  
  983.     Printed when the filename for the log file is longer than
  984.     128 characters.
  985.  
  986. ERROR: 'llllll' -l: Could not open log file
  987.  
  988.     Printed if the file name given in the -l option could not
  989.     not be opened.
  990.  
  991. ERROR: 'llllll' -l: Log File flush failed
  992.  
  993.     An attempt to update the contents of the log file on disk failed.
  994.  
  995. ERROR: '-c' -c: Not allowed in scripts
  996.  
  997.     The -c option is not allowed in script files.
  998.  
  999. ERROR: '-rx' -r: Only + can be used with this option
  1000.  
  1001.     Printed when the character following -r is invalid.
  1002.  
  1003. ERROR: '-rox' -ro: Only + can be used with this option
  1004.  
  1005.     Printed when the character following -ro is invalid.
  1006.  
  1007. ERROR: '-fx' -f: Only + can be used with this option
  1008.  
  1009.     Printed when the character following -f is invalid.
  1010.  
  1011. ERROR: '-?x' -?: Only + can be used with this option
  1012.  
  1013.     Printed when the character following -? is invalid.
  1014.  
  1015. ERROR: 'xxxx' unknown command line switch
  1016.  
  1017.     An option beginning with '-' was not recognized.
  1018.  
  1019. ERROR: 'ffffff' extra FLC or FLI file name or missing switch
  1020.  
  1021.     Printed when the second and subsequent argument with no
  1022.     associated option is found.
  1023.  
  1024. ERROR: 'too long' file names cannot exceed 128 chars
  1025.  
  1026.     Printed when the FLC or FLI file name is longer than 128
  1027.     characters.
  1028.  
  1029. ERROR: 'no name' a FLC or FLI file name must be specified
  1030.  
  1031.     Printed when neither -?, -s, nor a FLC or FLI file name is given
  1032.     on the command line or a FLC or FLI file is missing from
  1033.     a script file.
  1034.  
  1035. FATAL ERROR: FLIPAPER TERMINATED DUE TO ERRORS
  1036.  
  1037.     Errors were detected while checking a script for errors.
  1038.  
  1039. FATAL ERROR: fffffff: Could not open FLC or FLI file
  1040.  
  1041.     Printed if the FLC or FLI file could not be opened.
  1042.  
  1043. Not enough memory to allocate FLC or FLI file control area
  1044. Not enough memory to allocate FLC or FLI image area
  1045. Not enough memory to allocate FLC or FLI palette area
  1046. FATAL ERROR: Cannot allocate xxxxxx bytes for FLI/FLC buffer
  1047. FATAL ERROR: no memory for linebuf
  1048.  
  1049.     Printed if there is not enough memory for FLC or FLI file.
  1050.     The file control area requires 256 bytes, the palette area
  1051.     768 bytes, the image area width x height bytes, and a work
  1052.     uses width x height + 7168 bytes. The size of the work buffer
  1053.     could exceed this maximum, if new versions of PJ produce
  1054.     additional CHUNK types in FRAMES.
  1055.  
  1056.  
  1057. Corrupted FLC or FLI file:  expected FCID_FRAME
  1058. FATAL ERROR: Corrupted FLC or FLI frame, expected FCID_FRAME
  1059. Corrupted FLC or FLI file:  expected FCID_FRAME
  1060. Not a FLC or FLI file
  1061.  
  1062.     Printed if the FLC or FLI file contains invalid data.
  1063.  
  1064. Cannot access FLC or FLI file
  1065.  
  1066.     Printed if the FLC or FLI file could not be opened.
  1067.  
  1068. FATAL ERROR: Insufficient Memory to print image
  1069.  
  1070.     Printed if the image scaling memory area could not be allocated.
  1071.     This area requires 12 x pixel width bytes.
  1072.  
  1073. FATAL ERROR: Couldn't configure ADI rendering device
  1074.  
  1075.     Printed if the -r option is given and the rendering device
  1076.     specified in the RCPADI environment variable can not be
  1077.     configured.
  1078.  
  1079. Abort configuration.  Exit.
  1080.  
  1081.     Printed when CTRL-C or CTRL-BREAK is pressed while configuring
  1082.     the ADI rendering driver or the ADI hard copy driver.
  1083.  
  1084. FATAL ERROR: Couldn't configure ADI hard copy device
  1085.  
  1086.     Printed if the rendering device    specified in the RHPADI
  1087.     environment variable can not be configured.
  1088.  
  1089. FATAL ERROR: Couldn't access ADI rendering screen
  1090.     
  1091.     Printed if the -r option is given and the rendering device
  1092.     specified in the RCPADI environment variable can not be
  1093.     initialized.
  1094.  
  1095. No ADI rendering driver loaded.
  1096.  
  1097.     Printed if the ADI driver given by the environment variable
  1098.     RCPADI was not loaded.
  1099.  
  1100. Couldn't initialize rendering driver
  1101.  
  1102.     Printed if the ADI driver initialization fails.
  1103.  
  1104. FATAL ERROR: Couldn't access ADI hard copy device
  1105.  
  1106.     Printed if the rendering device    specified in the RHPADI
  1107.     environment variable can not be initialized.
  1108.  
  1109. No ADI hard copy driver loaded.
  1110.  
  1111.     Printed if the ADI driver given by the environment variable
  1112.     RCPADI was not loaded.
  1113.  
  1114. Couldn't initialize hard copy driver
  1115.  
  1116.     Printed if the ADI driver initialization fails.
  1117.  
  1118. FATAL ERROR: Could not allocate work area memory
  1119.  
  1120.     Printed if there is insufficient memory for the image work
  1121.     area. The memory required for TARGA output files is
  1122.     3 x pixel width x pixel height. The memory required for ADI
  1123.     output is 3 x pixel width as configured in the device driver.
  1124.  
  1125. FATAL ERROR: FLIPAPER Terminated due to USER ABORT
  1126.  
  1127.     Printed if CTRL-C or CTRL-BREAK is pressed and the -? option
  1128.     was not given.
  1129.  
  1130. FATAL ERROR: Invalid number of frames per page
  1131.  
  1132.     An unexpected error printed if the program detects that the
  1133.     number of frames per page is invalid when arranging the frames
  1134.     on the page. This should not occur since it is detected earlier.
  1135.  
  1136.  
  1137.  
  1138. WARNING MESSAGES
  1139.  
  1140. A line number may also be included for any of these error messages, if the
  1141. error was caused by a script line.
  1142.  
  1143. WARNING: 'ssssss' -?:  Script file ignored because of -? option
  1144.  
  1145.     Printed when -? and -s are both given on the command line.
  1146.     The script file is ignored.
  1147.  
  1148. WARNING: 'iiiiii' -?:  File ignored because of -? option
  1149.  
  1150.     Printed when -? and a FLC or FLI file are both given on the
  1151.     command line. The FLC or FLI file is ignored.
  1152.  
  1153. WARNING: 'iiiiii' -s:  File ignored because of -s option
  1154.  
  1155.     Printed when -s and a FLC or FLI file are both given on the
  1156.     command line. The FLC or FLI file is ignored.
  1157.  
  1158. WARNING: 'oooooo' -s:  Output file ignored because of -s option
  1159.  
  1160.     Printed when -s and -o are both given on the command line.
  1161.     The output file is ignored.
  1162.  
  1163. WARNING: '-d' -d is only used with the -o option
  1164.  
  1165.     Printed when the -d option is given and the -o option is not.
  1166.     The -d option is ignored.
  1167.  
  1168. WARNING: '-a' -a is only used with the -o option
  1169.  
  1170.     Printed when the -a option is given and the -o option is not.
  1171.     The -a option is ignored.
  1172.  
  1173. WARNING: '-r' -o:  -r is ignored because of -o option
  1174.  
  1175.     Printed when both the -o and -r options are given. The -r
  1176.     option is ignored.
  1177.  
  1178. WARNING: '-c' -o:  -c is ignored because of -o option
  1179.  
  1180.     Printed when both the -o and -c options are given. The -c
  1181.     option is ignored.
  1182.  
  1183. D:\XXXX\XXXXX\FLIPAPER.CFG: Couldn't create.
  1184.  
  1185.     The configuration file FLIPAPER.CFG could not be updated.
  1186.  
  1187.  
  1188. DRIVER MESSAGES
  1189.  
  1190. CANNOT FIND THIS DRIVER:  Is the environment variable RDPADI set?
  1191.  
  1192. Cannot find ADI P386 rendering driver  XXXXXXXXXXXXX.
  1193. Enter ADI driver name: 
  1194.  
  1195.     Printed if the rendering driver could not be found.
  1196.  
  1197. CANNOT FIND THIS DRIVER:  Is the environment variable RHPADI set?
  1198.  
  1199. Cannot find ADI P386 hardcopy driver  XXXXXXXXXXXXX.
  1200. Enter ADI driver name: 
  1201.  
  1202.     Printed if the hard copy driver could not be found.
  1203.  
  1204. Cannot load ADI P386 display/rendering driver.
  1205.  
  1206.     Printed if the rendering driver load fails.
  1207.  
  1208. Cannot load ADI P386 hardcopy driver.
  1209.  
  1210.     Printed if the hard copy driver load fails.
  1211.  
  1212. Cannot init ADI P386 display/rendering driver.
  1213.  
  1214.     Printed if the rendering driver initialization fails.
  1215.  
  1216. Cannot init ADI P386 hardcopy driver.
  1217.  
  1218.     Printed if the hard copy driver initialization fails.
  1219.