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:

KeywordMeaning
A0841 x 1189 millimeters (33.13 x 46.85 inches)
A1594 x 841 millimeters (23.40 x 33.13 inches)
A2420 x 594 millimeters (16.55 x 23.40 inches)
A3297 x 420 millimeters (11.70 x 16.55 inches)
A4210 x 297 millimeters (8.27 x 11.70 inches)
A8.5 x 11 inches (216 x 279 millimeters)
B11 x 17 inches (279 x 432 millimeters)
C17 x 22 inches (432 x 559 millimeters)
D22 x 34 inches (559 x 864 millimeters)
E34 x 44 inches (864 x 1118 millimeters)
LEDGER11 x 17 inches (279 x 432 millimeters)
LEGAL8.5 x 14 inches (216 x 356 millimeters)
LETTER8.5 x 11 inches (216 x 279 millimeters)
LP13.7 x 11 inches (348 x 279 millimeters)
VT8 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:
KeywordMeaning
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