Next Prev Up Top Contents Index

load-image

Function
Summary

Loads an image and returns the image object.

Signature

load-image gp id &key cache image-translation-table => image

Arguments

gp

A graphics port

id

An image identifier

cache

A keyword

image-translation-table

An image translation table

Values

image

An image object

Description

The load-image function loads an image identified by id via the image-translation-table using the image load function registered with it. It returns an image object with the representation slot initialized. The gp argument specifies a graphics port used to identify the library. It also specifies the resource in which colors are defined and if necessary allocated for the image. If id is in the table but the translation is not an external image, and the image loader returns an external image as the second value, that external image replaces the translation in the table. The default value of image-translation-table is *default-image-translation-table* .

The cache argument controls whether the image translation is cached. See the convert-external-image function for more details.


LispWorks CAPI Reference Manual - 14 Dec 2001

Next Prev Up Top Contents Index