 |
Index for Section 1 |
|
 |
Alphabetical listing for D |
|
ddifps(1)
NAME
ddifps - convert DDIF formatted files to PostScript(TM) formatted files
SYNOPSIS
ddifps [-m message_log] [-O optionfile] [-o outputfile] [-p
options_line]... [-d extension] [inputfile [outputfile [logfile]]]
OPTIONS
-m message_log
Enables enhanced messaging and logs all messages to message_log or, if
`-' is specified, to the standard error in place of the message_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 letters, numbers, dollar signs, and underlines. The case of
letters 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 specified format.
To specify several options for the same input or output format, 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 formats required when specifying options.
By default, any messages that occur during processing of the options
file are written to the 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 converter. 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.
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 the standard error to the
logfile. 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 elements
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.
CONVERTER PROCESSING OPTIONS
The ddifps command supports the following processing options in an options
file or in options specified on command lines:
PAPER_SIZE size
Specifies the size of the paper to be used when formatting the
resulting PostScript output file. Valid values for the size argument
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 specify the
following units of measurement: in for inches (default), cm for
centimeters, mm for millimeters, po or pt for points.
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.
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.
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 following units of
measurement: in for inches (default), cm for centimeters, mm for
millimeters, po or pt for points.
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 following units of
measurement: in for inches (default), cm for centimeters, mm for
millimeters, po or pt for points.
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.
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.
PAPER_ORIENTATION orientation
Specifies the paper orientation to be used in the PostScript output
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.
EIGHT_BIT_OUTPUT [ON,OFF]
Specifies whether the converter should use 8-bit output. The default
value is ON.
LAYOUT [ON,OFF]
Specifies whether the converter processes the layout specified in the
DDIF document. The default value is ON.
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.
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.
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.
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 ALSO
cdoc(1), cda(4), cda_msg(4), ddif(4), dvr_msg(4)