Functions
Set_Edge_Pattern

Functions

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. More...
 
void UnSet_Edge_Pattern (void)
 Removes all settings established by a previous call to Set_Edge_Pattern(). More...
 

Detailed Description

Function Documentation

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.

Parameters
pattern- Special constant (see below.)

DETAILS

Declares, changes, or removes a value for the edge pattern attribute. This allows a pattern to be applied to the geometric edges of the filled shapes on the screen. Edge pattern is one of the ways of highlighting one collection of edges against the others in your scene.

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.

NOTES

The line join treatments for HOOPS line styles can be applied to edge patterns; however, the end cap treatments do not apply.

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() .

RESTRICTIONS

See also
Set_Edge_Pattern_Explicit, Set_Edge_Weight, Set_Color, Set_Line_Pattern, Set_Face_Pattern, Insert_Polygon, Insert_Shell, Insert_Mesh, Insert_Circle, Insert_Ellipse, Set_Visibility.
void UnSet_Edge_Pattern ( void  )

Removes all settings established by a previous call to Set_Edge_Pattern().

DETAILS

No additional details. See Set_Edge_Pattern()