Brief Index      Full Index      I.M. Reference

Create_Segment


Functions

void Create_Segment (const char *segment)
HC_KEY KCreate_Segment (const char *segment)

Function Documentation

void Create_Segment ( const char *  segment  ) 

Brings a segment into existence without opening it.

Parameters:
segment - Name of the segment.

DETAILS

Open_Segment() is the normal method for bringing segments into existence---it both creates the segment (if it does not already exist) and readies it to receive geometry, subsegments, etc.

Once in a while, you need to create a segment in advance of being ready to insert information into it. Include_Segment() and Style_Segment() , for example, require that the specified segment exist at the time of the call. Create_Segment() is an easy way to make the segment exist even if you're not ready to put something into it.

Create_Segment() is provided as a utility routine. It is absolutely identical to an Open_Segment() followed immediately by a Close_Segment() . You can open the segment again later, by name of course. Or if it's more convenient, by the key returned from KCreate_Segment() .

NOTES

RESTRICTIONS

See also:
Open_Segment, Open_Segment_By_Key, Close_Segment, Include_Segment, Style_Segment, Open_Geometry.

HC_KEY KCreate_Segment ( const char *  segment  ) 

Similar to Create_Segment(), but returns an HC_KEY to the object.

Parameters:
segment - Name of the segment.
Returns:
key

DETAILS

No additional details. See Create_Segment()

Main Index
Brief Index      Full Index      I.M. Functions