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

with-page-transform Macro

Summary

Defines a rectangular region within the coordinate space of an output pane or printer port.

Package

capi

Signature

with-page-transform (x y width height) &body body

Arguments
x, y
Real numbers.
width, height
Positive real numbers.
body
Lisp forms.
Description

The macro with-page-transform evaluates x, y, width and height to define a rectangular region within the coordinate space of an output pane or printer port. The forms of body are evaluated as an implicit progn with that region mapped onto the printable area of the page. If the specified rectangle does not have the same aspect ratio as the printable area of the page, then non-isotropic scaling will occur.

Any number of calls to with-page-transform can occur during the printing of a page; for example, it is sometimes convenient to use a different page transform from that used to print the main body of the page when printing headers and footers.

Examples
(example-edit-file "capi/graphics/metafile")
(example-edit-file "capi/printing/fit-to-page")
(example-edit-file "capi/printing/multi-page")
(example-edit-file "capi/printing/page-on-demand")
See also

get-printer-metrics
with-document-pages
with-page
16 Printing from the CAPI—the Hardcopy API


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