All Manuals > CAPI User Guide and Reference Manual > 22 GRAPHICS-PORTS Reference Entries

NextPrevUpTopContentsIndex

copy-pixels

Function
Summary

Copies a rectangular area from one port to another.

Package

graphics-ports

Signature

copy-pixels to-port from-port to-x to-y width height from-x from-y &rest args

Arguments

to-port

A graphics port.

from-port

A graphics port.

to-x

A real number.

to-y

A real number.

width

A real number.

height

A real number.

from-x

A real number.

from-y

A real number.

args

graphics-state parameters passed as keyword arguments.

Description

The function copy-pixels copies a rectangular area from one port to another. The transform , mask , mask-transform, compositing-mode and shape-mode from to-port 's graphics-state are used.

The ( to-x to-y ) is transformed according to to-port 's transform. When to-port 's drawing-mode is :quality the target is generally fully transformed, except that when it copies from a visible window it may generate expose events when copying from an obscured part, and in drawing-mode :quality it ignores the transformation in this case.

If to-port 's drawing-mode is :compatible then the image is not scaled or rotated. For more information about drawing-mode , see The drawing mode and anti-aliasing.

The to-port and from-port need not be the same depth and can be the same object. The from-x and from-y values are interpreted as pixel positions in the window coordinates of from-port , that is, they are not transformed by from-port 's transform.

Notes

copy-pixels can be used to draw to an output-pane inside the display-callback of that pane, but it cannot be used to copy from the output-pane inside its display-callback (the result of such an operation is not defined).

See also

copy-area
output-pane
Drawing - Graphics Ports


CAPI User Guide and Reference Manual (Macintosh version) - 3 Aug 2017

NextPrevUpTopContentsIndex