H3D API  2.4.1
Public Member Functions | List of all members
H3D::H3DCoordinateDeformerNode Class Referenceabstract

The H3DCoordinateDeformerNode is the abstract base class for all nodes specifying deformation of coordinates based on contact of haptics devices. More...

#include <H3D/H3DCoordinateDeformerNode.h>

Inheritance diagram for H3D::H3DCoordinateDeformerNode:
Inheritance graph

Public Member Functions

 H3DCoordinateDeformerNode ()
 Constructor.

 
virtual void deformPoints (const vector< bool > &is_touched, const vector< Vec3f > &touch_point, const vector< Vec3f > &touch_normal, const vector< Vec3f > &touch_force, const vector< Vec3f > &penetration_points, const vector< Vec3f > &orig_points, const vector< Vec3f > &resting_points, const vector< Vec3f > &deformed_points, vector< Vec3f > &new_resting_points, vector< Vec3f > &new_deformed_points)=0
 The deformPoints method determines the deformation of coordinates based on the interaction of a haptics device. More...
 
virtual string defaultXMLContainerField ()
 Returns the default xml containerField attribute value. More...
 
- Public Member Functions inherited from H3D::Node
 Node ()
 Constructor.
 
virtual Nodeclone (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.
 
X3DPrototypeInstancegetProtoInstanceParent ()
 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 render ()
 the render() function is used for the depth-first rendering traversal of the scene-graph. More...
 
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 FieldgetField (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...
 

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 NodegetClonedInstance (Node *original, bool deepCopy, DeepCopyMap &deepCopyMap)
 A helper function for nodes that implement clone() More...
 

Detailed Description

The H3DCoordinateDeformerNode is the abstract base class for all nodes specifying deformation of coordinates based on contact of haptics devices.

All subclasses are required to implement the deformPoints method to specify how the coordinates should be deformed.

For usages of the node type, see DeformableShape.

Member Function Documentation

◆ defaultXMLContainerField()

virtual string H3D::H3DCoordinateDeformerNode::defaultXMLContainerField ( )
inlinevirtual

Returns the default xml containerField attribute value.

For this node it is "deformer".

Reimplemented from H3D::Node.

◆ deformPoints()

virtual void H3D::H3DCoordinateDeformerNode::deformPoints ( const vector< bool > &  is_touched,
const vector< Vec3f > &  touch_point,
const vector< Vec3f > &  touch_normal,
const vector< Vec3f > &  touch_force,
const vector< Vec3f > &  penetration_points,
const vector< Vec3f > &  orig_points,
const vector< Vec3f > &  resting_points,
const vector< Vec3f > &  deformed_points,
vector< Vec3f > &  new_resting_points,
vector< Vec3f > &  new_deformed_points 
)
pure virtual

The deformPoints method determines the deformation of coordinates based on the interaction of a haptics device.

The is_touched, touch_points, touch_normal and touch_force parameters all are vectors of the same size, where the first value in the vector is the value for haptics device 0, the second for haptics device 1, and so on.

Parameters
is_touchedSpecifies if a haptics device is in contact or not.
touch_pointThe contact point in local coordinates for each device.
touch_normalThe normal at the contact point for each device.
touch_forceThe force with which the surface is pressed for each device.
penetration_pointsThe weightedProxyPosition of each device.
orig_pointsThe original points before any deformation.
resting_pointsThe resting coordinates (see DeformableShape)
deformed_pointsThe deformed coordinates (see DeformableShape)
new_resting_pointsOutput parameter that specifies the new resting coordinates after the deformation. If no changes are made to the resting coordinates, return an empty vector.
new_deformed_pointsOutput parameter that specifies the new deformed coordinates after the current deformation. If no changes are made to the deformed coordinates, return an empty vector.

Implemented in H3D::CoordinateDeformer.

Referenced by H3D::DeformableShape::traverseSG().


The documentation for this class was generated from the following file: