pfHsplineSurface(3pf) OpenGL Performer 3.2.2 libpf C Reference Pages
NAME
pfGetHsplineSurfaceClassType, pfNewHsplineSurface, pfGetHsplineSurfaceP,
pfGetHsplineSurfaceTu, pfGetHsplineSurfaceTv, pfGetHsplineSurfaceTuv,
pfGetHsplineSurfaceUknot, pfGetHsplineSurfaceVknot,
pfGetHsplineSurfaceUknotCount, pfGetHsplineSurfaceVknotCount,
pfGetHsplineSurfaceCylindrical, pfHsplineSurfaceAll,
pfHsplineSurfaceCylindrical, pfHsplineSurfaceEvalPt - A 3D Hermite
Surface
FUNCTION SPECIFICATION
#include <Performer/pf.h>
pfType * pfGetHsplineSurfaceClassType(void);
pfHsplineSurface* pfNewHsplineSurface(void *arena);
void pfGetHsplineSurfaceP(pfHsplineSurface* hSurface,
int i, int j, pfVec3& v);
void pfGetHsplineSurfaceTu(pfHsplineSurface* hSurface,
int i, int j, pfVec3& v);
void pfGetHsplineSurfaceTv(pfHsplineSurface* hSurface,
int i, int j, pfVec3& v);
void pfGetHsplineSurfaceTuv(pfHsplineSurface* hSurface,
int i, int j, pfVec3& v);
pfReal pfGetHsplineSurfaceUknot(pfHsplineSurface* hSurface,
int i);
pfReal pfGetHsplineSurfaceVknot(pfHsplineSurface* hSurface,
int j);
int -
pfGetHsplineSurfaceUknotCount(pfHsplineSurface* hSurface);
int -
pfGetHsplineSurfaceVknotCount(pfHsplineSurface* hSurface);
pfBool -
pfGetHsplineSurfaceCylindrical(pfHsplineSurface* hSurface);
void pfHsplineSurfaceAll(pfHsplineSurface* hSurface,
pfReal *p, pfReal *tu, pfReal *tv, pfReal *tuv,
pfReal *uu, pfReal *vv, int uKnotCount,
int vKnotCount);
void -
pfHsplineSurfaceCylindrical(pfHsplineSurface* hSurface,
pfBool cylindrical);
Page 1
pfHsplineSurface(3pf) OpenGL Performer 3.2.2 libpf C Reference Pages
void pfHsplineSurfaceEvalPt(pfHsplineSurface *hSurface,
pfReal u, pfReal v, pfVec3 pnt);
PARENT CLASS FUNCTIONS
The OpenGL Performer class pfHsplineSurface is derived from the parent
class pfParaSurface, so each of these member functions of class
pfParaSurface are also directly usable with objects of class
pfHsplineSurface. Casting an object of class pfHsplineSurface 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);
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);
Page 2
pfHsplineSurface(3pf) OpenGL Performer 3.2.2 libpf C Reference Pages
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);
Since the class pfParaSurface is itself derived from the parent class
pfGeode, objects of class pfHsplineSurface 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 pfHsplineSurface 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 pfHsplineSurface 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);
Page 3
pfHsplineSurface(3pf) OpenGL Performer 3.2.2 libpf C Reference Pages
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 pfHsplineSurface 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 pfHsplineSurface 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);
Page 4
pfHsplineSurface(3pf) OpenGL Performer 3.2.2 libpf C Reference Pages
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
pfHsplineSurface defines an Hermite surface, parameterized by u and v. A
Hermite surface is defined by u-knot values uu, v-knot values vv, two
dimensional array of points p, tangents in u tu , tangents in v tv, and
cross derivatives tuv at these cross knot points.
The domain of the Hermite surface is a rectangle [beginU, endU], X [-
beginV, endV]. The domain limits are interited members from its
superclass pfParaSurface. By default, beginU is the first u knot value
and endU is the last knot value, and similarly for beginV and endV.
pfHsplineSurface keeps a flag named cylindrical which, when set to true,
indicates that the coordinates are cylindrical in which case evalPt
converts each point into cartesian coordinates: assuming the cylindrical
coordinates are (c0,c1,c2), then the cartesian coordinates (x0, x1, x2)
are
x0 = c1 * cos(c0);
x1 = c1 * sin(c0);
x2 = c2;
pfGetRuledClassType returns the pfType* for the class pfHsplineSurface.
The pfType* returned by pfGetRuledClassType is the same as the pfType*
returned by invoking pfGetType on any instance of class pfHsplineSurface.
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.
pfNewHsplineSurface creates an instance of pfHsplineSurface. No valid
data is set.
pfGetHsplineSurfaceP returns the points of the surface at the cross knot
points (uu[i], vv[j]).
pfGetHsplineSurfaceTu returns the tangents in the u direction of the
surface at the cross knot points (uu[i], vv[j]).
pfGetHsplineSurfaceTv returns the tangents in the v direction of the
surface at the cross knot points (uu[i], vv[j]).
pfGetHsplineSurfaceTuv returns the cross derivatives of the surface at
the cross knot points (uu[i], vv[j]).
Page 5
pfHsplineSurface(3pf) OpenGL Performer 3.2.2 libpf C Reference Pages
pfGetHsplineSurfaceUknot returns the u knot value uu[i].
pfGetHsplineSurfaceVknot returns the v knot value vv[j].
pfGetHsplineSurfaceUknotCount returns the number of u knot values.
pfGetHsplineSurfaceVknotCount returns the number of v knot values.
pfGetHsplineSurfaceCylindrical returns TRUE if the points and derivatives
are in cylindrical coordinates, FALSE otherwise.
pfHsplineSurfaceAll p, tu, tv, tuv, uu, and vv are copied from p, tu, tv,
tuv, uu, and vv, respectively. uKnotCount is the length of uu, and
vKnotCount is the length of vv. The correspondence between p and p is the
following: p[i*vKnotCount + j] is copied to p[i][j] for i=0,...,
uKnotCount-1, and j=0, ..., vKnotCount-1.
pfHsplineSurfaceCylindrical sets a flag then, when enabled, means that
the points and derivatives are in cylindrical coordinates.
pfHsplineSurfaceEvalPt evaluates the surface at (u, v). The evaluated
point is stored in pnt.
SEE ALSO
pfRep, pfGeode, pfParaSurface
Page 6
