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

NextPrevUpTopContentsIndex

make-image-access

Generic Function
Summary

Creates an Image Access object.

Package

graphics-ports

Signature

make-image-access port image => image-access

Arguments

port

A graphics port.

image

An image object.

Values

image-access

An Image Access object.

Description

The generic function make-image-access returns an Image Access object for the given image image.

image can be any image object returned by make-image-from-port. An image object returned by load-image is also suitable, but only if it is a Plain Image (see below).

image-access is used when reading and writing the pixel values of the image. For an overview of using Image Access objects, see Image access.

Notes
  1. On some platforms (currently Windows) not every image object is a Plain Image. If needed, forcibly create a Plain Image suitable for passing to make-image-access as described in load-image.
  2. Ensure that you eventually discard image-access , using free-image-access.
Example
(example-edit-file "capi/graphics/image-access")
See also

free-image-access
image-access-transfer-from-image
image-access-transfer-to-image
image-access-height
image-access-pixel
load-image
make-image
Image access


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

NextPrevUpTopContentsIndex