11.8.4 Loading images

To create an image object suitable for drawing on an given pane, use one of convert-external-image , read-and-convert-external-image , load-image , make-image-from-port , make-sub-image or load-icon-image .

Another way is to supply a registered image identifier in some CAPI class that suports images. For example you can specify an image in a capi:image-pinboard-object . Then, an image object is created implicitly when the pinboard object is displayed.

In all cases, the functions that create the image object require the pane to be already created. So if you are displaying the image when first displaying your window, take care to create the image object late enough, for example in the :create-callback of the interface or in the first :display-callback of the pane.

LispWorks CAPI User Guide (Unix version) - 8 Apr 2005