source files: xgrl.[ch]
(SEND <grl> :GET-ARRAY <:NAME> [<dflt>]) (SEND <grl> :SET-ARRAY <:NAME> <ary>)
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.