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
CAPI User Guide
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.
ensure that you eventually discard
, using free-image-access.
See the file
CAPI Reference Manual - 15 Dec 2011