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.