1.82.3 Send methods

image ->initialise: name=[source_sink]*, width=[int], height=[int], kind=[{bitmap,pixmap}]

Two idiomatic ways to construct an image:

• Reusable file-backed image: new(I, image(File)). The constructor first looks File up in @images; on a hit it returns the existing instance. Otherwise it builds a new image and image->loads its pixels from the file. Such images get image<-access read.
• Anonymous read-write image: new(I, image(@nil, Width, Height)). These images are not pooled and have image<-access both.

  The kind argument selects between pixmap (default) and bitmap.

  See also

  - image->load
  - image<-lookup

image ->unlink:

Release the pixel store and the cairo surface backing the image. Called automatically on destruction.

image ->load: from=[source_sink], path=[char_array]

Load pixels from a file or other source_sink. When the source is a file, it is first located via file->find on path (defaults to image.path).

The decoder is SDL_image, so PNG, JPEG, BMP, GIF, PCX and the other formats supported by SDL_image all load. SVG is recognised by file extension or by sniffing the stream and is rendered through SDL's size-aware SVG loader:

• both image<-width and image<-height non-zero → SVG is rendered at exactly that size;
• both zero → SVG viewport size is used;
• one of the two zero → the other dimension scales to preserve the SVG's aspect ratio.

  Streams that are not SVG fall back to a built-in PNM reader when SDL_image cannot interpret them.

  See also

  pce_image_directory/1

image ->save: in=[file], format=[{png}]

Write the image to a file. PNG is the only format that can be written, so format only serves to say so explicitly and may be omitted. xpce 6 accepted a range of X11-era formats here (xbm, pnm, gif, ...); none of these are written any more.

in defaults to image<-file, the file the image was loaded from. That is a source_sink rather than a file: if it is not something we can write to, image->save fails with a message on the console.

image ->resize: width=int, height=int

Resize the image to the indicated dimensions, preserving the overlapping pixels. Newly-exposed area is cleared to the background. See also image<-scale.

image ->copy: from=image

Replace the receiver's pixels with an exact copy of the argument. Use image->draw_in to blit an image into a sub-area instead.

image ->draw_in: graphical, at=[point]

Render the given graphical (or image) onto the receiver at the given offset (default point(0,0)).

image ->clear:

Clear the entire image to the background (transparent for pixmap, 0 for bitmap).

image ->fill: colour, [area]

Fill the indicated area (default whole image) with the given colour.

image ->pixel: x=int, y=int, value=colour|bool

Set the pixel at (x, y) to the given colour (for pixmap) or boolean (for bitmap).

image ->has_alpha:

Succeed when the image is not fully opaque (at least one pixel has alpha < 255).