Brief Index      Full Index      Events Index      I.M. Reference

Define_Named_Style

Functions

void Define_Named_Style (char const *style_name, char const *source_segment)
void UnDefine_Named_Style (char const *style_name)

Function Documentation

void Define_Named_Style ( char const *  style_name,
char const *  source_segment 
)

Defines a name that can be used to draw other segments in the style of the source.

Parameters:
style_name- Name of the custom style.
source_segment- Name of the style source.

DETAILS

Define_Named_Style allows users to designate a segment as a style source. The name created when the definition is created can be used by ::Style_Segment_Named or ::Style_Segment_Named_By_Key to draw the target segment in the style of the source. This means attributes set on the style source will affect the target segment. By convention, style segments contain no geometry or subsegments as these are not carried by the style anyway. Each segment can have at most one named style set on it at any time.

RESTRICTIONS

We advise against using options in your named style that can effect bounding like modelling matrices and mask transforms because they will result in unexpected behavior. We suggest you use attributes that do not effect boundings.

Additionally, any conditionals and callbacks set on named styles will result in unexpected or undesirable behavior.

See also:
Style_Segment, Named_Style_Segment, UnDefine_Named_Style, Show_Named_Style
void UnDefine_Named_Style ( char const *  style_name)

Removes a named style definintion established by a previous call to Define_Named_Style.

Parameters:
style_name- Name of the custom style.

DETAILS

No additional details. See Define_Named_Style()

Brief Index      Full Index      Events Index      I.M. Reference