pfDisCurve3d(3pf) OpenGL Performer 3.2.2 libpf C++ Reference Pages
NAMEpfDisCurve3d - Base class for all discrete 3D parametric curves.
FUNCTION SPECIFICATION
#include <Performer/pf/pfDisCurve3d.h>
static pfType* pfDisCurve3d::getClassType(void);
pfDisCurve3d::pfDisCurve3d();
pfDisCurve3d::pfDisCurve3d(int nPoints, pfReal *points);
pfVec3 pfDisCurve3d::getBeginPt();
pfVec3 pfDisCurve3d::getEndPt();
void pfDisCurve3d::setClosed(int loopVal);
int pfDisCurve3d::getClosed();
void pfDisCurve3d::setPoint(int i, const pfVec3& pnt);
void pfDisCurve3d::getPoint(int i, pfVec3& pnt);
void pfDisCurve3d::getPointCount();
pfVec3 pfDisCurve3d::getTangent(int i);
pfVec3 pfDisCurve3d::getNormal(int i);
pfVec3 pfDisCurve3d::getCurvature(int i);
void pfDisCurve3d::computeTangents();
void pfDisCurve3d::computeNormals();
void pfDisCurve3d::computeCurvatures();
void pfDisCurve3d::computeDerivatives();
PARENT CLASS FUNCTIONS
The OpenGL Performer class pfDisCurve3d is derived from the parent class
pfRep, so each of these member functions of class pfRep are also directly
usable with objects of class pfDisCurve3d. This is also true for
ancestor classes of class pfRep.
void pfRep::setOrigin(const pfVec3 *origin);
void pfRep::setOrient(const pfMatrix *mat);
void pfRep::getOrigin(pfVec3& origin);
void pfRep::getOrient(pfMatrix& matrix);
Page 1
pfDisCurve3d(3pf) OpenGL Performer 3.2.2 libpf C++ Reference Pages
Since the class pfRep is itself derived from the parent class pfGeode,
objects of class pfDisCurve3d can also be used with these functions
designed for objects of class pfGeode.
int pfGeode::addGSet(pfGeoSet* gset);
int pfGeode::removeGSet(pfGeoSet* gset);
int pfGeode::insertGSet(int index, pfGeoSet* gset);
int pfGeode::replaceGSet(pfGeoSet* old, pfGeoSet* new);
pfGeoSet * pfGeode::getGSet(int index);
int pfGeode::getNumGSets(void);
Since the class pfGeode is itself derived from the parent class pfNode,
objects of class pfDisCurve3d can also be used with these functions
designed for objects of class pfNode.
pfGroup * pfNode::getParent(int i);
int pfNode::getNumParents(void);
void pfNode::setBound(pfSphere *bsph, int mode);
int pfNode::getBound(pfSphere *bsph);
pfNode* pfNode::clone(int mode);
pfNode* pfNode::bufferClone(int mode, pfBuffer *buf);
int pfNode::flatten(int mode);
int pfNode::setName(const char *name);
const char * pfNode::getName(void);
pfNode* pfNode::find(const char *pathName, pfType *type);
pfNode* pfNode::lookup(const char *name, pfType* type);
int pfNode::isect(pfSegSet *segSet, pfHit **hits[]);
void pfNode::setTravMask(int which, uint mask, int setMode,
int bitOp);
uint pfNode::getTravMask(int which);
void pfNode::setTravFuncs(int which, pfNodeTravFuncType pre,
pfNodeTravFuncType post);
void pfNode::getTravFuncs(int which, pfNodeTravFuncType *pre,
pfNodeTravFuncType *post);
void pfNode::setTravData(int which, void *data);
void * pfNode::getTravData(int which);
void pfNode::setTravMode(int which, int mode, int val);
int pfNode::getTravMode(int which, int mode) const;
Since the class pfNode is itself derived from the parent class pfObject,
objects of class pfDisCurve3d can also be used with these functions
designed for objects of class pfObject.
void* pfObject::operator new(size_t);
void* pfObject::operator new(size_t, pfFluxMemory *fmem);
void pfObject::setUserData(void *data);
void pfObject::setUserData(int slot, void *data);
void* pfObject::getUserData(pfObject *obj);
Page 2
pfDisCurve3d(3pf) OpenGL Performer 3.2.2 libpf C++ Reference Pages
void* pfObject::getUserData(pfObject *obj, int slot);
int pfObject::getNumUserData();
Since the class pfObject is itself derived from the parent class
pfMemory, objects of class pfDisCurve3d can also be used with these
functions designed for objects of class pfMemory.
void* pfMemory::getData(const void *ptr);
pfType * pfMemory::getType();
int pfMemory::isOfType(pfType *type);
int pfMemory::isExactType(pfType *type);
const char * pfMemory::getTypeName();
int pfMemory::copy(pfMemory *src);
int pfMemory::compare(const pfMemory *mem);
void pfMemory::print(uint which, uint verbose, char *prefix,
FILE *file);
int pfMemory::getArena(void *ptr);
void* pfMemory::getArena();
int pfMemory::ref();
int pfMemory::unref();
int pfMemory::unrefDelete();
int pfMemory::unrefGetRef();
int pfMemory::getRef();
int pfMemory::checkDelete();
int pfMemory::isFluxed();
void * pfMemory::getArena();
int pfMemory::getSize();
DESCRIPTION
A discrete 3D curve is an array of 3D points. The tangent at each point
is defined as the first order derivative of the curve with respect to arc
length, and is approximated by a finite central difference (forward or
backward difference is used for the first and the last point):
0.5 * ((p[i+1]-p[i])/||p[i+1]-p[i]|| + (p[i]-p[i-1])/||p[i]-p[i-1]|| )
where ||p[i]-p[i-1]|| is the Euclidean distance. Notice that the tangent
is not normalized.
The principal normal at each point is defined as the second order
derivative of the curve with respect to the arc length, and is also
approximated by finite central difference over tangents. Notice that the
normals are not normalized.
The curvature at each point is defined as the length of the principal
normal.
Each discrete 3D curve keeps a flag that indicates whether the curve is
closed or not. If the curve is closed, then it is thought of as having a
line that connects the last point to the first point. This affects the
derivative (tangent, normal, etc) computations at the first and last
point.
Page 3
pfDisCurve3d(3pf) OpenGL Performer 3.2.2 libpf C++ Reference Pages
pfDisCurve3d::getClassType returns the pfType* for the class
pfDisCurve3d. The pfType* returned by pfDisCurve3d::getClassType is the
same as the pfType* returned by invoking the virtual function getType on
any instance of class pfDisCurve3d. Because OpenGL Performer allows
subclassing of built-in types, when decisions are made based on the type
of an object, it is usually better to use the member function isOfType
to test if an object is of a type derived from a Performer type rather
than to test for strict equality of the pfType*'s.
pfDisCurve3d::pfDisCurve3d() creates an instance of an pfDisCurve3d. By
default the parametric domain is defined as [0..1].
pfDisCurve3d::pfDisCurve3d(int nPoints,pfReal *points) creates an
instance of a pfDisCurve3d while copying the coordinates from points. The
coordinates of the point i should be stored in points[3*i], points[3*i+1]
and points[3*i+2].
pfDisCurve3d::getBeginPt returns the first point. pfDisCurve3d::getEndPt
returns the last point.
pfDisCurve3d::setClosed sets the flag that indicates whether this curve
is closed or not.
pfDisCurve3d::getClosed returns a flag indicating whether this curve is
closed or not.
pfDisCurve3d::set the coordinates of the points points. The coordinates
of the point i should be stored in points[3*i], points[3*i+1] and
points[3*i+2].
pfDisCurve3d::getPointCount returns the number of points.
pfDisCurve3d::setPoint sets the i'th point.
pfDisCurve3d::getPoint returns the i'th point
pfDisCurve3d::getCurvature returns the ith curvature.
pfDisCurve3d::computeNormals computes all the normals. The results can be
accessed using ::getNormal. The user needs to call ::computeTangents
before calling this function.
pfDisCurve3d::computeCurvatures computes all the curvatures. The results
can be accessed using ::getCurvature. The user needs to call
::computeCurvatures before calling this function.
pfDisCurve3d::computeDerivatives computes all the tangents, normals and
curvatures. The results can be accessed using ::getTangent, ::getNormal
and ::getCurvature.
pfDisCurve3d::getTangent returns the i'th tangent.
Page 4
pfDisCurve3d(3pf) OpenGL Performer 3.2.2 libpf C++ Reference Pages
pfDisCurve3d::getNormal returns the i'th normal.
pfDisCurve3d::getCurvature returns the i'th curvature.
SEE ALSO
pfRep, pfGeode
Page 5