Next: , Previous: PostScript driver class, Up: Configuration


A.7 The ASCII driver class

The ASCII driver class produces output that can be displayed on a terminal or output to printers. The ASCII driver has class name ‘ascii’.

The available options are listed below.

output-file=file-name
File to which output should be sent. This can be an ordinary file name (e.g., "pspp.txt"), a pipe (e.g., "|more"), or stdout ("-"). Default: "pspp.list".
chart-files=file-name-template
Template for the file names used for charts. The name should contain a single ‘#’, which is replaced by the chart number. Default: "pspp-#.png".
chart-type=type.
Type of charts to output. Available types typically include ‘X’, ‘png’, ‘gif’, ‘svg’, ‘ps’, ‘cgm’, ‘fig’, ‘pcl’, ‘hpgl’, ‘regis’, ‘tek’, and ‘meta’. Default: ‘png’.

You may specify ‘none’ to disable chart output. Charts are also disabled if your installation of PSPP was compiled without libplot.

paginate=boolean
If set, a formfeed will be written at the end of every page. Default: on.
tab-width=tab-width-value
The distance between tab stops for this device. If set to 0, tabs will not be used in the output. Default: 8.
headers=boolean
If enabled, two lines of header information giving title and subtitle, page number, date and time, and PSPP version are printed at the top of every page. These two lines are in addition to any top margin requested. Default: on.
length=line-count
Physical length of a page. Headers and margins are subtracted from this value. You may specify the number of lines as a number, or for screen output you may specify auto to track the height of the terminal as it changes. Default: 66.
width=character-count
Physical width of a page. Margins are subtracted from this value. You may specify the width as a number of characters, or for screen output you may specify auto to track the width of the terminal as it changes. Default: 79.
top-margin=top-margin-lines
Length of the top margin, in lines. PSPP subtracts this value from the page length. Default: 2.
bottom-margin=bottom-margin-lines
Length of the bottom margin, in lines. PSPP subtracts this value from the page length. Default: 2.
box[line-type]=box-chars
The characters used for lines in tables produced by the ASCII driver can be changed using this option. line-type is used to indicate which type of line to change; box-chars is the character or string of characters to use for this type of line.

line-type must be a 4-digit number. The digits are in the order `right', `bottom', `left', `top'. The possibilities for each digit are:

0
No line.
1
Single line.
2
Double line.

Examples:

box[0101]="|"
Sets ‘|’ as the character to use for a single-width line with bottom and top components.
box[2222]="#"
Sets ‘#’ as the character to use for the intersection of four double-width lines, one each from the top, bottom, left and right.
box[1100]="\xda"
Sets ‘"\xda"’, which under MS-DOS is a box character suitable for the top-left corner of a box, as the character for the intersection of two single-width lines, one each from the right and bottom.

Defaults:


init=init-string
If set, this string is written at the beginning of each output file. It can be used to initialize device features, e.g. to enable VT100 line-drawing characters.
emphasis=emphasis-style
How to emphasize text. Your choices are bold, underline, or none. Bold and underline emphasis are achieved with overstriking, which may not be supported by all the software to which you might pass the output.