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:
box[0000]=" "
box[1000]="-"
box[0010]="-"
box[1010]="-"
box[0100]="|"
box[0001]="|"
box[0101]="|"
box[2000]="="
box[0020]="="
box[2020]="="
box[3000]="="
box[0030]="="
box[3030]="="
- For all others, ‘+’ is used unless there are double lines or
special lines, in which case ‘#’ is used.
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.