All Manuals > CAPI User Guide and Reference Manual > 22 GRAPHICS-PORTS Reference Entries

register-image-translation Function

Summary

Registers an image identifier and image loading function with a translation in an image translation table.

Package

graphics-ports

Signature

register-image-translation image-id translation &key image-translation-table image-load-fn => image-id, image-load-fn

Arguments
image-id
An image identifier.
translation
An image translation.
image-translation-table
An image translation table.
image-load-fn
An image loading function.
Values
image-id
An image identifier.
image-load-fn
An image loading function.
Description

The function register-image-translation registers image-id and image-load-fn with translation in image-translation-table. When load-image is called with second argument image-id, then image-load-fn is called with translation as its second argument.

If image-load-fn is nil, the default image loader in image-translation-table is used; this converts an external image object or file to an image.

If translation is nil then image-id is deregistered.

The default value of image-translation-table is *default-image-translation-table*.

See also

*default-image-translation-table*
load-image
reset-image-translation-table
13 Drawing - Graphics Ports


CAPI User Guide and Reference Manual (Macintosh version) - 01 Dec 2021 19:31:44