SoDrawStyle(3IV)

NAME
     SoDrawStyle (SoDStyle) - node that defines the style to use when
     rendering

INHERITS FROM
     SoBase > SoFieldContainer > SoNode > SoDrawStyle

SYNOPSIS
     #include <Inventor_c/nodes/SoDrawStyle.h>

     typedef SoDrawStyle  SoDStyle

     enum SoDrawStyleStyle {
          SO_D_STYLE_FILLED     Draw filled regions
          SO_D_STYLE_LINES      Draw only outlines (wire frame)
          SO_D_STYLE_POINTS     Draw points at vertices
          SO_D_STYLE_INVISIBLE  Do not draw anything at all
     }

          Fields from class SoDrawStyle:

     SoSFEnum            style
     SoSFFloat           pointSize
     SoSFFloat           lineWidth
     SoSFUShort          linePattern

          Functions from class SoDrawStyle:

     SoDrawStyle *       SoDStyleCreate()
     SoType              SoDStyleGetClassTypeId()

          Functions from class SoNode:

     void                SoDStyleSetOverride(SoDStyle *this, SbBool state)
     SbBool              SoDStyleIsOverride(const SoDStyle *this)
     SoNode *            SoDStyleCopy(const SoDStyle *this, SbBool
                              copyConnections = FALSE)
     SbBool              SoDStyleAffectsState(const SoDStyle *this)
     SoNode *            SoDStyleGetByName(const char *name)
     int                 SoDStyleGetByNameList(const char *name, SoNodeList
                              *list)

          Functions from class SoFieldContainer:

     void                SoDStyleSetToDflts(SoDStyle *this)
     SbBool              SoDStyleHasDfltVals(const SoDStyle *this)
     SbBool              SoDStyleFldsAreEq(const SoDStyle *this, const
                              SoFieldContainer *fc)
     void                SoDStyleCopyFieldVals(SoDStyle *this, const
                              SoFieldContainer *fc, SbBool copyConnections =
                              FALSE)
     SbBool              SoDStyleSet(SoDStyle *this, const char
                              *fieldDataString)
     void                SoDStyleGet(SoDStyle *this, SbString
                              *fieldDataString)
     int                 SoDStyleGetFields(const SoDStyle *this, SoFieldList
                              *resultList)
     SoField *           SoDStyleGetField(const SoDStyle *this, const char
                              *fieldName)
     SbBool              SoDStyleGetFieldName(const SoDStyle *this, const
                              SoField *field, SbName *fieldName)
     SbBool              SoDStyleIsNotifyEnabled(const SoDStyle *this)
     SbBool              SoDStyleEnableNotify(SoDStyle *this, SbBool flag)

          Functions from class SoBase:

     void                SoDStyleRef(SoDStyle *this)
     void                SoDStyleUnref(const SoDStyle *this)
     void                SoDStyleUnrefNoDelete(const SoDStyle *this)
     void                SoDStyleTouch(SoDStyle *this)
     SoType              SoDStyleGetTypeId(const SoDStyle *this)
     SbBool              SoDStyleIsOfType(const SoDStyle *this, SoType type)
     void                SoDStyleSetName(SoDStyle *this, const char *name)
     SbName              SoDStyleGetName(const SoDStyle *this)


DESCRIPTION
     This node defines the current drawing style for all subsequent shape
     nodes in a scene graph. SoDrawStyle specifies how primitives should be
     rendered. The drawing style has no effect on picking or callback
     primitive generation.

FIELDS
     SoSFEnum            style
          Drawing style.

     SoSFFloat           pointSize
          Radius of points (for POINTS style).

     SoSFFloat           lineWidth
          Width of lines (for LINES style).

     SoSFUShort          linePattern
          Stipple pattern for lines (for LINES style). Values can range from 0
          (invisible) to 0xffff (solid). This specifies how dashed or dotted
          lines will be drawn.


FUNCTIONS
     SoDrawStyle *       SoDStyleCreate()
          Creates a drawing style node with default settings.

     SoType              SoDStyleGetClassTypeId()
          Returns type identifier for this class.


ACTION BEHAVIOR
     SoGLRenderAction, SoCallbackAction
          Sets the current drawing style.


FILE FORMAT/DEFAULTS
     DrawStyle {
          style        FILLED
          pointSize    0
          lineWidth    0
          linePattern  0xffff
     }

SEE ALSO
     SoLightModel, SoPickStyle, SoShapeHints