Brief Index      Full Index      Events Index      I.M. Reference

Set_Face_Pattern


Functions

void Set_Face_Pattern (const char *pattern)
void UnSet_Face_Pattern (void)

Function Documentation

void Set_Face_Pattern ( const char *  pattern  ) 

Allows a pattern to be applied to surfaces in the scene.

Parameters:
pattern - Special constant ("solid", "##", "||", "==", "//", "\\", "::", "<><>", "[] []").

DETAILS

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.

NOTES

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

RESTRICTIONS

See also:
Set_Color, Set_Edge_Pattern, Set_Line_Pattern, Set_Window_Pattern, Set_Rendering_Options, Insert_Polygon, Insert_Circle, Insert_Ellipse, Insert_Shell, Insert_Mesh, Set_Visibility.

void UnSet_Face_Pattern ( void   ) 

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

DETAILS

No additional details. See Set_Face_Pattern()

Brief Index      Full Index      Events Index      I.M. Reference