The TextureTransform3D node defines a 3D transformation that is applied to texture coordinates (see TextureCoordinate). More...
#include <H3D/TextureTransform3D.h>
Public Member Functions | |
| TextureTransform3D (Inst< DisplayList > _displayList=0, Inst< SFNode > _metadata=0, Inst< SFVec3f > _center=0, Inst< SFRotation > _rotation=0, Inst< SFVec3f > _scale=0, Inst< SFVec3f > _translation=0) | |
| Constructor. | |
| virtual void | render () |
| Set the GL_TEXTURE matrix to the specified texture transform for the currently active texture unit. | |
 Public Member Functions inherited from H3D::X3DTextureTransformNode | |
| X3DTextureTransformNode (Inst< DisplayList > _displayList=0, Inst< SFNode > _metadata=0) | |
| Constructor. | |
| virtual void | renderForTextureUnits (unsigned int start_unit, unsigned int end_unit) |
| Render the texture transform for the texture units between and including start_unit and end_unit. | |
| virtual void | renderForTextureUnit (unsigned int texture_unit) |
| Render the texture transform for the specified texture unit. | |
| virtual void | preRender () |
| This function will be called by the X3DShapeNode before any rendering of geometry and before the call to the render function. More... | |
| virtual void | postRender () |
| This function will be called by the X3DShapeNode after the geometry has been rendered to restore the states to what it was before the call to preRender(). | |
| virtual string | defaultXMLContainerField () |
| Returns the default xml containerField attribute value. More... | |
| Public Member Functions inherited from H3D::X3DAppearanceChildNode | |
| X3DAppearanceChildNode (Inst< DisplayList > _displayList=0, Inst< SFNode > _metadata=0) | |
| Constructor. | |
| virtual GLbitfield | getAffectedGLAttribs () |
| Returns a bitmask of the OpenGL attrib bits that will be affected by this node. More... | |
| Public Member Functions inherited from H3D::X3DNode | |
| X3DNode (Inst< SFNode > _metadata=0) | |
| Constructor. | |
| X3DMetadataObject * | getMetadataByName (const string &_name) |
| Given a name, the first X3DMetadataObject in the metadata field that matches that name is returned. More... | |
| Public Member Functions inherited from H3D::Node | |
| Node () | |
| Constructor. | |
| virtual Node * | clone (bool deepCopy=true, DeepCopyMap *deepCopyMap=NULL) |
| Returns a new instance of this node type with the same state as this one. More... | |
| virtual | ~Node () |
| Destructor. | |
| X3DPrototypeInstance * | getProtoInstanceParent () |
| If this node is the root node in the proto body of a X3DPrototypeInstance then this will return that node. More... | |
| void | setProtoInstanceParent (X3DPrototypeInstance *p) |
| Set the X3DPrototypeInstance this node is the the root node if applicaple. | |
| virtual void | traverseSG (TraverseInfo &ti) |
| traverseSG is called once per scenegraph loop on the scene in order to traverse the scenegraph. More... | |
| virtual bool | lineIntersect (const Vec3f &from, const Vec3f &to, LineIntersectResult &result) |
| Detect intersection between a line segment and the Node. More... | |
| virtual void | closestPoint (const Vec3f &p, NodeIntersectResult &result) |
| Find closest point on Node to p. More... | |
| virtual bool | movingSphereIntersect (H3DFloat radius, const Vec3f &from, const Vec3f &to, NodeIntersectResult &result) |
| Detect collision between a moving sphere and the Node. More... | |
| virtual Field * | getField (const string &_name) const |
| return a pointer to the field specified by name within this instance | |
| int | addDestructCallback (void(*func)(Node *, void *), void *args) |
| Add a callback function to be run on destruction of node. More... | |
| int | removeDestructCallback (void(*func)(Node *, void *), void *args) |
| Add a callback function to be run on destruction of node. More... | |
| Public Member Functions inherited from H3D::H3DDisplayListObject | |
| H3DDisplayListObject (Inst< DisplayList > _displayList=0) | |
| Constructor. | |
Public Attributes | |
| H3DUniquePtr< SFVec3f > | center |
| The offset in texture coordinate space about which the rotation and scale fields are applied. More... | |
| H3DUniquePtr< SFRotation > | rotation |
| Specifies a rotation in radians of the texture coordinates about the center point after the scale has been applied. More... | |
| H3DUniquePtr< SFVec3f > | scale |
| Specifies a scaling factor in S and T of the texture coordinates about the center point. More... | |
| H3DUniquePtr< SFVec3f > | translation |
| Specifies a translation of the texture coordinates. More... | |
| Public Attributes inherited from H3D::X3DNode | |
| H3DUniquePtr< SFNode > | metadata |
| Meta data about the node. More... | |
| Public Attributes inherited from H3D::H3DDisplayListObject | |
| H3DUniquePtr< DisplayList > | displayList |
| The DisplayList instance handling the OpenGL caching of this object. | |
Static Public Attributes | |
| static H3DNodeDatabase | database |
| The H3DNodeDatabase for this node. | |
| Static Public Attributes inherited from H3D::X3DNode | |
| static H3DNodeDatabase | database |
| The H3DNodeDatabase for this node. | |
Additional Inherited Members | |
| Public Types inherited from H3D::Node | |
| typedef std::map< Node *, Node * > | DeepCopyMap |
| A map type used during a deep copy clone() to map from original nodes to cloned nodes. | |
| Static Public Member Functions inherited from H3D::Node | |
| static unsigned int | nrNodesAlive () |
| Returns the nr of nodes currently alive, i.e. nodes created but not destructed. | |
| static int | nrNodesCreated () |
| Returns the number of nodes created in total since the start of the program. | |
| Protected Member Functions inherited from H3D::Node | |
| void | cloneFieldValue (Field &_from, Field &_to, bool deepCopy, DeepCopyMap &deepCopyMap) |
| A helper function for the clone() method. More... | |
| Static Protected Member Functions inherited from H3D::Node | |
| static Node * | getClonedInstance (Node *original, bool deepCopy, DeepCopyMap &deepCopyMap) |
| A helper function for nodes that implement clone() More... | |
Detailed Description
The TextureTransform3D node defines a 3D transformation that is applied to texture coordinates (see TextureCoordinate).
This node affects the way textures coordinates are applied to the geometric surface. The transformation consists of (in order):
- a translation.
- a rotation about the centre point.
- a non-uniform scale about the centre point.
These parameters support changes to the size, orientation, and position of textures on shapes. Note that these operations appear reversed when viewed on the surface of geometry. For example, a scale value of (1 2 2) will scale the texture coordinates and have the net effect of shrinking the texture size by a factor of 2 (texture coordinates are twice as large and thus cause the texture to repeat) in the T and R dimensions and leave the S dimension unscaled. A translation of (0.5 0.0 0.0) translates the texture coordinates +.5 units along the S-axis and has the net effect of translating the texture 0.5 along the S-axis on the geometry's surface. A rotation of pi/2 of the texture coordinates results in a pi/2 rotation of the texture on the geometry.
The center field specifies a translation offset in texture coordinate space about which the rotation and scale fields are applied. The scale field specifies a scaling factor in S, T and R of the texture coordinates about the center point. The rotation field specifies a rotation in radians of the texture coordinates about the center point after the scale has been applied. A positive rotation value makes the texture coordinates rotate counterclockwise about the centre, thereby rotating the appearance of the texture itself clockwise. The translation field specifies a translation of the texture coordinates.
In matrix transformation notation, where Tc is the untransformed texture coordinate, Tc' is the transformed texture coordinate, C (center), T (translation), R (rotation), and S (scale) are the intermediate transformation matrices,
Note that this transformation order is the reverse of the Transform node transformation order since the texture coordinates, not the texture, are being transformed (i.e., the texture coordinate system).
- Internal routes:
Examples:
Member Data Documentation
◆ center
| H3DUniquePtr< SFVec3f > H3D::TextureTransform3D::center |
The offset in texture coordinate space about which the rotation and scale fields are applied.
Access type: inputOutput
Default value: Vec3f( 0, 0, 0 )
Referenced by render(), and TextureTransform3D().
◆ rotation
| H3DUniquePtr< SFRotation > H3D::TextureTransform3D::rotation |
Specifies a rotation in radians of the texture coordinates about the center point after the scale has been applied.
Access type: inputOutput
Default value: Rotation( 0, 0, 1, 0 )
Referenced by render(), and TextureTransform3D().
◆ scale
| H3DUniquePtr< SFVec3f > H3D::TextureTransform3D::scale |
Specifies a scaling factor in S and T of the texture coordinates about the center point.
Access type: inputOutput
Default value: Vec2f( 1, 1, 1 )
Referenced by render(), and TextureTransform3D().
◆ translation
| H3DUniquePtr< SFVec3f > H3D::TextureTransform3D::translation |
Specifies a translation of the texture coordinates.
Access type: inputOutput
Default value: Vec3f( 0, 0, 0 )
Referenced by render(), and TextureTransform3D().
The documentation for this class was generated from the following files:
