Structural Informatics Group (SIG) logo
Home | Projects | Demos | Downloads | Publications | Local Info | About Us | New site
Go to the first, previous, next, last section, table of contents.

:GET-ARRAY and :SET-ARRAY

source files: xgrl.[ch]

SYNTAX

(SEND <grl> :GET-ARRAY <:NAME> [<dflt>])
(SEND <grl> :SET-ARRAY <:NAME> <ary>)

DESCRIPTION

A GRAPHICS-RELATION is essentially a smart propertylist of arrays. These two calls allow you to fetch and store arrays in relations. Any arrays stored must be the same shape as the relation.

:GET-ARRAY and :SET-ARRAY work strictly parallel to :GET and :SET, except for functioning on the arraylist instead of the propertylist.

<ary> should normally be an array of the same shape as the relation. As a convenience, <ary> may also be one of the <grl> compatible class objects (CLASS-FLOAT-ARRAY, CLASS-INT32-ARRAY, CLASS-UNSIGNED8-ARRAY, CLASS-UNSIGNED16-ARRAY, CLASS-INT16-ARRAY, CLASS-BIT-ARRAY, CLASS-8-BIT-FLOAT-ARRAY, CLASS-16-BIT-FLOAT-ARRAY), in which case an instance of the given class will be created, correctly shaped, and inserted.

If the optional <dflt> (usually NIL) argument is supplied, :GET-ARRAY will return this if no array by that name exists; otherwise, it will signal an error.


Go to the first, previous, next, last section, table of contents.