Functions | |
void | Define_Named_Style (char const *style_name, char const *source_segment) |
void | UnDefine_Named_Style (char const *style_name) |
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.
style_name | - Name of the custom style. |
source_segment | - Name of the style source. |
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.
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.
void UnDefine_Named_Style | ( | char const * | style_name | ) |
Removes a named style definintion established by a previous call to Define_Named_Style.
style_name | - Name of the custom style. |
No additional details. See Define_Named_Style()