SoTexture2Transform(3IV)

NAME
     SoTexture2Transform (SoTex2Xf) - 2D texture transformation node

INHERITS FROM
     SoBase > SoFieldContainer > SoNode > SoTexture2Transform

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

     typedef SoTexture2Transform  SoTex2Xf

          Fields from class SoTexture2Transform:

     SoSFVec2f           translation
     SoSFFloat           rotation
     SoSFVec2f           scaleFactor
     SoSFVec2f           center

          Functions from class SoTexture2Transform:

     SoTexture2Transform *  SoTex2XfCreate()
     SoType                 SoTex2XfGetClassTypeId()

          Functions from class SoNode:

     void                SoTex2XfSetOverride(SoTex2Xf *this, SbBool state)
     SbBool              SoTex2XfIsOverride(const SoTex2Xf *this)
     SoNode *            SoTex2XfCopy(const SoTex2Xf *this, SbBool
                              copyConnections = FALSE)
     SbBool              SoTex2XfAffectsState(const SoTex2Xf *this)
     SoNode *            SoTex2XfGetByName(const char *name)
     int                 SoTex2XfGetByNameList(const char *name, SoNodeList
                              *list)

          Functions from class SoFieldContainer:

     void                SoTex2XfSetToDflts(SoTex2Xf *this)
     SbBool              SoTex2XfHasDfltVals(const SoTex2Xf *this)
     SbBool              SoTex2XfFldsAreEq(const SoTex2Xf *this, const
                              SoFieldContainer *fc)
     void                SoTex2XfCopyFieldVals(SoTex2Xf *this, const
                              SoFieldContainer *fc, SbBool copyConnections =
                              FALSE)
     SbBool              SoTex2XfSet(SoTex2Xf *this, const char
                              *fieldDataString)
     void                SoTex2XfGet(SoTex2Xf *this, SbString
                              *fieldDataString)
     int                 SoTex2XfGetFields(const SoTex2Xf *this, SoFieldList
                              *resultList)
     SoField *           SoTex2XfGetField(const SoTex2Xf *this, const char
                              *fieldName)
     SbBool              SoTex2XfGetFieldName(const SoTex2Xf *this, const
                              SoField *field, SbName *fieldName)
     SbBool              SoTex2XfIsNotifyEnabled(const SoTex2Xf *this)
     SbBool              SoTex2XfEnableNotify(SoTex2Xf *this, SbBool flag)

          Functions from class SoBase:

     void                SoTex2XfRef(SoTex2Xf *this)
     void                SoTex2XfUnref(const SoTex2Xf *this)
     void                SoTex2XfUnrefNoDelete(const SoTex2Xf *this)
     void                SoTex2XfTouch(SoTex2Xf *this)
     SoType              SoTex2XfGetTypeId(const SoTex2Xf *this)
     SbBool              SoTex2XfIsOfType(const SoTex2Xf *this, SoType type)
     void                SoTex2XfSetName(SoTex2Xf *this, const char *name)
     SbName              SoTex2XfGetName(const SoTex2Xf *this)


DESCRIPTION
     This node defines a 2D transformation applied to texture coordinates.
     This affects the way textures are applied to the surfaces of subsequent
     shapes. The transformation consists of (in order) a non-uniform scale
     about an arbitrary center point, a rotation about that same point, and a
     translation. (Note: while the transformations can be thought of as being
     applied in that order, the GL matrices are actually premultiplied in the
     opposite order. Therefore, the operations are listed in the reverse order
     throughout this reference page.) This allows a user to change the size
     and position of the textures on objects.

FIELDS
     SoSFVec2f           translation
          Translation in S and T.

     SoSFFloat           rotation
          Counter-clockwise rotation of the coordinate space, in radians. This
          results in a clockwise rotation of the texture on the object.

     SoSFVec2f           scaleFactor
          Scaling factors in S and T.

     SoSFVec2f           center
          Center point used for scaling and rotation.


FUNCTIONS
     SoTexture2Transform *  SoTex2XfCreate()
          Creates a texture transformation node with default settings.

     SoType                 SoTex2XfGetClassTypeId()
          Returns type identifier for this class.

ACTION BEHAVIOR
     SoGLRenderAction, SoCallbackAction
          Concatenates transformation with the current texture transformation.


FILE FORMAT/DEFAULTS
     Texture2Transform {
          translation  0 0
          rotation     0
          scaleFactor  1 1
          center       0 0
     }

SEE ALSO
     SoTexture2, SoTextureCoordinate2, SoTextureCoordinateFunction