[ options ] file1 file2...
Asciitiff converts an ASCII file into a raster image stored in a TIFF file.
In addition to supporting a number of options, asciitiff also handles a number
of imbedded commands that affect its operation.
Asciitiff is used by Faximum to format the cover sheets.
-o option is not used to name an output file,
the output file is named
by taking the input file name and adding
.tif. If the file name
already ends in a "." extension, then it is replaced with
No input file or a file with the name `-' implies standard input.
asciitiff recognises input of the form
as a command to
asciitiff. In any of the following commands where a position expression
(i.e. centre-x) is required, you may use an expression. Expressions may use
any of the standard arithmetic operators (*, `/', `+', or `-') as well as
ito indicate inches,
pto indicate pixels, or
cto indicate centimetres.
By default, the horizontal unit is in units of a character width, and the vertical unit is in units of (character) lines. The upper left corner is (0,0). The x axis (the first number of the pair) is the horizontal position across the line. The y axis (the second number of the pair) is the vertical position down the page.
NOTE: Decimal numbers must start with a digit (i.e. 0.5 rather than just .5).
The following lists the commands and their actions.
arc centre-x centre-y start-x start-y end-x end-y
Draws an arc with its centre at (centre-x, centre-y) starting at (start-x, start-y) and continuing until it reaches a line drawn from (centre-x, centre-y) to (end-x, end-y).
box start-x start-y end-x end-y [radius]
Draws a box with the upper left corner at (start-x, start-y) and the lower right corner at (end-x, end-y). If the optional fifth parameter radius has been supplied, then the box is drawn with rounded corners of the specified radius.
circle centre-x centre-y radius
Draws a circle with a radius of radius and a centre at (centre-x, centre-y).
Ends the current page at position page-length or if no argument, at the current position.
Inserts the date and time at the current position. The format-string may contain any of the time format specifiers supported by the strftime `C' library routine. See the manual page on strftime in this appendix for details on the format specifiers. If format-string is omitted, the default specifier %c is used.
define variable value
Sets the value of variable to value. The value of a named variable may be accessed using the replace command (see below).
Changes the current font to the specified font. For more information, see Cover Sheet Fonts.
ifdef arg1 arg2
Conditionally includes arg2 at the current position if arg1 is defined.
ifndef arg1 arg2
Conditionally includes arg2 at the current position if arg1 is not defined.
Includes the contents of the specified (text) file.
line start-x start-y end-x end-y
Draws a line from (start-x, start-y) to (end-x, end-y).
moveto x y
Moves the current point to the specified location.
replace variable [default-value]
Substitutes the value of the names variable. If the variable has not been defined, then use the default value specified. The second parameter (the default value) need not be specified.
Ensures that there is at least distance space available. If the distance between the current position and the end of the page is less that distance, the current position is moved to the top of the next page. The value may be suffixed by i to indicate inches (the default), c for centimeters, or p for pixels.
Sets a system parameter. System parameters include:
set-mark x y
Sets the current mark (remembered position) to the coordinates specified (usually `.' or the current location). The x or y component of the remembered position may be referenced by using the @ character in place of either the x or y parameter. For example, to return to the marked position, use $[moveto @ @].
Executes the shell command and inserts the resulting output at the current position.
tiffinclude filename [ [ [ [start-x] start-y] end-x] end-y]
tiffoverlay filename [ [ [ [start-x] start-y] end-x] end-y]
Includes the specified TIFF image at the specified location. Note that the difference between tiffinclude and tiffoverlay is that in the case of tiffinclude, the image being included is considered to be opaque and obscures any underlying image while with tiffoverlay, the image being overlaid is considered to be transparent and any underlying image will show through. If either of the starting positions is omitted, then 0 is assumed. If either of the ending positions is omitted, then $ is assumed.
Asciitiff also recognises the following special characters in the input stream and processes them appropriately: formfeed; tab; backspace; newline; carriage return; reverse linefeed (ESC 7); reverse half-linefeed (ESC 8); and forward half-linefeed (ESC 9).
/coversheet/* (coversheet definition files)
convert, pcltiff, dpstiff, strftime, tifftiff
Cover Sheet Fonts