Macro

Summary

Creates a print job that prints to the specified printer.

Package

capi

Signature

with-print-job ( var &key pane jobname printer ) &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.

See also

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