Memory Methods on List_Of_Inst

 

GRAPE(list, "free")()

    LIST_OF_INST *list

Delete an instance of class List_Of_Inst. All instances of the list are deleted by calling "list-free", then the instance itself is deleted.

GRAPE(list, "list_alloc")(length, class, name)
GRAPE(list, "list_free")()

        LIST_OF_INST *list
int length
CLASS *class
char *name

"list_alloc" allocates the memory for the flag and instance arrays. If class is not NULL then length instances of class class with name name are allocated. The flags for all objects is set to ACTIVE.

"list_free" deletes all objects by sending "delete" to them and frees the flags and objects lists.

GRAPE(list, "hardcopy")()

    LIST_OF_INST *list

Make a hardcopy of list: a new List_Of_Inst instance with new lists is created, the flags are copied and all objects are hardcopied. The new list is returned.

GRAPE(list, "softcopy")(copy_list)

    LIST_OF_INST *list
LIST_OF_INST *copy_list

Make a softcopy of list: like "hardcopy" but the objects are softcopied (only the used data is copied). If copy_list is not NULL then this instance is used to store the copy otherwise a new instance is created.

GRAPE(list, "reflect")(trfmat, orient)

    LIST_OF_INST *list
MATRIX44 trfmat
int orient

Create a new List_Of_Inst instance which is created almost like a "hardcopy" but instead of sending "hardcopy" to each object "reflect" is used. The new instance is transformed with trfmat, orient < 0 results in a change of the orientation of the new objects.

(int *)GRAPE(list, "merge")(list2)

    LIST_OF_INST *list
LIST_OF_INST *list2

Merge the two instances list and list2 by appending the lists of list2 to those of list. If anything fails "merge" returns NULL.