SoFont(3IV)

NAME
     SoFont (SoFont) - node that defines font type and size for text

INHERITS FROM
     SoBase > SoFieldContainer > SoNode > SoFont

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

          Fields from class SoFont:

     SoSFName            name
     SoSFFloat           size

          Functions from class SoFont:

     SoFont *            SoFontCreate()
     SoType              SoFontGetClassTypeId()

          Functions from class SoNode:

     void                SoFontSetOverride(SoFont *this, SbBool state)
     SbBool              SoFontIsOverride(const SoFont *this)
     SoNode *            SoFontCopy(const SoFont *this, SbBool copyConnections
                              = FALSE)
     SbBool              SoFontAffectsState(const SoFont *this)
     SoNode *            SoFontGetByName(const char *name)
     int                 SoFontGetByNameList(const char *name, SoNodeList
                              *list)

          Functions from class SoFieldContainer:

     void                SoFontSetToDflts(SoFont *this)
     SbBool              SoFontHasDfltVals(const SoFont *this)
     SbBool              SoFontFldsAreEq(const SoFont *this, const
                              SoFieldContainer *fc)
     void                SoFontCopyFieldVals(SoFont *this, const
                              SoFieldContainer *fc, SbBool copyConnections =
                              FALSE)
     SbBool              SoFontSet(SoFont *this, const char *fieldDataString)
     void                SoFontGet(SoFont *this, SbString *fieldDataString)
     int                 SoFontGetFields(const SoFont *this, SoFieldList
                              *resultList)
     SoField *           SoFontGetField(const SoFont *this, const char
                              *fieldName)
     SbBool              SoFontGetFieldName(const SoFont *this, const SoField
                              *field, SbName *fieldName)
     SbBool              SoFontIsNotifyEnabled(const SoFont *this)
     SbBool              SoFontEnableNotify(SoFont *this, SbBool flag)

          Functions from class SoBase:
     void                SoFontRef(SoFont *this)
     void                SoFontUnref(const SoFont *this)
     void                SoFontUnrefNoDelete(const SoFont *this)
     void                SoFontTouch(SoFont *this)
     SoType              SoFontGetTypeId(const SoFont *this)
     SbBool              SoFontIsOfType(const SoFont *this, SoType type)
     void                SoFontSetName(SoFont *this, const char *name)
     SbName              SoFontGetName(const SoFont *this)


DESCRIPTION
     This node defines the current font type and point size for all subsequent
     text shapes in the scene graph. Fonts are specified with PostScript
     names, except for the default font. The default font is called
     "defaultFont" and is the standard SGI graphics font for 2D text. "Utopia"
     is the standard Inventor font for 3D text.

FIELDS
     SoSFName            name
          This field defines the font name as a PostScript name. For example,
          Times Roman would be specified as Times-Roman. Multiple fonts can be
          specified by separating the font names with semicolons. When
          multiple fonts are specified, the first font in the list that
          contains a given character is used to render that character.

     SoSFFloat           size
          This field defines the font size. The value is in points for 2D text
          and is in the current units for 3D text.


FUNCTIONS
     SoFont *            SoFontCreate()
          Creates a font node with default settings.

     SoType              SoFontGetClassTypeId()
          Returns type identifier for this class.


ACTION BEHAVIOR
     SoGLRenderAction, SoCallbackAction, SoGetBoundingBoxAction,
     SoRayPickAction
          Sets the font name and size in the current traversal state.


FILE FORMAT/DEFAULTS
     Font {
          name  "defaultFont"
          size  10
     }

SEE ALSO
     SoText2, SoText3