All Manuals > CAPI User Guide > 13 Graphics Ports


13.9 Working with images

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:

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.

13.9.1 Image formats supported for reading from disk and drawing

13.9.2 Image formats supported for writing to disk

13.9.3 External images

13.9.4 Registering images

13.9.5 Loading images

13.9.6 Querying image dimensions

13.9.7 Drawing images

13.9.8 Image access

13.9.9 Creating external images from Graphics Ports operations

CAPI User Guide (Unix version) - 30 Aug 2011