with-page-transform

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")