All Manuals > CAPI User Guide and Reference Manual > 21 CAPI Reference Entries

simple-print-port Function

Summary

Prints the contents of an output pane to a printer.

Package

capi

Signature

simple-print-port port &key jobname scale dpi printer drawing-mode interactive background

Arguments
port
jobname
A string or nil.
scale
A positive real or nil.
dpi
A positive real or nil.
printer
A printer or nil.
drawing-mode
One of :compatible, :quality or nil.
interactive
A boolean.
background
A color in the Graphics Ports color system.
Description

The function simple-print-port prints the output-pane specified by port to the default printer, unless specified otherwise by printer.

If jobname is non-nil then it is used to set the name of the job that is seen by the user.

scale and dpi are used to determine how to transform the output pane's coordinate space to physical units. Their meaning here is the same as in get-page-area, except that scale may also take the value :scale-to-fit, in which case the pane is printed as large as possible on a single sheet.

The background color of port is ignored, and the value given by background is used instead. This defaults to :white.

drawing-mode should be either :compatible which causes drawing to be the same as in LispWorks 6.0, or :quality which causes all the drawing to be transformed properly, and allows control over anti-aliasing on Microsoft Windows and GTK+. The default value of drawing-mode is :quality.

For more information about drawing-mode, see 13.2.1 The drawing mode and anti-aliasing.

If interactive is t, a print dialog is displayed. This is the default. If interactive is nil, then the document is printed to the current printer without prompting the user.

Examples
(example-edit-file "capi/printing/simple-print-port")
(example-edit-file "capi/printing/multi-page")
See also

print-dialog
13 Drawing - Graphics Ports
16 Printing from the CAPI—the Hardcopy API


CAPI User Guide and Reference Manual (Macintosh version) - 01 Dec 2021 19:31:27