A curve in parametric surface space, part of a trim boundary.
#include <AlTrimCurve.h> class AlTrimCurve : public AlObject virtual ~AlTrimCurve(); virtual AlObject* copyWrapper() const; virtual AlObjectType type() const; AlTrimBoundary* parentBoundary() const; AlTrimRegion* parentRegion() const; AlDagNode* parentDagNode() const; AlCurve* worldSpace3DCopy( double = 1.0e-5 ) const; AlCurve* unaffected3DCopy( double = 1.0e-5 ) const; AlCurve* affected3DCopy( AlTM&, double = 1.0e-5 ) const; AlTrimCurve* getTwinCurve() const; boolean isReversed() const; curveFormType form() const; int degree() const; int numberOfSpans() const; int numberOfKnots() const; int numberOfCVs() const; statusCode CVsUVPosition( double[], double[][3] ) const; int realNumberOfKnots() const; statusCode realKnotVector( double[] ) const; statusCode periodicToNonPeriodic( ) const; AlTrimCurve* nextCurve() const; statusCode nextCurveD(); AlTrimCurve* prevCurve() const; statusCode prevCurveD(); statusCode eval(double t, double *p, double *p1, double *p2) const;
This class holds the trim curve data and provides access methods for the data. A trim curve is defined over a surface’s parametric space.
Evaluate the curve at parameter t to get its point and derivatives.
sSuccess - the wrapper now points to the prev curve
sFailure - there is no prev curve
sInvalidObject - the curve is invalid
Deletes an AlTrimCurve wrapper object.
Returns an exact duplicate of this AlTrimCurve wrapper.
Returns the class identifier kTrimCurve type.
Trim curves on shells are ’twinned’ - the edges where faces meet in a shell are tightly coupled. This function, given an AlTrimCurve, will return the AlTrimCurve which corresponds to the trim curve’s twin. In the case of trimmed surfaces, edges are not twinned, so NULL is returned. If the trim curve in question is a true edge of the shell, NULL is returned.
Returns TRUE if the trim curve has been reversed.
Returns the degree of the trim curve.
Returns the form of the curve, which is kOpen, kClosed or kPeriodic. If a trim curve is periodic, it is tangent continuous at the point where it is closed. (If you use the "close" tool in the interactive Alias package, you actually make a curve periodic.) If a curve is periodic, it implies that it is closed. If a curve is kClosed, then it just means that its endpoints are coincident. Otherwise, the curve is kOpen.
Returns the number of spans in the curve. -1 is returned if the curve is invalid.
Returns the number of knot values (just numberOfSpans() + 1). -1 is returned if the curve is invalid.
Returns the number of CVs (degree + numberOfSpans). -1 is returned if the curve is invalid.
Assumes that the ’knotVector’ is of length ’numberOfKnots()’ and the ’CVs’ array is of length ’numberOfCVs()’ and returns the values of the knots and CVs points in these arrays. Notice that each CV has three coordinates - the three coordinates describe 2D parameter space, with a homogeneous coordinate. Each control point is u, v and w, where u and v are parameter space and w is the homogeneous coordinate.
> knotVector - contains the knots for this curve upon return
> CVs - contains the control points upon return
sSuccess - the CVs’ positions were retrieved
sInvalidObject - the curve was invalid
Returns the actual number of knots on the curve. That is uNumberOfSpans() + 2*degree() - 1. (Note that two additional knots are required to define a NURBS curve, but they have no effect on the curve so are not included in this count.) This method returns -1 if the curve is not valid.
Returns realNumberOfKnots() in ’knotVector’ for the curve.
> knotVector - array to place the knot vector into
sSuccess - successfully copied the curve’s knot vector into knotVector
sInvalidArgument - knotVector was NULL
sInvalidObject - the curve was invalid
Returns the next trim curve. Returns NULL if there is no such trim curve.
Destructively points this wrapper to the next curve. If there is no next curve, then the object is left unchanged.
sSuccess - the wrapper now points to the next curve
sFailure - there is no next curve
sInvalidObject - the curve is invalid
Returns the previous trim curve. Returns NULL if there is no such trim curve.
Destructively points this wrapper to the previous curve. If there is no previous trim curve, then the object is left unchanged.
sSuccess - the wrapper now points to the previous curve
sFailure - there is no previous curve
sInvalidObject - the curve is invalid
Returns a pointer to a temporary curve that represents a world space copy of the surface trim curve.
This returns the world space (xyz) copy of the parameter space (uv) trim curve with all DAG transformations that affect the surface applied to the returned curve. That is, if you were to draw this curve, it would show up right on the surface.
The default value for tolerance is 1.0E-5.
Returns a pointer to a temporary curve that represents a world space copy of the surface trim curve.
This returns the world space (xyz) copy of the parameter space (uv) trim curve but with no DAG transformations applied. If you were to draw this curve, it would show up near the xyz origin.
The default value for tolerance is 1.0E-5.
In a loop of AlTrimCurves, all the parameter space versions are connected nose to tail to form a closed boundary. The world space copies are not guaranteed to be all in the same direction like this. worldSpace3DCopy, unaffected3DCopy, and affected3D copy will reverse the direction of the curve if necessary so that if you get a copy of the whole loop, the curves are all in the same direction. unaffected3DCopyNoReverse will not reverse a curve's direction to guarantee this.
The default value for tolerance is 1.0E-5.
Returns a pointer to a temporary curve that represents a world spacecopy of the surface trim curve.
This is like worldSpace3DCopy, except that instead of the transformations affecting the surface being applied to the curve, you specify your own transformation matrix.
tm is the transformation matrix generated while walking the DAG.
The default value for tolerance is 1.0E-5.
Returns the parent trim boundary of the trim region.
Returns the parent trim region of the trim curve.
Returns the parent DAG node of the trim curve.
Converts a periodic curve to a non-periodic curve (closed curve) by making it have multiple end knots.
Note: this method modifies the trim curve.
sInvalidObject - the trim curve was invalid
sFailure - the method did not succeed
sSuccess - the trim curve was converted to a non-periodic curve