Function

Summary

Copies one area of a graphics port to another area of a different graphics port.

pixblt is deprecated.

Package

graphics-ports

Signature

pixblt to-port operation from-port to-x to-y width height from-x from-y

Arguments

to-port

A graphics port.

operation

A graphics state operation.

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.

Description

The pixblt function copies one area of from-port to another area of to-port using the specified operation and mask . Both ports should be the same depth. The graphics port transforms are not used.

operation is ignored when the drawing-mode is :quality (the default). See the "Graphics state" section in the CAPI User Guide for valid values for operation .

pixblt is deprecated, because the :quality drawing-mode does not support operation , and because it ignores the transformations, which means it does not always work as expected. In particular, it can draw at the wrong place inside the display-callback of output-pane.

Use instead copy-area, which does take account of the transform. See also graphics-state parameter compositing-mode for a way to control how copy-area blends the source and the target.

See also

copy-area
graphics-state