pfNurbCurve3d(3pf) OpenGL Performer 3.2.2 libpf C++ Reference Pages
NAMEpfNurbCurve3d - Non-Uniform Rational BSpline curves in 3D
FUNCTION SPECIFICATION
#include <Performer/pf/pfNurbCurve3d.h>
static pfType* pfNurbCurve3d::getClassType(void);
pfNurbCurve3d::pfNurbCurve3d();
pfNurbCurve3d::pfNurbCurve3d(pfReal beginT,
pfReal endT);
void pfNurbCurve3d::setControlHull(int i, const pfVec4 &p);
void pfNurbCurve3d::setControlHull(int i, const pfVec3 &p);
void pfNurbCurve3d::setWeight(int i, pfReal w);
void pfNurbCurve3d::setKnot(int i, pfReal t);
void pfNurbCurve3d::setControlHullSize(int s);
pfVec3* pfNurbCurve3d::getControlHull(int i);
pfReal pfNurbCurve3d::getWeight(int i);
int pfNurbCurve3d::getControlHullSize();
int pfNurbCurve3d::getKnotCount();
pfReal pfNurbCurve3d::getKnot(int i);
int pfNurbCurve3d::getOrder();
void pfNurbCurve3d::removeControlHullPnt(int i);
void pfNurbCurve3d::removeKnot(int i);
void pfNurbCurve3d::reverse();
virtual void pfNurbCurve3d::evalPt(pfReal t, pfVec3 &pnt);
PARENT CLASS FUNCTIONS
The OpenGL Performer class pfNurbCurve3d is derived from the parent class
pfCurve3d, so each of these member functions of class pfCurve3d are also
directly usable with objects of class pfNurbCurve3d. This is also true
for ancestor classes of class pfCurve3d.
pfReal pfCurve3d::getBeginT()
Page 1
pfNurbCurve3d(3pf) OpenGL Performer 3.2.2 libpf C++ Reference Pages
pfReal pfCurve3d::getEndT()
pfVec3 pfCurve3d::getBeginPt();
pfVec3 pfCurve3d::getEndPt();
pfVec3 pfCurve3d::getBeginTan();
pfVec3 pfCurve3d::getEndTan();
void pfCurve3d::setClosed(int loopVal);
int pfCurve3d::getClosed();
void pfCurve3d::setClosedTol(pfReal tol);
pfReal pfCurve3d::getClosedTol();
virtual void pfCurve3d::evalPt(pfReal t, pfVec3& pnt) = 0;
virtual void pfCurve3d::evalTan(pfReal t, pfVec3& pnt);
virtual void pfCurve3d::evalNorm(pfReal t, pfVec3& pnt);
virtual void pfCurve3d::evalCurv(pfReal t, pfReal& curv);
void pfCurve3d::eval(pfReal t, pfVec3 &pnt, pfVec3 &tan,
pfReal &curv, pfVec3 &norm)
Since the class pfCurve3d is itself derived from the parent class pfRep,
objects of class pfNurbCurve3d can also be used with these functions
designed for objects 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);
Since the class pfRep is itself derived from the parent class pfGeode,
objects of class pfNurbCurve3d 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 pfNurbCurve3d 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);
Page 2
pfNurbCurve3d(3pf) OpenGL Performer 3.2.2 libpf C++ Reference Pages
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 pfNurbCurve3d 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);
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 pfNurbCurve3d 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();
Page 3
pfNurbCurve3d(3pf) OpenGL Performer 3.2.2 libpf C++ Reference Pages
int pfMemory::getRef();
int pfMemory::checkDelete();
int pfMemory::isFluxed();
void * pfMemory::getArena();
int pfMemory::getSize();
DESCRIPTIONpfNurbCurve3d defines a Non-Uniform Rational BSpline curve in three
dimensional space. A 3D Nurb curve is defined by an array of knot
values, an array of 3D control points, and an array of weights. The
order of the spline (degree+1) is equal to number_of_knot_values -
number_of_control_points. The knot multiplicity should be no bigger than
the order.
pfNurbCurve3d::getClassType returns the pfType* for the class
pfNurbCurve3d. The pfType* returned by pfNurbCurve3d::getClassType is
the same as the pfType* returned by invoking the virtual function getType
on any instance of class pfNurbCurve3d. 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.
pfNurbCurve3d::pfNurbCurve3d() creates an instance of an pfNurbCurve3d.
By default the parametric domain is defined as [0..1].
pfNurbCurve3d::pfNurbCurve3d(pfReal beginT,pfReal endT) creates an
instance of a pfNurbCurve3d and sets the parametric domain to [beginT,
endT].
pfNurbCurve3d::setControlHull(int i,const pfVec3 &p) Sets the i'th
component of controlHull to be p. The i'th weight of weight is set to be
1.0 if this weight hasn't been set yet (checking the array length of
weight). The order is updated by knot.len - controlHull.len. The beginT
and endT are updated by knot(order-1) and knot(knot.len - order),
respectively. Obviously there are redundant computations for the order,
beginT and endT. The reason is that the application doesn't know when the
user is done setting data.
pfNurbCurve3d::setControlHull(int i,const pfVec4 &p) sets the i'th
component of controlHull to be p[0..1], and the i'th weight of weight to
be p[2]. The order is updated by knot.len - controlHull.len. The beginT
and endT are updated by knot(order-1) and knot(knot.len - order),
respectively. Obviously there are redundant computations for the order,
beginT and endT. The reason that the application doesn't know when the
user is done setting data.
pfNurbCurve3d::setWeight sets the i'th component of weight to be w.
pfNurbCurve3d::setKnot sets the <arg i>'th knot to be t. Updates order,
beginT, and endT accordingly (See ::setControlHull).
Page 4
pfNurbCurve3d(3pf) OpenGL Performer 3.2.2 libpf C++ Reference Pages
pfNurbCurve3d::setControlHullSize sets the extension of the two arrays
controlHull and weight to be s.
pfNurbCurve3d::getControlHull returns the address of the i'th control
point (not including the weight).
pfNurbCurve3d::getWeight returns the value of the i'th weight.
pfNurbCurve3d::getControlHullSize Returns the length of array
controlHull.
pfNurbCurve3d::getKnotCount returns the number of knots.
pfNurbCurve3d::getKnot returns the i'th knot value.
pfNurbCurve3d::getOrder returns the order of the BSpline.
pfNurbCurve3d::removeControlHullPnt removes the i_th control hull point
and the i_th weight. The length of the control hull and the weights are
changed accordingly, but the space allocated for control hull and weights
is not modified.
pfNurbCurve3d::removeKnot removes the i_th knot. The knot length
decreases by one, but the total space allocated for knots remains the
same.
pfNurbCurve3d::reverse reverse the sense of the a NURB curve by reversing
the knot sequence and swapping the x/y points in the control hull.
virtual void pfNurbCurve3d::evalPt evaluates the NURB curve at domain
point t. The result is stored in pnt.
SEE ALSO
pfCurve3d, pfRep, pfGeode
Page 5
