Content-type: text/html
Man page of ddifps
ddifps
Section: User Commands (1)
Index
Return to Main Contents
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
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.
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.
Specifies the name of the output file that is included in
the command syntax for compatibility with the
cdoc
command.
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.
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:
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.
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.
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.
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.
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.
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.
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.
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.
Specifies whether the converter should use 8-bit output. The
default value is ON.
Specifies whether the converter processes the layout specified
in the DDIF document. The default value is ON.
Specifies the size of the output buffer. The value you specify
must be within the range 64 to 256. The default value is 132.
Specifies whether the converter performs page wrapping of
any text that would exceed the bottom margin. The default value is ON.
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.
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)
Index
- NAME
-
- SYNOPSIS
-
- OPTIONS
-
- DESCRIPTION
-
- CONVERTER PROCESSING OPTIONS
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 02:43:04 GMT, October 02, 2010