oracular (3) SoTexture2Transform.3iv.gz

Provided by: inventor-doc_2.1.6+ds-2_all bug

NAME
       SoTexture2Transform — 2D texture transformation node


INHERITS FROM
       SoBase > SoFieldContainer > SoNode > SoTexture2Transform


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

          Fields from class SoTexture2Transform:

     SoSFVec2f           translation
     SoSFFloat           rotation
     SoSFVec2f           scaleFactor
     SoSFVec2f           center

          Methods from class SoTexture2Transform:

                         SoTexture2Transform()
     static SoType       getClassTypeId()

          Methods from class SoNode:

     void                setOverride(SbBool state)
     SbBool              isOverride() const
     SoNode *            copy(SbBool copyConnections = FALSE) const
     virtual SbBool      affectsState() const
     static SoNode *     getByName(const SbName &name)
     static int          getByName(const SbName &name, SoNodeList &list)

          Methods from class SoFieldContainer:

     void                setToDefaults()
     SbBool              hasDefaultValues() const
     SbBool              fieldsAreEqual(const SoFieldContainer *fc) const
     void                copyFieldValues(const SoFieldContainer *fc, SbBool copyConnections = FALSE)
     SbBool              set(const char *fieldDataString)
     void                get(SbString &fieldDataString)
     virtual int         getFields(SoFieldList &resultList) const
     virtual SoField *   getField(const SbName &fieldName) const
     SbBool              getFieldName(const SoField *field, SbName &fieldName) const
     SbBool              isNotifyEnabled() const
     SbBool              enableNotify(SbBool flag)

          Methods from class SoBase:

     void                ref()
     void                unref() const
     void                unrefNoDelete() const
     void                touch()
     virtual SoType      getTypeId() const
     SbBool              isOfType(SoType type) const
     virtual void        setName(const SbName &name)
     virtual SbName      getName() const


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.


METHODS
                         SoTexture2Transform()
          Creates a texture transformation node with default settings.

     static SoType       getClassTypeId()
          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

                                                                                      SoTexture2Transform(3IV)()