home *** CD-ROM | disk | FTP | other *** search
Text File | 1991-05-14 | 35.3 KB | 1,219 lines |
-
-
- FLIPAPER.EXE Version 0.01 1/18/91
- ___________________________________
-
-
-
- Specification Document for FLIPAPER.EXE a 'FLI' File Output Program
-
-
-
- USAGE:
-
-
-
- usage: flipaper filename [options]
- flipaper -s scriptfile [options]
- flipaper -?[+] [options]
-
- Options allowed:
-
- -l logfile - Create log logfile │ -f[+] - Fit shorter dimension
- -n frameset - Frames to be printed │ -ro[+] - Rotate output 90 degrees
- -i images - Frames printed per page │ -r[+] - Renderer(Screen) output
- -b r g b - Border color │ -c - Configure output device
- -t r g b - Transparent color │ -o tgafile - Output Targa File
- -m margin - Margin │ -d wid hgt - Targa file dimensions
- -k keycolor - Transparent color index │ -a aspect - Targa file aspect ratio
-
- NOTE: Put spaces between the switches and arguments.
- For example: -i 7 -m 0.1 not -i7-m0.1
- But do NOT put spaces inside an argument.
- For example: -n 1,2-5 not -n 1, 2, -5
-
-
-
-
- NOTE: BNF-like notation used below is as follows:
-
-
- [x] - 'x' is optional
- {x}* - 0 or more 'x's
- {x}+ - 1 or more 'x's
- {x | y} - either 'x' or 'y'
- # - '#' is a decimal digit character
- 'x' - the character 'x'
-
-
-
- Example:
-
-
- [ '+' | '-' ] {#}+ [ '.' {#}+ ] -- real number
-
-
-
-
- PURPOSE :
-
- FLIPAPER.EXE is a command line driven program designed to
- read ".FLI" and ".FLC" files and 1) output then to a
- hardcopy output device or 2) output them to the screen or
- 2) create a ".TGA" raster file for later output. Since .FLI
- files are in fact animations composed of a series of
- individual images, provisions are made to 1) selectively
- output individual images ( frames ), or 2) output several
- images on a single page of output. This program will be
- able to read both original Autodesk Animator files and the
- new variable resolution "PJ" files.
-
-
-
- REQUIREMENTS :
- This program will be implemented as a "protected mode" 80386 application
- using ADI 4.1 or greater for its device interface. The program will be
- able to optionally use an 80x87 math coprocessor.
-
-
-
- USAGE MESSAGE:
- If the program is invoked with no arguments, a "usage banner"
- briefly describing the program's arguments will be printed on the
- screen.
-
-
-
- ARGUMENT DESCRIPTIONS:
-
-
-
-
-
-
- filename
-
- File name of the input file, whose the file name extension
- determines the type of input file. Mandatory unless, the -s
- or -? option is used, in which case it is ignored. The
- available input extensions are the following:
-
-
- *.flc Animator/3D Studio image file
- *.fli Animator/3D Studio image file
-
-
-
- Default: The filename is mandatory, but if the
- extension is missing, '.flc' or '.fli'
- is the assumed extension. If filename.flc
- exists and is a valid input file, it is used.
- Otherwise the .fli extension is used.
- To prevent FLIPAPER from using either
- .flc or .fli, end the filename with a dot.
-
-
-
-
- -?[+]
- Prompt the user for the arguments to the command. The defaults last
- used when the user was prompted are restored and then any other
- command line arguments are set to form the new set of defaults. If
- the '+' is present, the orginal program defaults are used, instead
- of the defaults set the last time the -? option was used. See
- PROMPTING FOR USER ARGUMENTS below for more details. When this
- option is used, the filename, -s option and -o option are ignored.
-
-
- Example:
- -?
-
-
- Default: The program is run with the command line arguments.
-
-
-
-
- -n frameset
- Optional 'fli' index which ranges from 1 to n. This
- also determines how many cells will be in the output
- image. There can be no more than 9 cells per page.
- The 'flicnumbers' argument has the following form:
-
-
-
- # { {',' | {'-' | ':'} # }*
-
-
- The ',' separator delimits individual frame numbers to be printed.
- The '-' separator delimits the "start" and "stop" values of a range
- of frame numbers to be prited.
- The ':' separator appears only in conjunction with the '-'
- separator. This token can be thought of as a "by" modifier,
- ( 'start'-'stop':'by' ) describing how to increment from "start" to
- "stop".
-
-
-
- Example:
-
-
- -n 3,9-12,1
- frame sequence: 3, 9, 10, 11, 12, 1
-
-
-
- -n 20-52:5
- frame sequence: 20, 25, 30, 35, 40, 45, 50
-
-
-
-
-
- Default: The first picture in a 'fli' file.
-
-
-
-
- -o outputfile
-
- Optional Targa file output specification. The name "none" is
- used to indicate that no output file is desired. If a full,
- unambiguous file specification is not given, the output file
- will be created in the current directory. If no extension is
- specified ".tga" will be assumed. If a file exists with the
- given file name, the existing file will be overwritten. The
- number of frames put in a Targa file image is set by the -i
- option. If more than a single Targa file image is required to
- output all of the frames specified in the frame set, multiple
- Targa files are output. The name of the first targafile is
- exactly the name specified by the -o option. Additional Targa
- file names are generated by appending a 3 digit number to the
- first five character of the file name specified by the -o
- option. The 3 digit number starts at 1 if the specified file
- name doesn't end in a number. If the file name does end in a
- number, the next consecutive number is used. If no suffix is
- given, .tga is supplied. This option is ignored when the -?
- option, -s option, or -r option is used.
-
-
-
- Example:
- -o xxx Would create xxx.tga, xxx001.tga, xxx002.tga,
- etc.
- -o abcdefg5 Would create abcdefg5.tga, abcde006.tga,
- abcde007.tga, etc.
-
-
-
-
- -d width height
- Optional output pixel-dimensions of Targa output file. This option
- is not used when output is directed to a device.
-
-
-
- Example:
-
-
- -d 640 480
-
-
- Default: 400 by 400 pixels.
-
-
-
-
- -a aspect
- Optional output pixel aspect ratio. This option is used only if the
- -o switch (above) is being used. The "aspect" values is expressed as
- a real number representing the ratio of pixel width:height.
-
-
-
-
-
- -i framesperpage
- Optional number of images to be placed on a page. The range for this
- value is [1..9]. The default value is 1 image per page.
-
-
-
- case -i = 1: +-------+ case -i = 2: +-------+
- | | | |
- | | +-------+
- | | | |
- +-------+ +-------+
-
- case -i = 3: +---+---+ case -i = 4: +---+---+
- | | | | | |
- +---+---+ +---+---+
- | | | | |
- +---+ +---+---+
-
- case -i = 5: +---+---+ case -i = 6: +---+---+
- | | | | | |
- +---+---+ +---+---+
- | | | | | |
- +---+---+ +---+---+
- | | | | |
- +---+ +---+---+
-
- case -i = 7: +---+---+ case -i = 8: +---+---+
- | | | | | |
- +---+---+ +---+---+
- | | | | | |
- +---+---+ +---+---+
- | | | | | |
- +---+---+ +---+---+
- | | | | |
- +---+ +---+---+
-
- case -i = 9: +---+---+---+
- | | | |
- +---+---+---+
- | | | |
- +---+---+---+
- | | | |
- +---+---+---+
-
-
- -ro[+]
- Optional rotated output. This option control whether the image is
- rotated 90 degrees when output. -ro will rotate the image 90
- degrees clockwise, and -ro+ will prevent this rotation. This
- rotation is in addition to any orientation set in the device
- at configuration when it is configured.
-
-
-
- Default: Unrotated output.
-
-
-
-
-
- -f[+]
- Optional change of fit style. Scale (and crop if necessary) the image
- to make the SHORTER dimension completely fill the media. The default
- is to scale the image so that the LONGER dimension will fill the media
- without cropping. If the '+' is present the default fit style is
- used.
-
-
-
- Example : If the output media is 8"x11", the "-ro" rotated
- mode switch is being used, and the image to output
- is 512x485 pixels in size :
-
-
-
- Default: In the default case the image will fill the page left to
- right, leaving blank space at the top and bottom.
-
-
-
- With the "-f" switch, the image will fill the entire page,
- by scaling the vertical axis of the image to fill the page.
- The sides of the image will be cropped.
-
-
-
-
-
- -t red green blue
- Optional transparent color rgb levels which can range from 0 to 255.
- This color is used in place of the key color for a fli. It should
- be set to the color the output device doesn't output (e.g. white
- usually does not deposit ink on paper for printers, so white
- is usually the transparent color for a printer).
-
-
-
- Example:
-
-
- -t 255 255 255 (white)
-
-
-
- Default: It's default depends on the output format. It is black
- when rendering to the screen, and white when rendering to hard copy
- devices or to a Targa file.
-
-
-
- -k keycolor
- Optional key color index. This option causes pixels whose color
- index set in the option to be replaced by the transparent color
- set with the -t option above. When the transparent color is
- correctly set this will cause these pixels to become transparent,
- and allow any image or color already on the page to show through.
- If the transparent color set incorrectly, this will cause these
- pixels to print in the transparent color. The word "none" can
- be used to indicate that no key color is desired.
-
-
- Example:
-
-
- -k 130
-
- Default: None. If the option is not specified, all pixels are
- printed in their original colors.
-
-
- -b red green blue
- Optional background color rgb levels which can range from 0 to 255.
- This color is used in the margins around images.
-
-
-
- Example:
-
-
-
- -b 255 128 0 (loud orange)
-
-
-
- Default: The transparent color set by the -t option above.
-
-
-
-
-
- -m margin
- Optionally apply an extra margin outside of the normal image. Space for
- the margin is accomplished by scaling the image down.
-
-
-
- The value "margin" specifies the amount of the image's space set aside
- for a margin. The margin is expressed as a number in the range
- [0.0 .. 0.3], where 0.0 is no margin.
-
-
-
- Example :
-
-
- -m 0.1
-
-
- would yield a reduction of the image size, in both the X and Y
- directions of 10%
-
-
-
- Default : no margin added, adjacent images will abut.
-
-
-
-
- -s scriptfile
- Optional script file name (indicate full path name if
- necessary). The scriptfile can set any command line argument,
- except -?, -s, or -c. Options in the script line overrides any
- options on the command line. FLIPAPER will scan the entire
- script file looking for errors before beginning output. As the
- script file is scanned, the script line numbers are displayed
- on the screen. When this scan is finished, FLIPAPER will
- terminate if any errors were found in the script file. If a log
- file is specified on the command line, the errors found are
- also output to the log file. When the -s switch appears on the
- command line, the other arguments of the command line replace
- the defaults while the script is running. So putting -i 3 on
- the command line with a -s argument will cause the default
- images per page to become 3 while the script is running. This
- option is ignored if the -? option is used. When this option
- is set the filename and the -o option are ignored.
-
-
-
- Example:
-
-
- -s dorun5.scr
-
-
- The example file, dorun5.scr, may contain the following lines:
-
-
- d:\fli\eternal.fli -r -m 0.01 -b 64 0 128 -ro -i 4 -n 1-3
- d:\fli\test.fli -i 9 -n 1-9
- d:\fli\chrome.fli -o d:\fli\chrome.tga -d 8000 8000
-
-
-
-
-
- Default: not activated
-
-
- The format of the script file is identical to that for the command
- line options with the follow exceptions:
-
-
-
- The program name, FLIPAPER, should not be included.
- The '-s' switch should not be included.
- The '-?' switch should not be included.
-
-
-
-
-
- -l [logfile]
- Optional log file name (indicate full path name if necessary).
- If no extension is given .log is assumed. If the logfile name
- is "none", logging will be stopped. FLIPAPER output is logged
- in the log file from the time the -l option is found until
- another -l option is found, or FLIPAPER exits. So, a -l option
- on the command line will log all of the commands in a script to
- the log file. If you want errors detected in a script file to
- appear in the log, the -l option must appear on the command
- line. Any errors detected while scanning the script file will
- be output to the log file specified on the FLIPAPER command
- line. When using the -? option, the log file previously used is
- kept. This log file will only be used to log responses to the
- prompts. In order to include the command line arguments in the
- log file, the -l option must be specified on the command line.
-
-
-
- Example:
- -l testflis.log -l
-
-
-
- Default: no log file is created
-
-
- For the sake of defining the log file, we'll call each command line
- parsed or each line of the script file to be a "job".
-
-
-
- The contents for the log file will be in the following format:
-
-
- ----------------------------------------------------
-
-
- FLIPAPER version x.xx.xx, Autodesk, Inc. (c) 1991
-
-
-
- filename: 'the FLI file name' (omitted if script line)
- arguments: 'the command line options'
- start time: 'date and time of start of job'
- Page xxxx: 'Frames output on page' ... Done at HH:MM:SS
- stop time: 'date and time of the end of the job'
-
-
-
- duration: 'time in hours, minutes, and seconds'
-
-
-
-
-
- If the flipaper invokes a script file, then the log file will
- insert the following lines between the above start and stop time
- lines:
- BEGIN SCRIPT
-
-
-
- (for every script line, these will be output)
- filename: ...
- arguments: ...
- start time: ...
- Page xxx: ...
- stop time: ...
-
-
-
- duration: ...
-
-
-
-
- END SCRIPT
-
- In scripts, if log files are specified on the script lines
- using the -l option, any log file given on the command line
- is closed, when the new log file is opened. When the first
- line of a script specifies a log file, the BEGIN SCRIPT and
- END SCRIPT lines are not put in a log file given on the
- command line since all of the logging for the script is placed
- in a different log file.
-
- -r[+]
- Optionally render the images to the screen. If the '+' is present
- causes the images to be rendered to the default device which is
- the hard copy device. When rendering images to the screen, FLIPAPER
- will pause when each image is displayed and wait for a key to be
- struck before continuing to the next images. The keys that will
- continue are ESCPAPE, SPACE, or ENTER. This option is ignored
- if the -o option is used.
-
-
- Example:
-
-
- -r
- Default: The hard copy device is the default rendering device.
-
-
- -c
- Optionally configure ADI driver. This option can not be used
- in script files, and is ignored is the -o option is used.
-
-
-
- Example:
-
-
- -c configure the ADI hard copy device
-
-
- -c -r configure the ADI rendering device
-
-
- MEMORY REQUIREMENTS:
-
- FLIPAPER requires the follow amounts of memory. Small miscelaneous
- allocations are not included.
-
- FLC/FLI input:
- 8K + flic width * (2 * flic height + 1)
-
- User Prompt:
- 4K bytes are allocated if -? is used on the command line.
-
- Color Conversion:
- 256K bytes are always allocated
-
- Varying amount is allocated if output is not TrueColor. The
- largest amount is 768K, the smallest is 0. Realisticly probably
- somewhere around 20K.
-
- Targa output:
- Image buffer = 3 * width of output * height of output
-
- Line buffer = 3 * width of output
-
- Scale buffer = 12 * width of output
-
-
- Driver output:
- Size of driver = approximately the file size of driver
-
- Image buffer for driver = (driver dependent, 0 for rcpvga41.exp
- and configured width * configured height for rdppj.exp)
-
- Image buffer for flipaper = 3 * configured width
-
- Scale buffer = 12 * width of output
-
- If the driver is not TrueColor, an additional
- 768 + flic width * flic height bytes are required.
-
-
-
- DEFINITIONS:
-
-
- #define COPYRIGHT_DATES "1991" /* copyright dates */
-
- #define MIN_KEY_INDEX 0
- #define MAX_KEY_INDEX 255
- #define MIN_FRAME_NUM 0 /* minimum frame number */
- #define MAX_FRAME_NUM 1000000000 /* maximum frame number */
- #define MIN_PIX_LENGTH 1 /* minimum pixel width or height */
- #define MAX_PIX_LENGTH 16000 /* maximum pixel width or height */
- #define MIN_INTENSITY 0 /* minimum r, g, or b value */
- #define MAX_INTENSITY 255 /* maximum r, g, or b value */
- #define MIN_MARGIN 0.0 /* minimum margin */
- #define MAX_MARGIN 0.3 /* maximum margin */
- #define MIN_PAGE_IMAGES 1 /* minimum # of frames per page */
- #define MAX_PAGE_IMAGES 9 /* maximum # of frames per page */
- #define MAX_FN_SIZE 128 /* maximum file name size */
- #define MIN_ASPECT 0.1 /* minimum aspect ratio */
- #define MAX_ASPECT 10.0 /* maximum aspect ratio */
-
- #define FIT_LONGER_DIM 0 /* fit to longer dimension */
- #define FIT_SHORTER_DIM 1 /* fit to shorter dimension */
-
- #define DFLT_FRAME_SET "1" /* default frame set of 1 image */
- #define DFLT_PIXWID 400 /* default pixel width */
- #define DFLT_PIXHGT 400 /* default pixel height */
- #define DFLT_MARGIN 0.0 /* default margin */
- #define DFLT_ASPECT 1.0 /* default aspect */
- #define DFLT_FIT FIT_LONGER_DIM /* default fit */
-
- #define DFLT_REND_BACKG_RED MIN_INTENSITY /* background for screen */
- #define DFLT_REND_BACKG_GREEN MIN_INTENSITY /* background for screen */
- #define DFLT_REND_BACKG_BLUE MIN_INTENSITY /* background for screen */
-
- #define DFLT_HARD_BACKG_RED MAX_INTENSITY /* background for hardcopy */
- #define DFLT_HARD_BACKG_GREEN MAX_INTENSITY /* background for hardcopy */
- #define DFLT_HARD_BACKG_BLUE MAX_INTENSITY /* background for hardcopy */
-
- #define DFLT_TGA_BACKG_RED MAX_INTENSITY /* background for targa file */
- #define DFLT_TGA_BACKG_GREEN MAX_INTENSITY /* background for targa file */
- #define DFLT_TGA_BACKG_BLUE MAX_INTENSITY /* background for targa file */
-
-
-
-
- ENVIRONMENT VARIABLES:
-
-
- Two environment variables are used to locate the rendering and hard copy
- ADI device drivers:
-
- set RDPADI=driver-path
- set RHPADI=driver-path
-
- RDPADI is the path name of the driver used when -r is specified on the
- command line, or Yes is answered to the Render to Screen question when
- -? is used.
-
- RHPADI is the path name of the driver used when -r is missing from the
- command line, -r+ is specified on the command line, or No is answered
- to the Tender to Screen question when -? is used.
-
- If no suffix is given for a path name, .EXP is assumed.
-
-
- CONFIGURATION FILE:
-
-
- A configuration file, FLIPAPER.CFG, is maintained by FLIPAPER in the
- directory containing the FLIPAPER program. I contains the following
- data:
-
- 1) The configuration of the hard copy ADI device driver.
-
- 2) The configuration of the rendering ADI device driver.
-
- 3) The defaults last set when -? was used on the FLIPAPER
- command line.
-
- 4) The previous responses to questions when -? is used on
- the FLIPAPER command line.
-
-
-
-
- PROMPTING FOR USER ARGUMENTS
- ____________________________
-
-
-
- When the -? argument is put on the command line Flipaper enters a mode
- where the user is prompted for the arguments to be used. When replying
- the keypad keys are used as follows:
-
- UP ARROW - Recall the previous response.
- DOWN ARROW - Recall next response.
- LEFT ARROW - Move cursor to the left.
- RIGHT ARROW - Move cursor to the right.
- DELETE - Delete character under cursor.
- BACKSPACE - Delete character to left of cursor.
- HOME - Move cursor to beginning of reply.
- END - Move cursor to end of reply.
- ESCAPE - Erase reply.
- PAGE DOWN - Stop asking for arguments. Will terminate program
- if used when entering the FLI file name.
- CTRL-C - Abort the entry.
-
-
- Flipaper remembers the previous responses you made to the
- questions and allows you to recall these responses using UP
- ARROW. The response to images per page and yes/no questions
- cannot be recalled because they are only a single character.
- When a response is recalled, it is high lighted and if any
- character is typed, the entire response will be erased. You can
- modify the response by using the DELETE, BACKSPACE or cursor
- positioning keys. When one of these keys are used, the high
- light is removed, and characters are inserted at the cursor
- position. Responses to the transparent and background color are
- kept together.
-
-
- MEMORY LIMITS
-
- The most significant use of memory in FLIPAPER is when the -o option
- is used. FLIPAPER requires 3 x pixel height x pixel width bytes of
- memory just to hold the image to be output. FLIPAPER uses a virtual
- memory manager and will allow images larger than the available physical
- memory to be output. The maximum size available is approximately
- equal to the amount of free space on the hard disk or logical drive
- containing the FLIPAPER program.
-
-
- FATAL ERROR MESSAGES
-
- Fatal errors will cause FLIPAPER to immediately terminate. If a log file
- is opened, the error is printed to the log file. A line number may also be
- included for any of these error messages, if the error was caused by a
- script line.
-
-
- ERROR: '-?' -?: not allowed in script
-
- Printed when -? is found on a line in a script file.
-
- ERROR: 'iii' -k: bad key index value
-
- Printed when the argument to the -k option is not a number.
-
- ERROR: 'iii' -k: key index tanges from 0 to 255
-
- Printed when the argument to the -k option is out of range.
-
- ERROR: 'nnnnn' -n: frame set already specified
-
- Printed for the second and subsequent -n options.
-
- ERROR: 'no set' -n: missing frame set specification
-
- Printed when the argument to the -n option is missing.
-
- ERROR: 'too long' -n: frame set string exceeds 128 characters
-
- Printed when the argument to the -n option is longer than
- 128 characters.
-
- ERROR: 'nnnnn' -n: start of malformed expression
-
- Printed when the argument to the -n option contains an invalid
- character.
-
- ERROR: 'nnnnn' -n: frame number must be in the range from 0 to 1000000
-
- Printed when the argument to the -n option contains an frame
- number out of range.
-
- ERROR: 'nnnnn' -n: fffff-fffff is invalid use of the dash
-
- Printed when the argument to the -n option contains two frame
- numbers separated by a dash, and the first number is larger
- than the second.
-
- ERROR: 'ooooo' -o: multiple output file names
-
- Printed for second and subsequent -o options.
-
- ERROR: 'no name' -o: missing output file name
-
- Printed when the argument to -o is missing.
-
- ERROR: 'ooooo' -o: file names cannot start with '-'
-
- Printed when the argument following the -o option starts with '-'.
-
- ERROR: 'oooooo' -o: Could not create TGA file
-
- Printed only when the close of the TGA file fails. Usually
- indicates a disk error, or full disk.
-
- FATAL ERROR: Could not create TGA file
-
- Printed if the TGA file could not be opened. Usually indicates
- a full disk, or read only file.
-
- FATAL ERROR: Could not write TGA file header
-
- Printed if the write of the TGA file header fails. Usually
- indicates a full disk.
-
- FATAL ERROR: Could not write compressed line to TGA file
-
- Printed if a write to the TGA file fails. Usually indicates
- a full disk.
-
- FATAL ERROR: Could not write uncompressed line to TGA file
-
- Printed if a write to the TGA file fails. Usually indicates
- a full disk.
-
- FATAL ERROR: Could not allocate TGA work area
-
- There was insufficient memory for a work area used for writing
- TGA files. The memory required is 3 x pixel width.
-
-
-
- ERROR: 'too long' -o: bad output file name
-
- Printed when the output file name exceeds 128 characters.
-
- ERROR: 'iii' -i: Number of images per page range from 1 to 9
-
- Printed when the argument to the -i option is out of range.
-
- ERROR: 'iii' -i: bad number of images per page
-
- Printed when the argument to the -i option is invalid.
-
- ERROR: 'www' -d: Pixel width must be in the range of 1 to 16000
-
- Printed when the first argument to the -d option is out of range.
-
- ERROR: 'www' -d: bad pixel width
-
- Printed when the first argument to the -d option is invalid.
-
- ERROR: 'www' -d: Pixel height must be in the range of 1 to 16000
-
- Printed when the second argument to the -d option is out of range.
-
- ERROR: 'www' -d: bad pixel height
-
- Printed when the second argument to the -d option is invalid.
-
- ERROR: 'aaa' -a: Apsect must be between .1 to 10.0
-
- Printed when the argument to the -a option is out of range.
-
- ERROR: 'aaa' -a: bad aspect ratio
-
- Printed when the argument to the -a option is invalid.
-
- ERROR: 'rrr' -b: bad red background value
-
- Printed when the red argument to the -b option is invalid.
-
- ERROR: 'rrr' -b: red background values range from 0 to 255
-
- Printed when the red argument to the -b option is out of range.
-
- ERROR: 'ggg' -b: bad green background value
-
- Printed when the green argument to the -b option is invalid.
-
- ERROR: 'ggg' -b: green background values range from 0 to 255
-
- Printed when the green argument to the -b option is out of range.
-
- ERROR: 'bbb' -b: bad blue background value
-
- Printed when the blue argument to the -b option is invalid.
-
- ERROR: 'bbb' -b: blue background values range from 0 to 255
-
- Printed when the blue argument to the -b option is out of range.
-
- ERROR: 'rrr' -t: bad red transparent value
-
- Printed when the red argument to the -t option is invalid.
-
- ERROR: 'rrr' -t: red transparent values range from 0 to 255
-
- Printed when the red argument to the -t option is out of range.
-
- ERROR: 'ggg' -t: bad green transparent value
-
- Printed when the green argument to the -t option is invalid.
-
- ERROR: 'ggg' -t: green transparent values range from 0 to 255
-
- Printed when the green argument to the -t option is out of range.
-
- ERROR: 'bbb' -t: bad blue transparent value
-
- Printed when the blue argument to the -t option is invalid.
-
- ERROR: 'bbb' -t: blue transparent values range from 0 to 255
-
- Printed when the blue argument to the -t option is out of range.
-
- ERROR: 'mmm' -m: margin values range from 0.0 to 0.3
-
- Printed when the argument to the -m option is out of range.
-
- ERROR: 'mmm' -m: bad margin value
-
- Printed when the argument to the -m option is invalid.
-
- ERROR: 'ssssss' -s: multiple script file names
-
- Printed for second and subsequent -s options.
-
- ERROR: 'no name' -s: missing script file name
-
- Printed if there is no argument for the -s option.
-
- ERROR: 'ssssss' -s: file names cannot start with '-'
-
- Printed the the argument to the -s option starts with a '-'
-
- ERROR: 'too long' -s: file names cannot exceed 128 chars
-
- Printed when the filename for the script file is longer than
- 128 characters.
-
- FATAL ERROR: SCRIPT FILES CANNOT RUN SCRIPT FILES
-
- Printed if the -s option appears in a script file.
-
- ERROR: 'ssssss' -s: Can not open script file
-
- Printed if the script file specified could not be opened.
-
- ERROR: 'llllll' -l: multiple log file names
-
- Printed for second and subsequent -l options.
-
- ERROR: 'no name' -l: missing log file name
-
- Printed if there is no argument for the -l option.
-
- ERROR: 'llllll' -l: file names cannot start with '-'
-
- Printed the the argument to the -l option starts with a '-'
-
- ERROR: 'too long' -l: file names cannot exceed 128 chars
-
- Printed when the filename for the log file is longer than
- 128 characters.
-
- ERROR: 'llllll' -l: Could not open log file
-
- Printed if the file name given in the -l option could not
- not be opened.
-
- ERROR: 'llllll' -l: Log File flush failed
-
- An attempt to update the contents of the log file on disk failed.
-
- ERROR: '-c' -c: Not allowed in scripts
-
- The -c option is not allowed in script files.
-
- ERROR: '-rx' -r: Only + can be used with this option
-
- Printed when the character following -r is invalid.
-
- ERROR: '-rox' -ro: Only + can be used with this option
-
- Printed when the character following -ro is invalid.
-
- ERROR: '-fx' -f: Only + can be used with this option
-
- Printed when the character following -f is invalid.
-
- ERROR: '-?x' -?: Only + can be used with this option
-
- Printed when the character following -? is invalid.
-
- ERROR: 'xxxx' unknown command line switch
-
- An option beginning with '-' was not recognized.
-
- ERROR: 'ffffff' extra FLC or FLI file name or missing switch
-
- Printed when the second and subsequent argument with no
- associated option is found.
-
- ERROR: 'too long' file names cannot exceed 128 chars
-
- Printed when the FLC or FLI file name is longer than 128
- characters.
-
- ERROR: 'no name' a FLC or FLI file name must be specified
-
- Printed when neither -?, -s, nor a FLC or FLI file name is given
- on the command line or a FLC or FLI file is missing from
- a script file.
-
- FATAL ERROR: FLIPAPER TERMINATED DUE TO ERRORS
-
- Errors were detected while checking a script for errors.
-
- FATAL ERROR: fffffff: Could not open FLC or FLI file
-
- Printed if the FLC or FLI file could not be opened.
-
- Not enough memory to allocate FLC or FLI file control area
- Not enough memory to allocate FLC or FLI image area
- Not enough memory to allocate FLC or FLI palette area
- FATAL ERROR: Cannot allocate xxxxxx bytes for FLI/FLC buffer
- FATAL ERROR: no memory for linebuf
-
- Printed if there is not enough memory for FLC or FLI file.
- The file control area requires 256 bytes, the palette area
- 768 bytes, the image area width x height bytes, and a work
- uses width x height + 7168 bytes. The size of the work buffer
- could exceed this maximum, if new versions of PJ produce
- additional CHUNK types in FRAMES.
-
-
- Corrupted FLC or FLI file: expected FCID_FRAME
- FATAL ERROR: Corrupted FLC or FLI frame, expected FCID_FRAME
- Corrupted FLC or FLI file: expected FCID_FRAME
- Not a FLC or FLI file
-
- Printed if the FLC or FLI file contains invalid data.
-
- Cannot access FLC or FLI file
-
- Printed if the FLC or FLI file could not be opened.
-
- FATAL ERROR: Insufficient Memory to print image
-
- Printed if the image scaling memory area could not be allocated.
- This area requires 12 x pixel width bytes.
-
- FATAL ERROR: Couldn't configure ADI rendering device
-
- Printed if the -r option is given and the rendering device
- specified in the RCPADI environment variable can not be
- configured.
-
- Abort configuration. Exit.
-
- Printed when CTRL-C or CTRL-BREAK is pressed while configuring
- the ADI rendering driver or the ADI hard copy driver.
-
- FATAL ERROR: Couldn't configure ADI hard copy device
-
- Printed if the rendering device specified in the RHPADI
- environment variable can not be configured.
-
- FATAL ERROR: Couldn't access ADI rendering screen
-
- Printed if the -r option is given and the rendering device
- specified in the RCPADI environment variable can not be
- initialized.
-
- No ADI rendering driver loaded.
-
- Printed if the ADI driver given by the environment variable
- RCPADI was not loaded.
-
- Couldn't initialize rendering driver
-
- Printed if the ADI driver initialization fails.
-
- FATAL ERROR: Couldn't access ADI hard copy device
-
- Printed if the rendering device specified in the RHPADI
- environment variable can not be initialized.
-
- No ADI hard copy driver loaded.
-
- Printed if the ADI driver given by the environment variable
- RCPADI was not loaded.
-
- Couldn't initialize hard copy driver
-
- Printed if the ADI driver initialization fails.
-
- FATAL ERROR: Could not allocate work area memory
-
- Printed if there is insufficient memory for the image work
- area. The memory required for TARGA output files is
- 3 x pixel width x pixel height. The memory required for ADI
- output is 3 x pixel width as configured in the device driver.
-
- FATAL ERROR: FLIPAPER Terminated due to USER ABORT
-
- Printed if CTRL-C or CTRL-BREAK is pressed and the -? option
- was not given.
-
- FATAL ERROR: Invalid number of frames per page
-
- An unexpected error printed if the program detects that the
- number of frames per page is invalid when arranging the frames
- on the page. This should not occur since it is detected earlier.
-
-
-
- WARNING MESSAGES
-
- A line number may also be included for any of these error messages, if the
- error was caused by a script line.
-
- WARNING: 'ssssss' -?: Script file ignored because of -? option
-
- Printed when -? and -s are both given on the command line.
- The script file is ignored.
-
- WARNING: 'iiiiii' -?: File ignored because of -? option
-
- Printed when -? and a FLC or FLI file are both given on the
- command line. The FLC or FLI file is ignored.
-
- WARNING: 'iiiiii' -s: File ignored because of -s option
-
- Printed when -s and a FLC or FLI file are both given on the
- command line. The FLC or FLI file is ignored.
-
- WARNING: 'oooooo' -s: Output file ignored because of -s option
-
- Printed when -s and -o are both given on the command line.
- The output file is ignored.
-
- WARNING: '-d' -d is only used with the -o option
-
- Printed when the -d option is given and the -o option is not.
- The -d option is ignored.
-
- WARNING: '-a' -a is only used with the -o option
-
- Printed when the -a option is given and the -o option is not.
- The -a option is ignored.
-
- WARNING: '-r' -o: -r is ignored because of -o option
-
- Printed when both the -o and -r options are given. The -r
- option is ignored.
-
- WARNING: '-c' -o: -c is ignored because of -o option
-
- Printed when both the -o and -c options are given. The -c
- option is ignored.
-
- D:\XXXX\XXXXX\FLIPAPER.CFG: Couldn't create.
-
- The configuration file FLIPAPER.CFG could not be updated.
-
-
- DRIVER MESSAGES
-
- CANNOT FIND THIS DRIVER: Is the environment variable RDPADI set?
-
- Cannot find ADI P386 rendering driver XXXXXXXXXXXXX.
- Enter ADI driver name:
-
- Printed if the rendering driver could not be found.
-
- CANNOT FIND THIS DRIVER: Is the environment variable RHPADI set?
-
- Cannot find ADI P386 hardcopy driver XXXXXXXXXXXXX.
- Enter ADI driver name:
-
- Printed if the hard copy driver could not be found.
-
- Cannot load ADI P386 display/rendering driver.
-
- Printed if the rendering driver load fails.
-
- Cannot load ADI P386 hardcopy driver.
-
- Printed if the hard copy driver load fails.
-
- Cannot init ADI P386 display/rendering driver.
-
- Printed if the rendering driver initialization fails.
-
- Cannot init ADI P386 hardcopy driver.
-
- Printed if the hard copy driver initialization fails.
-