Digital

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]]]

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 logfile.  You can also invoke the ddifps conversion with the cdoc(1) command when you use that command and specify the option −d text or −s ddif. 
 
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.

FLAGS

−m message_log
Logs messages to the specified file or, if a minus sign (−) is encountered as an argument, to the standard error file. If you do not specify this option but you do specify inputfile, outputfile, and logfile, then message_log will contain any information sent to standard error. 

−O optionfile
Specifies the name of the options file that contains the options you want to select for this converter.

−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.

−d extension
Allows the specification of a default file extension for compatibility with other operating systems.

Converter Processing Options

ddifps 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 argument are as follows:

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. 

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 following units of measurement: in for inches (default), cm for centimeters, 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 following units of measurement: in for inches (default), cm for centimeters, 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 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:

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.

RELATED INFORMATION

cdoc(1), ddifanls(1), ddiftext(1), dtifanls(1), dtifddif(1), textddif(1)