Macro

Summary

Creates a print job that prints to the specified printer.

Package

capi

Signature

with-print-job ( var &key pane jobname printer drawing-mode ) &body body

Description

The with-print-job macro creates a print job which prints to printer . If printer is not specified, the default printer is used. The macro binds var to a graphics port object, and printing is performed by using graphics port operations to draw the object.

If pane is specified it must be an instance of output-pane or a subclass. In this case var is bound to pane , and pane is modified within the dynamic extent of the with-print-job so all drawing operations draw to the printer instead of pane . This can be useful when implementing printing by modifying existing redisplay code that is written expecting an output-pane.

jobname is the name of the print job. The default value is nil , meaning that the name "Document" is used.

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 "Drawing mode and anti-aliasing" in the CAPI User Guide .

See also

printer-port-handle
printer-port-supports-p
set-printer-options
with-document-pages
with-page
with-page-transform