pfCircle2d(3pf) OpenGL Performer 3.2.2 libpf C++ Reference Pages
NAMEpfCircle2d - A two-dimensional parametric circle
FUNCTION SPECIFICATION
#include <Performer/pf/pfCircle2d.h>
static pfType* pfCircle2d::getClassType(void);
pfCircle2d::pfCircle2d();
void pfCircle2d::pfCircle2d(pfReal radius, pfVec2 *org);
void pfCircle2d::setRadius(pfReal radius);
void pfCircle2d::getRadius();
void pfCircle2d::evalPt(pfReal t, pfVec2 &pnt);
void pfCircle2d::evalTan(pfReal t, pfVec2 &tan);
void pfCircle2d::evalCurv(pfReal t, pfReal *curv);
void pfCircle2d::evalNorm(pfReal t, pfVec2 &norm);
void pfCircle2d::eval(pfReal t, pfVec2 &pnt, pfVec2& tan,
pfReal *curv, pfVec2 &norm);
PARENT CLASS FUNCTIONS
The OpenGL Performer class pfCircle2d is derived from the parent class
pfCurve2d, so each of these member functions of class pfCurve2d are also
directly usable with objects of class pfCircle2d. This is also true for
ancestor classes of class pfCurve2d.
void pfCurve2d::setBeginT(const pfReal beginT);
void pfCurve2d::setEndT(const pfReal endT);
pfReal pfCurve2d::getBeginT() const;
pfReal pfCurve2d::getEndT() const;
pfVec2 pfCurve2d::getBeginPt();
pfVec2 pfCurve2d::getEndPt();
pfVec2 pfCurve2d::getBeginTan();
pfVec2 pfCurve2d::getEndTan();
void pfCurve2d::setClosed(const pfLoop loopVal);
pfLoop pfCurve2d::getClosed();
void pfCurve2d::setClosedTol(const pfReal tol);
pfReal pfCurve2d::getClosedTol() const;
virtual void pfCurve2d::evalPt(pfReal t, pfVec2& pnt) = 0;
virtual void pfCurve2d::evalTan(pfReal t, pfVec2& pnt);
virtual void pfCurve2d::evalNorm(pfReal t, pfVec2& pnt);
virtual void pfCurve2d::evalCurv(pfReal t, pfReal* curv);
void pfCurve2d::eval(pfReal t, pfVec2 &pnt, pfVec2 &tan,
pfReal* curv, pfVec2 &norm)
Page 1
pfCircle2d(3pf) OpenGL Performer 3.2.2 libpf C++ Reference Pages
Since the class pfCurve2d is itself derived from the parent class pfRep,
objects of class pfCircle2d 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 pfCircle2d 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 pfCircle2d 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;
Page 2
pfCircle2d(3pf) OpenGL Performer 3.2.2 libpf C++ Reference Pages
Since the class pfNode is itself derived from the parent class pfObject,
objects of class pfCircle2d 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 pfCircle2d 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();
DESCRIPTIONpfCircle2d defines a two dimensional circle parametrized on t:
u(t) = radius * cos(t);
v(t) = radius * sin(t);
The default domain is [0, 2*pi].
The circle is subject to rotation and translation by the matrix
orientation and vector origin, which are members of the super class
pfRep. If orientation isn't set, evalTan, evalNorm and evalCurv are
functionally calculated. The normal is the vector from the origin to the
poiint on the circle. When orientation is set, evalTan, evalCurv are
calculated by finite difference method which is subject to numerical
Page 3
pfCircle2d(3pf) OpenGL Performer 3.2.2 libpf C++ Reference Pages
errors. The normal could be reversed depending on the direction of the
circle.
pfCircle2d::getClassType returns the pfType* for the class pfCircle2d.
The pfType* returned by pfCircle2d::getClassType is the same as the
pfType* returned by invoking the virtual function getType on any instance
of class pfCircle2d. 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.
pfCircle2d::pfCircle2d() creates an instance of an pfCircle2d with radius
set to 1. By default the parametric domain is defined as [0, 2*pi].
pfCircle2d::pfCircle2d(pfReal radius,pfVec2 *org) creates an instance
pfCircle2d with radius set to radius. Note that org sets the origin of
the superclass pfRep. Since this is a 2-D rep, the z component of the
origin in the pfRep is ignored. The default domain is [0, 2*pi].
pfCircle2d::setRadius sets the radius of the circle to radius.
pfCircle2d::getRadius returns the value of the circle's radius.
pfCircle2d::evalPt Computes the point on the circle. The result is put in
pnt. Notice that there is a translation by origin, which is the member of
the superclass pfRep.
pfCircle2d::evalTan Computes the derivatives (-r*sin(t), r*cos(t)) and
puts the result in tan.
pfCircle2d::evalCurv Computes the curvature and stores it in curv. The
curvature is the inverse of the radius and is cached as a member
curvature. If the orientation matrix is set, it is calculated by finite
difference method.
pfCircle2d::evalNom Computes the principal normal of the circle and
stores it in norm.
pfCircle2d::eval Evaluates the point, tangent, curvature and normal.
SEE ALSO
pfRep, pfGeode, pfCurve2d
Page 4