Creates an Image Access object.
A graphics port.
An image object.
An Image Access object.
The generic function
returns an Image Access object for the given image image.
can be any image object returned by make-image-from-port. An
object returned by
is also suitable, but only if it is a Plain Image (see below).
is used when reading and writing the pixel values of the image. For an overview of using Image Access objects, see the Graphics Ports chapter in the
LispWorks CAPI User Guide
Note: on some platforms (currently Windows) not every image object is a Plain Image. If needed, forcibly create a Plain Image suitable for passing to
as described in load-image.
Note: ensure that you eventually discard
, using free-image-access.
See the file
LispWorks CAPI Reference Manual - 17 Mar 2008