SoTextureCoordinatePlane(3IV)

NAME
     SoTextureCoordinatePlane (SoTexPln) - node that specifies texture
     coordinates by projection from a plane

INHERITS FROM
     SoBase > SoFieldContainer > SoNode > SoTextureCoordinateFunction >
     SoTextureCoordinatePlane

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

     typedef SoTextureCoordinatePlane
                         SoTexPln

          Fields from class SoTextureCoordinatePlane:

     SoSFVec3f           directionS
     SoSFVec3f           directionT

          Functions from class SoTextureCoordinatePlane:

     SoTextureCoordinatePlane *  SoTexPlnCreate()
     SoType                      SoTexPlnGetClassTypeId()

          Functions from class SoNode:

     void                SoTexPlnSetOverride(SoTexPln *this, SbBool state)
     SbBool              SoTexPlnIsOverride(const SoTexPln *this)
     SoNode *            SoTexPlnCopy(const SoTexPln *this, SbBool
                              copyConnections = FALSE)
     SbBool              SoTexPlnAffectsState(const SoTexPln *this)
     SoNode *            SoTexPlnGetByName(const char *name)
     int                 SoTexPlnGetByNameList(const char *name, SoNodeList
                              *list)

          Functions from class SoFieldContainer:

     void                SoTexPlnSetToDflts(SoTexPln *this)
     SbBool              SoTexPlnHasDfltVals(const SoTexPln *this)
     SbBool              SoTexPlnFldsAreEq(const SoTexPln *this, const
                              SoFieldContainer *fc)
     void                SoTexPlnCopyFieldVals(SoTexPln *this, const
                              SoFieldContainer *fc, SbBool copyConnections =
                              FALSE)
     SbBool              SoTexPlnSet(SoTexPln *this, const char
                              *fieldDataString)
     void                SoTexPlnGet(SoTexPln *this, SbString
                              *fieldDataString)
     int                 SoTexPlnGetFields(const SoTexPln *this, SoFieldList
                              *resultList)
     SoField *           SoTexPlnGetField(const SoTexPln *this, const char
                              *fieldName)
     SbBool              SoTexPlnGetFieldName(const SoTexPln *this, const
                              SoField *field, SbName *fieldName)
     SbBool              SoTexPlnIsNotifyEnabled(const SoTexPln *this)
     SbBool              SoTexPlnEnableNotify(SoTexPln *this, SbBool flag)

          Functions from class SoBase:

     void                SoTexPlnRef(SoTexPln *this)
     void                SoTexPlnUnref(const SoTexPln *this)
     void                SoTexPlnUnrefNoDelete(const SoTexPln *this)
     void                SoTexPlnTouch(SoTexPln *this)
     SoType              SoTexPlnGetTypeId(const SoTexPln *this)
     SbBool              SoTexPlnIsOfType(const SoTexPln *this, SoType type)
     void                SoTexPlnSetName(SoTexPln *this, const char *name)
     SbName              SoTexPlnGetName(const SoTexPln *this)


DESCRIPTION
     This node creates texture coordinates for points on an object's surface
     by projecting them onto a plane. The directionS and directionT fields
     define the plane. The S coordinate is computed as the distance from the
     object-space origin along the vector specified in the directionS field.
     The T coordinate is computed similarly, using the directionT field.

     The length of the direction vector is also taken into account. For
     example, assume directionS is (0.5, 0, 0) and directionT is (0, 1, 0).
     The square defined by the (x, y, z) vertices:

          (-1, -1, 0) (1, -1, 0) (1, 1, 0) (-1, 1, 0)

     will be assigned the (s, t) texture coordinates:

          (-2, -1) (2, -1) (2, 1) (-2, 1)



FIELDS
     SoSFVec3f           directionS
     SoSFVec3f           directionT
          Directions of projection for S and T coordinates.


FUNCTIONS
     SoTextureCoordinatePlane *  SoTexPlnCreate()
          Creates a texture function node with default settings.

     SoType                      SoTexPlnGetClassTypeId()
          Returns type identifier for this class.

ACTION BEHAVIOR
     SoGLRenderAction, SoCallbackAction, SoRayPickAction
          Sets the current texture function in the state.


FILE FORMAT/DEFAULTS
     TextureCoordinatePlane {
          directionS  1 0 0
          directionT  0 1 0
     }

SEE ALSO
     SoTexture2, SoTexture2Transform, SoTextureCoordinateDefault,
     SoTextureCoordinateEnvironment