ddifps(1)ddifps(1)Nameddifps - convert DDIF formatted files to PostScript(TM) formatted files
Syntaxddifps [-m message_log] [-O optionfile] [-o outputfile] [-p
options_line]... [-d extension] [inputfile [outputfile [logfile]]]
Description
The ddifps command reads a DDIF formatted file from inputfile and
writes a PostScript file to outputfile. To convert from file.ddif to
file.ps, type:
ddifps file.ddif file.ps.
If you do not supply an input file, or if you supply a minus sign (-)
as an argument, ddifps reads the DDIF file from the standard input
file. If you do not supply an output file, or if a minus sign (-) is
encountered as an argument, ddifps writes the PostScript file to the
standard output file.
If you specify a logfile, ddifps redirects standard error to the log‐
file. You can also invoke the ddifps conversion with the cdoc command
when you use that command and specify the option -d ps.
If the DDIF input file is a newer version of the DDIF grammar than that
understood by the converter, data represented by the new grammar ele‐
ments is lost. Any external file references within the DDIF input file
are resolved.
A document syntax error in the DDIF input file causes a fatal input
processing error. The conversion stops and no further input processing
occurs.
Options-m message_log
Enables enhanced messaging and logs all messages to message_log
or, if '-' is specified, to standard error in place of the mes‐
sage_log. If you do not specify this option, only serious errors
are reported.
-O optionfile
Specifies the name of the options file that contains the options
you want to select for this converter.
The options file has a default file type of .cda_options.
Each line of the options file specifies a format name that
can optionally be followed by _input or _output to restrict
the option to either an input or output converter. The second
word is a valid option preceded by one or more spaces, tabs,
or a slash (/) and can contain uppercase and lowercase let‐
ters, numbers, dollar signs, and underlines. The case of let‐
ters is not significant. If an option requires a value, then
spaces, tabs, or an equal sign can separate the option from
the value.
You can precede any line by spaces and tabs. To terminate a
line, use any character other than those used to specify the
format names and options. The syntax and interpretation of
the text that follows the format name is specified by the
supplier of the front and back end converters for the speci‐
fied format.
To specify several options for the same input or output for‐
mat, specify one option on a line. If an invalid option for
an input or output format or an invalid value for an option
is specified, the option may be ignored or an error message
may be returned. Each input or output format that supports
processing options specifies any restrictions or special for‐
mats required when specifying options.
By default, any messages that occur during processing of the
options file are written to standard error. For those input
and output formats that support a LOG option, messages can be
directed to a log file or to a common message log.
-o outputfile
Specifies the name of the output file that is included in the
command syntax for compatibility with the cdoc command.
-p options_line
Allows options to be specified on the command line and has
the same effect as specifying an options file for this con‐
verter. You can specify up to 100 options, each preceded by
-p.
-d extension
Allows the specification of a default output file extension
for compatibility with other operating systems.
Converter Processing Optionsddifps supports the following processing options in an options file or
in options specified on command lines:
o PAPER_SIZE size
Specifies the size of the paper to be used when formatting the
resulting PostScript output file. Valid values for the size argu‐
ment are as follows:
Keyword Meaning
A0 841 x 1189 millimeters (33.13 x 46.85 inches)
A1 594 x 841 millimeters (23.40 x 33.13 inches)
A2 420 x 594 millimeters (16.55 x 23.40 inches)
A3 297 x 420 millimeters (11.70 x 16.55 inches)
A4 210 x 297 millimeters (8.27 x 11.70 inches)
A 8.5 x 11 inches (216 x 279 millimeters)
B 11 x 17 inches (279 x 432 millimeters)
C 17 x 22 inches (432 x 559 millimeters)
D 22 x 34 inches (559 x 864 millimeters)
E 34 x 44 inches (864 x 1118 millimeters)
LEDGER 11 x 17 inches (279 x 432 millimeters)
LEGAL 8.5 x 14 inches (216 x 356 millimeters)
LETTER 8.5 x 11 inches (216 x 279 millimeters)
LP 13.7 x 11 inches (348 x 279 millimeters)
VT 8 x 5 inches (203 x 127 millimeters)
The A paper size (8.5 x 11 inches) is the default. You can spec‐
ify the following units of measurement: in for inches (default),
cm for centimeters, mm for millimeters, po or pt for points.
o PAPER_HEIGHT height
Specifies a paper height other than one of the predefined values
provided. The default paper height is 11 inches. You can specify
the following units of measurement: in for inches (default), cm
for centimeters, mm for millimeters, po or pt for points.
o PAPER_WIDTH width
Specifies a paper width other than one of the predefined values
provided. The default paper width is 8.5 inches. You can specify
the following units of measurement: in for inches (default), cm
for centimeters, mm for millimeters, po or pt for points.
o PAPER_TOP_MARGIN top-margin
Specifies the height of the margin provided at the top of the
page. The default value is 0.25 inch. You can specify the follow‐
ing units of measurement: in for inches (default), cm for centime‐
ters, mm for millimeters, po or pt for points.
o PAPER_BOTTOM_MARGIN bottom-margin
Specifies the height of the margin provided at the bottom of the
page. The default value is 0.25 inch. You can specify the follow‐
ing units of measurement: in for inches (default), cm for centime‐
ters, mm for millimeters, po or pt for points.
o PAPER_LEFT_MARGIN left-margin
Specifies the width of the margin provided on the left-hand side
of the page. The default value is 0.25 inch. You can specify the
following units of measurement: in for inches (default), cm for
centimeters, mm for millimeters, po or pt for points.
o PAPER_RIGHT_MARGIN right-margin
Specifies the width of the margin provided on the right-hand side
of the page. The default value is 0.25 inch. You can specify the
following units of measurement: in for inches (default), cm for
centimeters, mm for millimeters, po or pt for points.
o PAPER_ORIENTATION orientation
Specifies the paper orientation to be used in the PostScript out‐
put file. You can specify the following units of measurement: in
for inches (default), cm for centimeters, mm for millimeters, po
or pt for points. The valid values for the orientation argument
are:
Keyword Meaning
PORTRAIT The page is oriented so that the larger dimension is
parallel to the vertical axis.
LANDSCAPE The page is oriented so that the larger dimension is
parallel to the horizontal axis.
The default is PORTRAIT.
o EIGHT_BIT_OUTPUT [ON,OFF]
Specifies whether the converter should use 8-bit output. The
default value is ON.
o LAYOUT [ON,OFF]
Specifies whether the converter processes the layout specified in
the DDIF document. The default value is ON.
o OUTPUT_BUFFER_SIZE output-buffer-size
Specifies the size of the output buffer. The value you specify
must be within the range 64 to 256. The default value is 132.
o PAGE_WRAP [ON,OFF]
Specifies whether the converter performs page wrapping of any text
that would exceed the bottom margin. The default value is ON.
o SOFT_DIRECTIVES [ON,OFF]
Specifies whether the converter processes soft directives in the
DDIF file in order to format output. (Soft directives specify
such formatting commands as new line, new page, and tab.) If the
converter processes soft directives, the output file will look
more like you intended it to look. The default value is ON.
o WORD_WRAP [ON,OFF]
Specifies whether the converter performs word wrapping of any text
that would exceed the right margin. The default value is ON. If
you specify OFF, the converter allows text to exceed the right
margin.
See Alsocdoc(1), CDA(5), cda_msg(5), DDIF(5), dvr_msg(5)ddifps(1)
