Provided by:
survex_1.0.39ubuntu1_i386 
NAME
print.ini — survex printer settings
Description
The print.ini file contains printer descriptions for the Survex printer
drivers.
File Format
The format of the print.ini file is similar to the .ini files used on
Microsoft Windows. The file is divided into sections, each section
corresponding to a separate printer description. A section starts with
a section name in square brackets, e.g.:
[generic_pcl]
followed by some options of the form <option>=<setting>, e.g.:
pixels_across_page=960
Most options are preceded by a comment (indicated by a semicolon ’;’)
briefly explaining the option.
Each section can contain a ’like’ option. If present this contains the
name of another section (possibly in another print.ini file). Options
not specified in the current section will be taken from that section.
This allows a printer definition to be based on that for another
similar model of printer.
Here is an example of how this works:
[dm_9pin_12inch]
like=dm_11inch_9pin
lines_down_page=108
This says that the definition ’dm_9pin_12inch’ (for a 9pin dot matrix
printer using 12 inch paper), is just like the 11 inch definition for
the same printer, except that there are more lines per page.
Each printer driver reads a different section - printdm (the Dot Matrix
driver) reads:
[dm]
printhpgl (for HPGL plotters) reads:
[hpgl]
printpcl (for PCL printers) reads:
[pcl]
printps (for Postscript printers) reads:
[ps]
Several definitions are supplied for each printer driver, covering most
commonly encountered printers of each type.
printdm
The definitions provided for printdm are: dm_8pin_a4, dm_8pin_11inch,
dm_8pin_12inch, dm_9pin_a4, dm_9pin_11inch, dm_9pin_12inch,
dm_24pin_a4, dm_24pin_11inch, dm_24pin_12inch, dm_panasonic_24pin,
dm_lx86_9pin_11inch, and bj (for driving Canon BJ printers).
In the unlikely event that you need to change the printer control
codes, here is a quick overview of the format: printable characters are
literal, except for backslash. A backslash ’´ indicates that the
following character or characters are to be interpreted as a control
code, as follows: followed by an ’x’ followed by two hex digits
represents the character with that hex value; a double backslash meais
a literal backslash; is nul (0); is tab (9); is newline (10);
return (13); is escape (27); 0(1) to (26).
This is all rather cryptic (printer codes inherently are) but the
provided set-ups will work with nearly all dot matrix printers, so you
are unlikely to need to fiddle with these runes.
printhpgl
The definitions provided for printhpgl are: hpgl_generic_a4landscape,
hpgl_generic_a1landscape, and hpgl_generic_a0landscape.
printpcl
The definitions provided for printpcl are: pcl_generic_a4 and
pcl_modern_a4.
Note that if you are using a PCL printer the defaults are set not to
use advanced printer features for compatibility. If you want to try
these (equivalent to HP Laserjet III or later), then you should use the
modern_pcl_a4 printer definition (see below for how to do this). This
will enable horizontal and vertical tabbing.
printps
There’s only one definition provided at present: ps_generic_a4.
Customising Printer Settings
The only settings most users will want to customise are which printer
definition is used, and where to send the output. If you’re using a
Dot Matrix Printer you will also need to set calibration details.
You shouldn’t modify the master print.ini (located in /usr/share/survex
on Unix, or in the same directory as the Survex program files on other
systems), or your changes will be overwritten by upgrades. Instead
create:
· /etc/survex/print.ini (Unix - system-wide settings)
· ~/.survex/print.ini (Unix - per user settings)
· myprint.ini in the directory where Survex is installed (other
platforms)
The drivers look for the section "[dm]", "[ps]", "[pcl]" or "[hpgl]" as
appropriate. The file you create should should contain something like
this to select a particular printer:
[pcl]
like=pcl_modern_a4
For printdm, it should also contain calibration measurements (calibrate
your printer by running printdm --calibrate):
[dm]
like=dm_24pin_a4
mm_across_page=202
mm_down_page=278
You can override other settings too, such as the output destination.
This is usually inherited from [base], and can be overridden in [base]
(where it’ll apply to all printer drivers) or in a printer driver
specific section (such as [dm]). The output destination is set by an
option of the form output_<platform>=<device>, where device can be a
device name (e.g. PRN, LPT1, LPT2 under DOS, Printer: under RISC OS) or
a filename:
[dm]
output_msdos=LPT1
like=dm_24pin_a4
mm_across_page=202
mm_down_page=278
Under UNIX output may be piped into another command like so:
[base]
; send output to printer ’oak’
output_unix=|lpr -Poak
Note you can also override the output setting using the --output
command line option.
If the output device isn’t a device or a pipe command, it is taken as a
filename to write the printer data to. This can then be sent to a
printer later.
Caution:
If you’re using DOS you need to be careful when sending output
to a file - printdm, printpcl and printhpgl all produce binary
files, which must then be sent to the printer with COPY /B
OUTPUT PRN where OUTPUT is the filename and PRN the device name.
Do not use COPY without the /B. If you do, the output may be
corrupted. Sorry, this is a deficiency of DOS, and there is
nothing we can do about it.
If you send output straight to the printer, by putting PRN or
LPT1 in the configuration file, then this problem should not
occur.
printps produces text files as output, and so should be
unaffected by this problem.
printdm can also drive Canon bubblejets in native mode (which gives a
higher resolution than in Epson emulation mode). To use this, set
"like=bj" in the "[dm]" section - like so:
[dm]
like=bj
See Also
printdm(1), printhpgl(1), printpcl(1), printps(1)
print.ini(5)