Set_Face_Pattern

Functions
void	Set_Face_Pattern (const char *pattern)
void	QSet_Face_Pattern (const char *segment, const char *pattern)
void	UnSet_Face_Pattern (void)
void	QUnSet_Face_Pattern (const char *segment)

---

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 QSet_Face_Pattern	(	const char *	segment,
		const char *	pattern
	)

Similar to Set_Face_Pattern(), but operates on a given segment rather than the currently open one.

Parameters:

	segment	- Name of the segment(s) to be changed.
	pattern	- Special constant ("solid", "##", "||", "==", "//", "\\", "::", "<><>", "[] []").

DETAILS

No additional details. See Set_Face_Pattern()

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

void QUnSet_Face_Pattern

(

const char *

segment

)

Removes all settings established by a previous call Set_Face_Pattern(), but operates on a given segment rather than the currently open one.

Parameters:

segment

- Name of the segment(s) to be changed.

DETAILS

No additional details. See Set_Face_Pattern()