Memory Methods on Bnd_Curve

 

   (BND_CURVE * ) GRAPE(Bnd_Curve, "new-instance")(name)

CLASS * Bnd_Curve
char * name

Create a Bnd_Curve instance with name name. Only the structure itself is allocated and the flag is set to ACTIVE. The vertex and neighbour lists have to be allocated separately using "list-alloc".

   GRAPE(bnd_curve, "set-geom")(triang)

BND_CURVE * bnd_curve
TRIANG2D * triang

This method assigns a surface to bnd_curve. The geom pointer should only be accessed by this method which also takes care of the refcounting: an existing geom instance is deleted first, then the new one is ASSIGNed.

   GRAPE(bnd_curve, "free")()

BND_CURVE * bnd_curve

Free a Bnd_Curve instance, see section 5.4.4.1.

     

BND_CURVE * bnd_curve
int length

"list-alloc" allocates memory for length points for the vertex and neighbour lists, "list-free" frees these lists, see section 5.4.4.2.

   GRAPE(bnd_curve, "delete-restrict")()

BND_CURVE * bnd_curve

Remove a restriction and free the associated memory.

     

BND_CURVE * bnd_curve

"list-shrink-send" frees unused space of the bnd_curve lists by calling "list-alloc" with number_of_points points as argument. It is called by "optimize-mem-send" which only is provided for compatibility.

     

BND_CURVE * bnd_curve, * copy

Create a copy of bnd_curve which its own vertex lists (all data is copied) and return the pointer to it. The geom instance is only ASSIGNed to the copy, therefore the copy is associated with the same Triang2d instance as the original bnd_curve.

"hardcopy" and "softcopy" differ in two respects. While "hardcopy" creates an identical copy of bnd_curve, "softcopy" only copies the memory needed, i.e. upto number_of_points. If copy is NULL, "softcopy" creates a new Bnd_Curve instance to store the copy, otherwise copy is used.