pfCompositeCurve3d(3pf) OpenGL Performer 3.2.2 libpf C Reference Pages
NAME
pfGetCompositeCurve3dClassType, pfNewCompositeCurve3d,
pfCompositeCurve3dSet, pfGetCompositeCurve3dSurface,
pfGetCompositeCurve3dCurve - A composite curve
FUNCTION SPECIFICATION
#include <Performer/pf.h>
pfType * pfGetCompositeCurve3dClassType(void);
pfCompositeCurve3d * pfNewCompositeCurve3d(void *arena);
void pfCompositeCurve3dSet(pfCompositeCurve3d *c,
pfParaSurface *sur, pfCurve2d *cur);
pfParaSurface * -
pfGetCompositeCurve3dSurface(pfCompositeCurve3d *c);
pfCurve2d * pfGetCompositeCurve3dCurve(pfCompositeCurve3d *c);
PARENT CLASS FUNCTIONS
The OpenGL Performer class pfCompositeCurve3d is derived from the parent
class pfCurve3d, so each of these member functions of class pfCurve3d are
also directly usable with objects of class pfCompositeCurve3d. Casting
an object of class pfCompositeCurve3d 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);
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 pfCompositeCurve3d 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 pfCompositeCurve3d can also be used with these functions
designed for objects of class pfGeode.
Page 1
pfCompositeCurve3d(3pf) OpenGL Performer 3.2.2 libpf C Reference Pages
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 pfCompositeCurve3d 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);
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 pfCompositeCurve3d 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);
Page 2
pfCompositeCurve3d(3pf) OpenGL Performer 3.2.2 libpf C Reference Pages
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 pfCompositeCurve3d 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
pfCompositeCurve3d defines a 3D curve that consists of a parametric
surface in object space and a 2D curve in the domain space of the
surface. If we denote (x,y,z) = (x(u,v), y(u,v),z(u,v)) to be the
surface mapping, and (u,v) = (u(t), v(t)) to be the curve mapping, then
the composite curve is the mapping
x = x(u(t), v(t));
y = y(u(t), v(t));
z = z(u(t), v(t));
The default domain (the range of t) is the domain of the 2D curve.
pfGetCompositeCurve3dClassType returns the pfType* for the class
pfCompositeCurve3d. The pfType* returned by
pfGetCompositeCurve3dClassType is the same as the pfType* returned by
invoking pfGetType on any instance of class pfCompositeCurve3d. 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.
pfNewCompositeCurve3d creates an instance of an pfCompositeCurve3d. By
default the parametric domain is defined as [0..1]. No valid data is set.
Page 3
pfCompositeCurve3d(3pf) OpenGL Performer 3.2.2 libpf C Reference Pages
pfCompositeCurve2dSet The surface sur is set to sur and the curve cur is
set to cur. Notice that the only the pointers are copied. The domain
[beginT, endT], where both beginT and endT are inherited members from its
superclass pfCurve3d, is set to the domain of cur.
pfGetCompositeCurve3dParaSurface returns the surface pointer.
pfGetCompositeCurve3dCurve2d returns the curve2d pointer.
pfCompositeCurve3dEvalPt Evaluates the line at parametric value t. The
evaluator performs linear extrapolation of the line when the values of t
are outside the domain of t1 and t2.
SEE ALSO
pfRep, pfGeode, pfCurve3d, pfCurve2d, pfParaSurface
Page 4
