pfdGSet(3pf) OpenGL Performer 3.2.2 libpfdu Reference Pages pfdGSet(3pf)NAME
pfdNewCube, pfdNewSphere, pfdNewCylinder, pfdNewPipe, pfdNewCone,
pfdNewPyramid, pfdNewArrow, pfdNewDoubleArrow, pfdNewCircle, pfdNewRing,
pfdXformGSet, pfdGSetColor - Construct simple pfGeoSets and perform
simple pfGeoSet manipulations.
FUNCTION SPECIFICATION
#include <Performer/pfdu.h>
pfGeoSet * pfdNewCube(void *arena);
pfGeoSet * pfdNewSphere(int ntris, void *arena);
pfGeoSet * pfdNewCylinder(int ntris, void *arena);
pfGeoSet * pfdNewPipe(float botRadius, float topRadius, int ntris,
void *arena);
pfGeoSet * pfdNewCone(int ntris, void *arena);
pfGeoSet * pfdNewPyramid(void *arena);
pfGeoSet * pfdNewArrow(int ntris, void *arena);
pfGeoSet * pfdNewDoubleArrow(int ntris, void *arena);
pfGeoSet * pfdNewCircle(int ntris, void *arena);
pfGeoSet * pfdNewRing(int ntris, void *arena);
void pfdXformGSet(pfGeoSet *gset, pfMatrix mat);
void pfdGSetColor(pfGeoSet *gset, float r, float g, float b,
float a);
DESCRIPTION
These routines are provided to conveniently construct pfGeoSets for
various geometric objects. The resulting objects are always positioned
and sized in canonical ways. The user can then apply a transformation to
these pfGeoSets to achieve the desired shape and position.
Some of these routines (such as pfdNewSphere) polygonalize smooth
surfaces. These functions take an argument ntris which specifies how
many triangular faces to use when polygonizing the surface. All the
constructor routines allocate storage in the shared memory arena arena.
pfdNewCube creates a new pfGeoSet describing a unit cube.
pfdNewSphere creates a unit sphere centered at the origin.
pfdNewCylinder creates a new cylinder along the Z axis from -1 to 1 with
a radius of 1.
Page 1
pfdGSet(3pf) OpenGL Performer 3.2.2 libpfdu Reference Pages pfdGSet(3pf)
pfdNewPipe creates a pipe (a cylinder without caps) extending along the Z
axis from -1 to 1. The radius of the pipe at Z=-1 is given by botRadius
while topRadius determines the pipe's radius at Z=1.
pfdNewCone creates a cone extending along the Z axis. The base of the
cone is at Z=0 and has radius 1. The cone extends to Z=1. The base of
the cone is capped with a circle centered at the origin.
pfdNewPyramid creates a pyramid with a unit square base cap centered at
the origin and extending along the Z axis from Z=0 to Z=1.
pfdNewArrow constructs an arrow extending along the Z axis from Z=0 to
Z=1.
pfdNewDoubleArrow constructs a double-headed arrow. The arrows extend
along the Z axis from Z=0 to Z=1 and Z=-1.
pfdNewCircle creates a filled unit circle centered at the origin in the
XY plane. The circle is oriented so as to face in the direction of the
positive Z axis.
pfdNewRing also creates a circle, but it is unfilled. The perimeter of
the circle is made up of connected lines.
pfdXformGSet transforms the coordinates in the given pfGeoSet by the
matrix mat.
pfdGSetColor is a simple convenience routine for setting the global color
of a pfGeoSet. This function only works if the color binding of gset is
PFGS_OVERALL.
NOTES
The libpfdu source code, object code and documentation are provided as
unsupported software. Routines are subject to change in future releases.
SEE ALSO
pfGeoSet
Page 2
