Functions | |
void | Set_Face_Pattern (const char *pattern) |
Allows a pattern to be applied to surfaces in the scene. More... | |
void | UnSet_Face_Pattern (void) |
Removes all settings established by a previous call to Set_Face_Pattern(). More... | |
void Set_Face_Pattern | ( | const char * | pattern | ) |
Allows a pattern to be applied to surfaces in the scene.
pattern | - Special constant ("solid", "##", "||", "==", "//", "\\", "::", "<><>", "[] []"). |
Declares, changes, or removes a value for the Face Pattern attribute. This attribute allows a pattern to be applied to the interior of a polygon (or of a circle or ellipse, or of the faces of a shell or mesh) when they are depicted on the screen. You might want to do this in order to differentiate one group of polygons from another, for example.
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.
Face Pattern only applies to areas generated by "inserted" geometry. The generic scene background also has a fill pattern of its own—see Set_Window_Pattern() .
The choices are the same as for Set_Window_Pattern() . In summary:
-------------------------------------------------------------------------------------- "solid" The default case---faces are painted uniformly with whatever the current Face Color is. (The face color may be set directly or by setting the "face color"--- see Set_Color() .) "##" A crosshatch pattern, filling the face. The lines will generally be painted with the current Face Contrast Color; the spaces will get the current Face Color. "||" Like the crosshatch pattern, but vertical bars instead. "==" Horizontal bars. "//" Slant-right. "\\" Slant-left. "::" Dotted (square grid). "<><>" Diamonds. "[] []" Checkerboard. --------------------------------------------------------------------------------------
The following might depend on the display device:
The precise spatial frequency of the pattern as it finally appears on the screen (for example, you can't depend on any particular interval with a Crosshatched pattern),
whether the pattern squeezes, stretches, and rotates itself appropriately as the view being represented changes, and
whether a requested Edge Pattern cleanly and completely takes precedence over the Face Pattern in the small area in which they overlap.
Some patterns can be implemented in hardware on software. Software implementations might be slower to display.
Faces may be turned off entirely with Set_Visibility() .
void UnSet_Face_Pattern | ( | void | ) |
Removes all settings established by a previous call to Set_Face_Pattern().
No additional details. See Set_Face_Pattern()