Dag
node class for NURBS surfaces.
Synopsis
#include <AlSurfaceNode.h>
class AlSurfaceNode : public AlDagNode
AlSurfaceNode();
virtual ~AlSurfaceNode();
virtual AlObject* copyWrapper() const;
statusCode create( AlSurface * );
virtual AlObjectType type() const;
AlSurface* surface() const;
AlSurface* surface(AlTM&) const;
int curvePrecision() const;
statusCode setCurvePrecision( int precision );
int patchPrecision() const;
statusCode setPatchPrecision( int precision );
Description
AlSurfaceNode is the
class used to access and manipulate surfaces within the DAG. This class
behaves like other DAG nodes (see AlDagNode for
a description of the usage and purpose of DAG nodes) and in addition
allows users to add curves on surfaces and access the geometry of
the surface via the surface() method. The surface() method returns
a pointer to an AlSurface object, which provides the user with the
methods used to modify the geometry of the surface. Surfaces can
be created from scratch by calling the AlSurfaceNode::create() method,
or read in from a wire file (see AlUniverse documentation).
AlSurfaceNode::AlSurfaceNode()
Description
Constructs
an AlSurfaceNode wrapper object.
AlSurfaceNode::~AlSurfaceNode()
Description
Deletes
an AlSurfaceNode wrapper object.
AlObject* AlSurfaceNode::copyWrapper()
const
Description
Returns
an exact duplicate of this AlSurfaceNode wrapper.
statusCode AlSurfaceNode::create(
AlSurface *newSurface )
Description
Allocates the DAG node
and geometry required for this object. This method must be called
once and only once before any other method and only if the surface
has been allocated by the user (that is, not read in from a wire
file). It is an error to call this method twice or if the object
has been read in from a wire file.
Arguments
< newSurface - the
surface to create this surface node for
Return Codes
sSuccess - the surface
node was created
sInvalidArgument - ’newSurface’
was NULL or invalid
sFailure - the surface
node was not created
AlObjectType AlSurfaceNode::type()
const
Description
Returns
the class identifier kSurfaceNodeType.
AlSurface* AlSurfaceNode::surface()
const
Description
Returns
a pointer to the surface data structure which can be used to access
the geometry of the surface.
AlSurface* AlSurfaceNode::surface(AlTM&
tm) const
Description
Returns a pointer to the
surface data structure that can be used to access the geometry of the
surface. The AlTM will be updated with the groupNode’s TM if a
childNode exists.
Arguments
< tm - the AlTM to
update with the group node’s TM
int AlSurfaceNode::curvePrecision()
const
Description
Obtains
the curve precision for the surface. -1 is returned if the surface
is invalid.
statusCode AlSurfaceNode::setCurvePrecision(
int precision )
Description
Sets the curve precision
for the surface.
Arguments
< precision - the
new curve precision (range is 1-129)
Return code
sSuccess - the curve
precision was set
sInvalidArgument - value
for curve precision was invalid
sInvalidObject - the
surface node was invalid
int AlSurfaceNode::patchPrecision()
const
Description
Obtains
the patch precision for the surface. -1 is returned if the surface
is invalid.
statusCode AlSurfaceNode::setPatchPrecision(
int precision )
Description
Sets the patch precision
for the surface.
Arguments
< precision - the
new patch precision (range is 2-64)
Return code
sSuccess - the patch
precision was set
sInvalidArgument - value
for patch precision was invalid
sInvalidObject - the
surface node was invalid
