copy-pixels-to-stream

Implements the bit block transfer operation, generalized to
pixels. Pixels from texture are copied onto
stream using paint-operation
to combine them with the existing ones. Note that the function copy-to-stream does much
the same thing as this function and does not require the use of
separate texture and texture-info objects.

from-box-or-nil is either a box object or nil. If it is a box, it is the box in texture from
which copying occurs. If it is nil, then the
whole pixmap is copied.

to-box-or-position is either a box object or a
position object. If it is a box, it is the box in stream which is
modified. If it is a position, then the pixmap is copied with its
upper-left corner at that position without stretching the pixmap.

Thus, if from-box-or-nil is nil and to-box-or-position is a
position, then the entire pixmap is drawn at the specified position
without stretching it.

The box to be copied is intersected with the texture dimensions and
stream clipping box and the resultant box is the set of pixels
actually copied. If texture is a bitmap, 1's are copied as stream's
foreground color, 0's as its background color. If texture-info is
nil, one that matches the stream is used.

When the destination area (to-box-or-nil) is a
box of a different size than the source bitmap, the copied area is
stretched rather than clipped to make it fit the destination
area. Clipping is performed when the source area
(from-box-or-nil) is a box of a different size
than the source bitmap.

Copyright (c) 1998-2012, Franz Inc. Oakland, CA., USA. All rights reserved.Documentation for Allegro CL version 9.0. This page was not revised from the 8.2 page.Created 2012.5.30.