Functions | |
void | Set_Edge_Pattern (const char *pattern) |
void | QSet_Edge_Pattern (const char *segment, const char *pattern) |
void | UnSet_Edge_Pattern (void) |
void | QUnSet_Edge_Pattern (const char *segment) |
void Set_Edge_Pattern | ( | const char * | pattern | ) |
Applies a pattern of dots and dashes, or whatever, to the edges of polygons, circles, ellipses, shells, and meshes.
pattern | - Special constant (see below.) |
The possible values for pattern are
---------------------------------------------------------------- "---" A solid line. "- -" A simple dashed line. "...." A dotted line. "-.-." Dashes and dots alternating. "-..-.." Dashes and double-dot alternating. "-..." Dashes and triple-dot alternating. "---- ----" Long dashes. "center" Very-long-dash and short-dash alternating. "phantom" Very-long-dash and double-short-dash alternating. ----------------------------------------------------------------
The system tries to be forgiving about which way the patterns are spelled, repeated, or rotated---for example, "- - -", "- - - -", and "-" are all equivalent to "- -", and ".-..-." is equivalent to "-..".
Set applies the pattern to the currently open segment; QSet applies it to the named segment(s); UnSet removes any previous value from the currently open segment; and QUnSet removes the value from the named segment(s). On a Set or QSet, any previous value is discarded.
If the polygon (or circle, ellipse, etc.) at hand has been filled in with a solid color, it will be necessary to change the Edge Color to be something different than the Face Color before any possible edge pattern will become visible. The system does not bother to draw the edges in such a case.
The rendered length of the pattern, its continuity as well as its scalability will depend on the display device.
An almost identical effect to drawing edges can be obtained with a polyline on top of a plain polygon. The problem is that to ensure the "on top of" you have to fudge the coordinates pretty carefully.
Edges may be turned off entirely with Set_Visibility() .
void QSet_Edge_Pattern | ( | const char * | segment, | |
const char * | pattern | |||
) |
Similar to Set_Edge_Pattern(), but operates on a given segment rather than the currently open one.
segment | - Name of the segment(s) to be changed. | |
pattern | - Special constant (see below.) |
void UnSet_Edge_Pattern | ( | void | ) |
Removes all settings established by a previous call to Set_Edge_Pattern().
void QUnSet_Edge_Pattern | ( | const char * | segment | ) |
Removes all settings established by a previous call Set_Edge_Pattern(), but operates on a given segment rather than the currently open one.
segment | - Name of the segment(s) to be changed. |