2 GP Reference Entries

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

Theload-image function loads an image identified by id via the image-translation-table using the image load function registered with it. It returns animage 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.