STRUCTURE CREATION FLAGS

tstruct_create_flags

CALL SEQUENCE

void tstruct_create_flags (stmod, inads)

INPUT PARAMETERS

Tstruct_create_status	stmod;
Tname_set_ins	inads;

ARGUMENTS

stmod

Creation mode for structures created after calling tstruct_create_flags :

TSTRUCT_EMPTY_BEFORE_CREATE

Structures are emptied before inserting elements.

TSTRUCT_NOEMPTY_BEFORE_CREATE

Structures are not emptied, and new elements are inserted after the last element of each structure.

inads

Name set insertion flag :

TINSERT_NAME_SET

A name set equal to the structure identifier is inserted at the beginning of a structure created by PHIGURE.

TNO_INSERT_NAME_SET

No name set is inserted when structures are created by PHIGURE.

EFFECT

• 1) According to the value of stmod, structures will either be emptied and recreated, or new elements will be added to them at the end of the structure.

WARNING: Functions concerning axes and pie charts are an exception to this rule - these structures are routinely emptied before inserting elements.

"Empty structure" mode is the default mode when PHIGURE is opened by topen_phigure.

• 2) Depending on the value of the flag inads, an add name to set element may be inserted at the beginning of any structure created by PHIGURE. If it is inserted, the value of the name set will be strid when PHIGURE creates a structure whose identifier is strid. Refer to the section entitled "Structure visibility and detectability" to understand why it is useful to insert this element in a structure; refer to the GPHIGS reference manual for an explanation of name sets.

WARNING: the element name set is not inserted if stmod = TSTRUCT_NOEMPTY_BEFORE_CREATE.

Name set insertion is the default mode when PHIGURE is opened by topen_phigure.