- image <-
name: name*
- Lookup key for the image. Used to populate @images; @nil
for anonymous (read-write) images.
- See also
- image
->initialise
- image <-
kind: {bitmap,pixmap}
- Interpretation of the pixel values:
pixmap (default) — each pixel is a 32-bit RGBA
colour.bitmap — each pixel is either black or white. When
the image is painted, white pixels are mapped to the current foreground
and black pixels to the background. Used for monochrome icons.
- image <-
access: {read,both}
read for reusable images (the file-loaded case): the pixels
are immutable, the image can be shared by many callers.
both for read-write scratch images. A both
image may be associated with at most one bitmap graphical;
edits propagate to that bitmap.
- See also
- image
<-bitmap
- image <-
file: source_sink*
- File (or other
source_sink) from which the image was
loaded.
@nil for
anonymous images.
- image <-
bitmap: bitmap*
- Bitmap graphical backed by this image. Only meaningful when
image
<-access
is both; at most one bitmap per image.
- See also
- - bitmap
->image
- image<-access
- image <-
size: size
- Pixel dimensions of the image. When loading from a file the size is
derived from the file's contents; the default for a fresh anonymous
image is 16x16 pixels. For SVG loads the size field can be set before image
->load
to drive the rendered size (see image->load).
- image <->
hot_spot: point*
- Hot-spot position used when this image is rendered as a cursor
(typically the click point of a mouse cursor). May be set manually or
loaded from an XPM file's hot-spot record.
