




 
Graphics Ports supports drawing images, and also reading/writing them from/to file via your code. A wide range of image types is supported. Also, several CAPI classes support the same image types.
To draw an image with Graphics Ports, you need an 
image
 object which is associated with an instance of 
capi:output-pane
 (or a subclass of this). You can create a 
image
 object from:
external-image
 object
Draw the image to the pane by calling 
draw-image
. Certain images ("Plain Images") can be manipulated via the Image Access API. The image should be freed by calling 
free-image
 when you are done with it.
capi:image-pinboard-object
, 
capi:button
, 
capi:list-view
, 
capi:tree-view
 and 
capi:toolbar
 all support images. There is also limited support for images in 
capi:menu
. These classes handle the drawing and freeing for you.
CAPI User Guide (Unix version) - 30 Aug 2011