pfHsplineCurve3d(3pf) OpenGL Performer 3.2.2 libpf C Reference Pages
NAME
pfGetHsplineCurve3dClassType, pfNewHsplineCurve3d,
pfGetHsplineCurve3dKnotCount, pfHsplineCurve3dPoint,
pfHsplineCurve3dTangent, pfHsplineCurve3dKnot, pfGetHsplineCurve3dPoint,
pfGetHsplineCurve3dTangent, pfGetHsplineCurve3dKnot,
pfHsplineCurve3dEvalPt - A three-dimensional Hermite curve
FUNCTION SPECIFICATION
#include <Performer/pf.h>
pfType * pfGetHsplineCurve3dClassType(void);
pfHsplineCurve3d * pfNewHsplineCurve3d(void *arena);
int -
pfGetHsplineCurve3dKnotCount(pfHsplineCurve3d *curve);
void pfHsplineCurve3dPoint(pfHsplineCurve3d *curve,
int i, pfVec3 &pt);
void pfHsplineCurve3dTangent(pfHsplineCurve3d *curve,
int i, pfVec3 &tng);
void pfHsplineCurve3dKnot(pfHsplineCurve3d *curve, int i,
pfReal t);
pfVec3* pfGetHsplineCurve3dPoint(pfHsplineCurve3d *curve,
int i);
pfVec3* pfGetHsplineCurve3dTangent(pfHsplineCurve3d *curve,
int i);
pfReal pfGetHsplineCurve3dKnot(pfHsplineCurve3d *curve,
int i);
void pfHsplineCurve3dEvalPt(pfHsplineCurve3d *curve,
pfReal t, pfVec3 &pt);
PARENT CLASS FUNCTIONS
The OpenGL Performer class pfHsplineCurve3d is derived from the parent
class pfCurve3d, so each of these member functions of class pfCurve3d are
also directly usable with objects of class pfHsplineCurve3d. Casting an
object of class pfHsplineCurve3d to an object of class pfCurve3d is taken
care of automatically. This is also true for casts to objects of
ancestor classes of class pfCurve3d.
pfReal pfGetCurve3dBeginT(pfCurve3d *curve);
pfReal pfGetCurve3dEndT(pfCurve3d *curve);
void pfCurve3dSetClosed(pfCurve3d *curve, int loopVal);
int pfGetCurve3dClosed(pfCurve3d *curve);
Page 1
pfHsplineCurve3d(3pf) OpenGL Performer 3.2.2 libpf C Reference Pages
void pfCurve3dClosedTol(pfCurve3d *curve, pfReal tol);
pfReal pfGetCurve3dClosedTol(pfCurve3d *curve);
void pfCurve3dEvalPt(pfCurve3d *curve, pfReal t, pfVec3 &pt);
void pfCurve3dEvalTan(pfCurve3d *curve, pfReal t, pfVec3 &pt);
void pfCurve3dEvalNorm(pfCurve3d *curve, pfReal t, pfVec3 &pt);
Since the class pfCurve3d is itself derived from the parent class pfRep,
objects of class pfHsplineCurve3d can also be used with these functions
designed for objects of class pfRep.
void pfRepOrigin(pfRep *rep, const pfVec3 origin);
void pfRepOrient(pfRep *rep, const pfMatrix mat);
void pfGetRepOrigin(pfRep *rep, pfVec3* origin);
void pfGetRepOrient(pfRep *rep, pfMatrix *mat);
Since the class pfRep is itself derived from the parent class pfGeode,
objects of class pfHsplineCurve3d can also be used with these functions
designed for objects of class pfGeode.
int pfAddGSet(pfGeode* geode, pfGeoSet* gset);
int pfRemoveGSet(pfGeode* geode, pfGeoSet* gset);
int pfInsertGSet(pfGeode* geode, int index, pfGeoSet* gset);
int pfReplaceGSet(pfGeode* geode, pfGeoSet* old, pfGeoSet* new);
pfGeoSet * pfGetGSet(const pfGeode* geode, int index);
int pfGetNumGSets(const pfGeode* geode);
Since the class pfGeode is itself derived from the parent class pfNode,
objects of class pfHsplineCurve3d can also be used with these functions
designed for objects of class pfNode.
pfGroup * pfGetParent(const pfNode *node, int i);
int pfGetNumParents(const pfNode *node);
void pfNodeBSphere(pfNode *node, pfSphere *bsph, int mode);
int pfGetNodeBSphere(pfNode *node, pfSphere *bsph);
pfNode* pfClone(pfNode *node, int mode);
pfNode* pfBufferClone(pfNode *node, int mode, pfBuffer *buf);
int pfFlatten(pfNode *node, int mode);
int pfNodeName(pfNode *node, const char *name);
const char * pfGetNodeName(const pfNode *node);
pfNode* pfFindNode(pfNode *node, const char *pathName,
pfType *type);
pfNode* pfLookupNode(const char *name, pfType* type);
int pfNodeIsectSegs(pfNode *node, pfSegSet *segSet,
pfHit **hits[]);
void pfNodeTravMask(pfNode *node, int which, uint mask,
int setMode, int bitOp);
uint pfGetNodeTravMask(const pfNode *node, int which);
Page 2
pfHsplineCurve3d(3pf) OpenGL Performer 3.2.2 libpf C Reference Pages
void pfNodeTravFuncs(pfNode* node, int which,
pfNodeTravFuncType pre, pfNodeTravFuncType post);
void pfGetNodeTravFuncs(const pfNode* node, int which,
pfNodeTravFuncType *pre, pfNodeTravFuncType *post);
void pfNodeTravData(pfNode *node, int which, void *data);
void * pfGetNodeTravData(const pfNode *node, int which);
void pfNodeTravMode(pfNode* node, int which, int mode,
int val);
int pfGetNodeTravMode(const pfNode* node, int which,
int mode);
Since the class pfNode is itself derived from the parent class pfObject,
objects of class pfHsplineCurve3d can also be used with these functions
designed for objects of class pfObject.
void pfUserDataSlot(pfObject *obj, int slot, void *data);
void pfUserData(pfObject *obj, void *data);
void* pfGetUserDataSlot(pfObject *obj, int slot);
void* pfGetUserData(pfObject *obj);
int pfGetNumUserData(pfObject *obj);
int pfGetNamedUserDataSlot(const char *name);
const char* pfGetUserDataSlotName(int slot);
int pfGetNumNamedUserDataSlots(void);
int pfDeleteGLHandle(pfObject *obj);
Since the class pfObject is itself derived from the parent class
pfMemory, objects of class pfHsplineCurve3d can also be used with these
functions designed for objects of class pfMemory.
pfType * pfGetType(const void *ptr);
int pfIsOfType(const void *ptr, pfType *type);
int pfIsExactType(const void *ptr, pfType *type);
const char * pfGetTypeName(const void *ptr);
int pfRef(void *ptr);
int pfUnref(void *ptr);
int pfUnrefDelete(void *ptr);
int pfUnrefGetRef(void *ptr);
int pfGetRef(const void *ptr);
int pfCopy(void *dst, void *src);
int pfDelete(void *ptr);
int pfIsFluxed(void *ptr);
int pfCompare(const void *ptr1, const void *ptr2);
void pfPrint(const void *ptr, uint which, uint verbose,
FILE *file);
void * pfGetArena(void *ptr);
DESCRIPTION
pfHsplineCurve3d defines a three dimensional Hermite curve, parameterized
by t. A Hermite curve is defined by a list of knot values knot, the
points of the curve at these knot values p, and the tangents of the curve
Page 3
pfHsplineCurve3d(3pf) OpenGL Performer 3.2.2 libpf C Reference Pages
at these knot values t. Notice that the name 't' is used for both the
parameterization and for the tangents. The domain of the Hermite curve
is [beginT, endT], both are members of its superclass pfCurve3d.
pfGetHsplineCurve3dClassType returns the pfType* for the class
pfHsplineCurve3d. The pfType* returned by pfGetHsplineCurve3dClassType
is the same as the pfType* returned by invoking pfGetType on any instance
of class pfHsplineCurve3d. 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 pfIsOfType 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.
pfNewHsplineCurve3d creates an instance of an pfHsplineCurve3d. Creates
an instance of pfHsplineCurve3d. The inherited member beginT is set to
tBegin and endT set to tEnd. The default values of beginT and endT are
0.0 and 1.0. The inherited member dt is set to endT - beginT) *
pfRep::functionTol as explained in pfCurve3d.
pfGetHsplineCurve3dKnotCount returns the number of knots.
pfHsplineCurve3dPoint Sets the i'th component p to be p.
pfHsplineCurve3dTangent Sets the i'th component of the t to be t.
pfHsplineCurve3dKnot Sets the i'th component of the knot to be t.
pfGetHsplineCurve3dPoint returns a pointer to the i'th component of array
p.
pfGetHsplineCurve3dTangent returns a pointer to the i'th component to
array t.
pfGetHsplineCurve3dKnot returns the i'th knot value.
pfHsplineCurve3dEvalPt Evaluates the curve at parameter t. The evaluated
point is stored in pnt.
SEE ALSO
pfRep, pfGeode, pfCurve3d
Page 4
