Macro

Summary

Creates a metafile in memory using Graphics Ports operations.

Package

capi

Signature

with-internal-metafile ( var &key pane bounds format drawing-mode ) &body body => metafile

Arguments

var

A variable.

pane

A graphics port, or nil .

bounds

A list of four integers. Can also be nil on Microsoft Windows.

format

One of the keywords :enhanced , :enhanced-plus and :enhanced-gdi .

drawing-mode

One of the keywords :compatible and :quality .

body

Lisp code.

Values

metafile

A metafile.

Description

The macro with-internal-metafile creates a metafile containing records corresponding to the Graphics Ports operations in body that draw to var .

with-internal-metafile behaves like with-external-metafile except that an object representing the metafile is returned, and no file is created on disk.

var , pane , bounds , format , drawing-mode and body are interpreted as for with-external-metafile except that format cannot have the value :windows .

Note: GDI+ gives the best quality, so normally that what you want. But you cannot put a GDI+ only metafile on the clipboard, which is why the default is to make a "dual" metafile containing both GDI and GDI+ drawing. If are not going to put the metafile on the clipboard (by calling set-clipboard with format :metafile ) you can use format :enhanced-plus which is slightly faster and uses less memory.

metafile must be freed after use, by calling free-metafile.

Notes

1. with-internal-metafile is supported on GTK+ only where Cairo is supported (GTK+ version 2.8 and later).
2. On GTK+, the internal metafile is slow to resize, so it is probably not useful when it is frequently resized (that is, drawn with different width or height).
3. with-internal-metafile is not implemented on X11/Motif.

Examples

examples/capi/graphics/metafile.lisp

examples/capi/graphics/metafile-rotation.lisp

See also

draw-metafile
free-metafile
with-external-metafile