pfLine3d(3pf) OpenGL Performer 3.2.2 libpf C Reference Pages pfLine3d(3pf)NAME
pfGetLine3dClassType, pfNewLine3d, pfLine3dPoint1, pfLine3dPoint2,
pfGetLine3dPoint1, pfGetLine3dPoint2, pfLine3dEvalPt - A three-
dimensional parametric line
FUNCTION SPECIFICATION
#include <Performer/pf.h>
pfType * pfGetLine3dClassType(void);
pfLine3d * pfNewLine3d(void *arena);
void pfLine3dPoint1(pfLine3d *l, pfReal x1, pfReal y1, pfReal z1,
pfReal t1);
void pfLine3dPoint2(pfLine3d *l, pfReal x2, pfReal y2, pfReal z2,
pfReal t2);
void pfGetLine3dPoint1(pfLine3d *l, pfReal *x1, pfReal *y1,
pfReal *z1, pfReal *t1);
void pfGetLine3dPoint2(pfLine3d *l, pfReal *x2, pfReal *y2,
pfReal *z2, pfReal *t2);
void pfLine3dEvalPt(pfLine3d *curve, pfReal t, pfVec3 &pt);
PARENT CLASS FUNCTIONS
The OpenGL Performer class pfLine3d is derived from the parent class
pfCurve3d, so each of these member functions of class pfCurve3d are also
directly usable with objects of class pfLine3d. Casting an object of
class pfLine3d 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 pfLine3d can also be used with these functions designed
for objects of class pfRep.
void pfRepOrigin(pfRep *rep, const pfVec3 origin);
Page 1
pfLine3d(3pf) OpenGL Performer 3.2.2 libpf C Reference Pages pfLine3d(3pf)
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 pfLine3d 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 pfLine3d 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);
Page 2
pfLine3d(3pf) OpenGL Performer 3.2.2 libpf C Reference Pages pfLine3d(3pf)
Since the class pfNode is itself derived from the parent class pfObject,
objects of class pfLine3d 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 pfLine3d 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
A three-dimensional parametric line is defined by two points in 3D space
and parametric space, so that the spatial (x,y,z) and parametric, t,
values vary linearly from one point to the other.
pfGetLine3dClassType returns the pfType* for the class pfLine3d. The
pfType* returned by pfGetLine3dClassType is the same as the pfType*
returned by invoking pfGetType on any instance of class pfLine3d.
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.
pfNewLine3d creates an instance of an pfLine3d. By default the parametric
domain is defined as [0..1].
Page 3
pfLine3d(3pf) OpenGL Performer 3.2.2 libpf C Reference Pages pfLine3d(3pf)pfLine3dPoint1 Sets the first endpoint of the line as per the above
description.
pfLine3dPoint2 Sets the second endpoint of the line as per the above
description.
pfGetLine3dPoint1 returns the values set by pfLine3dPoint1.
pfGetLine3dPoint2 returns the values set by pfLine3dPoint2.
pfLine3dEvalPt 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
Page 4
