register-image-translation

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*.