pfCoonsSurface(3pf) OpenGL Performer 3.2.2 libpf C Reference Pages
NAME
pfGetCoonsSurfaceClassType, pfNewCoonsSurface, pfCoonsSurfaceRight,
pfCoonsSurfaceLeft, pfCoonsSurfaceBottom, pfCoonsSurfaceTop,
pfGetCoonsSurfaceRight, pfGetCoonsSurfaceLeft, pfGetCoonsSurfaceBottom,
pfGetCoonsSurfaceTop, pfCoonsSurfaceEvalPt - A parametric bilinear Coons
Surface patch
FUNCTION SPECIFICATION
#include <Performer/pf.h>
pfType * pfGetCoonsSurfaceClassType(void);
pfCoonsSurface* pfNewCoonsSurface(void *arena);
void pfCoonsSurfaceRight(pfCoonsSurface *coons,
pfCurve3d *right);
void pfCoonsSurfaceLeft(pfCoonsSurface *coons,
pfCurve3d *left);
void pfCoonsSurfaceBottom(pfCoonsSurface *coons,
pfCurve3d *bottom);
void pfCoonsSurfaceTop(pfCoonsSurface *coons,
pfCurve3d *top);
pfCurve3d * pfGetCoonsSurfaceRight(pfCoonsSurface *coons);
pfCurve3d * pfGetCoonsSurfaceLeft(pfCoonsSurface *coons);
pfCurve3d * pfGetCoonsSurfaceBottom(pfCoonsSurface *coons);
pfCurve3d * pfGetCoonsSurfaceTop(pfCoonsSurface *coons);
void pfCoonsSurfaceEvalPt(pfCoonsSurface *coons, pfReal u,
pfReal v, pfVec3 pnt);
PARENT CLASS FUNCTIONS
The OpenGL Performer class pfCoonsSurface is derived from the parent
class pfParaSurface, so each of these member functions of class
pfParaSurface are also directly usable with objects of class
pfCoonsSurface. Casting an object of class pfCoonsSurface to an object
of class pfParaSurface is taken care of automatically. This is also true
for casts to objects of ancestor classes of class pfParaSurface.
void pfParaSurfaceBeginU(pfParaSurface* surf, pfReal u);
void pfParaSurfaceEndU(pfParaSurface* surf, pfReal u);
void pfParaSurfaceBeginV(pfParaSurface* surf, pfReal v);
void pfParaSurfaceEndV(pfParaSurface* surf, pfReal v);
void pfParaSurfaceSolidId(pfParaSurface* surf, int solidId);
Page 1
pfCoonsSurface(3pf) OpenGL Performer 3.2.2 libpf C Reference Pages
void pfParaSurfaceTopoId(pfParaSurface* surf, int topoId);
void pfParaSurfaceSurfaceId(pfParaSurface* surf, int surfaceId);
pfReal pfGetParaSurfaceBeginU(pfParaSurface* surf);
pfReal pfGetParaSurfaceEndU(pfParaSurface* surf);
pfReal pfGetParaSurfaceBeginV(pfParaSurface* surf);
pfReal pfGetParaSurfaceEndV(pfParaSurface* surf);
int pfGetParaSurfaceTrimLoopCount(pfParaSurface* surf);
pfLoop pfGetParaSurfaceTrimLoopClosed(pfParaSurface* surf,
int loopNum);
int pfGetParaSurfaceTrimCurveCount(pfParaSurface* surf,
int loopNum);
pfEdge* pfGetParaSurfaceTrimCurve(pfParaSurface* surf, int loopNum,
int curveNum);
pfTopo* pfGetParaSurfaceTopo(pfParaSurface* surf);
int pfGetParaSurfaceTopoId(pfParaSurface* surf);
int pfGetParaSurfaceSolidId(pfParaSurface* surf);
int pfGetParaSurfaceSurfaceId(pfParaSurface* surf);
void pfParaSurfaceHandednessHint(pfParaSurface* surf,
pfBool _clockWise);
pfBool pfGetParaSurfaceHandednessHint(pfParaSurface* surf);
void pfParaSurfaceInsertTrimCurve(pfParaSurface* surf,
int loopNum, pfCurve2d *c, pfDisCurve2d *d);
void pfParaSurfaceAddTrimCurve(pfParaSurface* surf, int loopNum,
pfCurve2d *c, pfDisCurve2d *d);
void pfParaSurfaceTrimLoopClosed(pfParaSurface* surf,
int loopNum, pfLoop closed);
void pfParaSurfaceEvalPt(pfParaSurface* surf, pfReal u,
pfReal v, pfVec3 pnt);
void pfParaSurfaceEvalDu(pfParaSurface* surf, pfReal u,
pfReal v, pfVec3 Du);
void pfParaSurfaceEvalDv(pfParaSurface* surf, pfReal u,
pfReal v, pfVec3 Dv);
void pfParaSurfaceEvalDuu(pfParaSurface* surf, pfReal u,
pfReal v, pfVec3 Duu);
void pfParaSurfaceEvalDvv(pfParaSurface* surf, pfReal u,
pfReal v, pfVec3 Dvv);
void pfParaSurfaceEvalDuv(pfParaSurface* surf, pfReal u,
pfReal v, pfVec3 Duv);
void pfParaSurfaceEvalNorm(pfParaSurface* surf, pfReal u,
pfReal v, pfVec3 norm);
void pfParaSurfaceEvalD(pfParaSurface* surf, pfReal u, pfReal v,
pfReal theta, pfVec3 D);
void pfParaSurfaceEvalDD(pfParaSurface* surf, pfReal u,
pfReal v, pfReal theta, pfVec3 DD);
int pfParaSurfaceGState(pfParaSurface* surf,
pfGeoState *gState);
pfGeoState* pfGetParaSurfaceGState(pfParaSurface* surf);
void pfParaSurfaceClearTessellation(pfParaSurface* surf);
Page 2
pfCoonsSurface(3pf) OpenGL Performer 3.2.2 libpf C Reference Pages
Since the class pfParaSurface is itself derived from the parent class
pfGeode, objects of class pfCoonsSurface can also be used with these
functions designed for objects of class pfGeode.
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 pfGeode is itself derived from the parent class pfGeode,
objects of class pfCoonsSurface 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 pfCoonsSurface 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);
Page 3
pfCoonsSurface(3pf) OpenGL Performer 3.2.2 libpf C Reference Pages
int pfGetNodeTravMode(const pfNode* node, int which,
int mode);
Since the class pfNode is itself derived from the parent class pfObject,
objects of class pfCoonsSurface 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 pfCoonsSurface 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 Coons patch is a parametric surface defined by four pfCurve3 curves.
These four curves are bilinearly interpolated in the classic fashion.
The programming guide provides some details. The mathematical definition
can be found in G. Farin's book on Curves and surfaces. The boundary
curves must form a closed loop, or a Jordan curve. The "u,v" parameter
space of the Coons patch is always [0.0, 1.0] irrespective of the
boundary curves' parameter space. The left curve is with u=0 and the
bottom curve is with v=0. The range and direction of [startT endT] of the
top, bottom, right and left curves do not matter. Performer finds the
matching end points between curves.
Page 4
pfCoonsSurface(3pf) OpenGL Performer 3.2.2 libpf C Reference Pages
pfGetCoonsSurfaceClassType returns the pfType* for the class
pfCoonsSurface. The pfType* returned by pfGetCoonsSurfaceClassType is
the same as the pfType* returned by invoking pfGetType on any instance of
class pfCoonsSurface. 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.
pfNewCoonsSurface creates an instance of pfCoonsSurface. No valid data is
set.
pfCoonsSurfaceRight resets the Coons patch's right curve. Consistency is
checked and the curve is left undefined if right is NULL or if
topologically inconsistent.
pfCoonsSurfaceLeft resets the Coons patch's left curve. Consistency is
checked and the curve is left undefined if right is NULL or if
topologically inconsistent.
pfCoonsSurfaceBottom resets the Coons patch's bottom curve. Consistency
is checked and the curve is left undefined if right is NULL or if
topologically inconsistent.
pfCoonsSurfaceTop resets the Coons patch's top curve. Consistency is
checked and the curve is left undefined if right is NULL or if
topologically inconsistent.
pfGetCoonsSurfaceRight returns a pointer to the Coons patch's right
curve.
pfGetCoonsSurfaceLeft returns a pointer to the Coons patch's left curve.
pfGetCoonsSurfaceBottom returns a pointer to the Coons patch's bottom
curve.
pfGetCoonsSurfaceTop returns a pointer to the Coons patch's top curve.
pfCoonsSurfaceEvalPt evaluates the surface value of the Coons patch at
parametric values u and v and stores the result pnt. Values of u and v
are assumed to be in the domain [0..1]x[0..1]. Values outside this domain
may produce undefined results. If any of the curves are undefined then
the returned value is in turn undefined and an warning is issued.
SEE ALSO
pfRep, pfGeode, pfParaSurface, pfCurve3d
Page 5
