#include <opennurbs_nurbscurve.h>
Public Member Functions | |
| ON_NurbsCurve () ON_NOEXCEPT | |
| ON_NurbsCurve (const ON_NurbsCurve &) | |
| ON_NurbsCurve (const ON_BezierCurve &bezier_curve) | |
| ON_NurbsCurve (int dimension, bool bIsRational, int order, int cv_count) | |
| virtual | ~ON_NurbsCurve () |
| bool | Append (const ON_NurbsCurve &) |
| bool | ChangeClosedCurveSeam (double t) override |
| bool | ChangeDimension (int desired_dimension) override |
| bool | ChangeEndWeights (double w0, double w1) |
| bool | ClampEnd (int end) |
| const ON_4dPoint | ControlPoint (int cv_index) const |
| double | ControlPolygonLength () const |
| returns the length of the control polygon More... | |
| bool | ConvertSpanToBezier (int, ON_BezierCurve &) const |
| bool | Create (int dimension, bool bIsRational, int order, int cv_count) |
| bool | CreateClampedUniformNurbs (int dimension, int order, int point_count, const ON_3dPoint *point, double knot_delta=1.0) |
| bool | CreatePeriodicUniformNurbs (int dimension, int order, int point_count, const ON_3dPoint *point, double knot_delta=1.0) |
| double * | CV (int cv_index) const |
| int | CVCount (void) const |
| int | CVSize (void) const |
| ON::point_style | CVStyle () const |
| ON__UINT32 | DataCRC (ON__UINT32 current_remainder) const override |
| virtual ON_Object::DataCRC override More... | |
| int | Degree () const override |
| void | Destroy () |
| int | Dimension () const override |
| ON_Geometry overrides. More... | |
| ON_Interval | Domain () const override |
| ON_Curve overrides. More... | |
| void | Dump (ON_TextLog &dump) const override |
| void | EmergencyDestroy () |
| bool | Evaluate (double, int, int, double *, int=0, int *=0) const override |
| bool | Extend (const ON_Interval &domain) override |
| bool | GetBBox (double *boxmin, double *boxmax, bool bGrowBox=false) const override |
| virtual ON_Geometry GetBBox override More... | |
| bool | GetCurveParameterFromNurbFormParameter (double nurbs_t, double *curve_t) const override |
| bool | GetCV (int, ON::point_style, double *) const |
| bool | GetCV (int, ON_3dPoint &) const |
| bool | GetCV (int, ON_4dPoint &) const |
| bool | GetGrevilleAbcissae (double *) const |
| bool | GetNextDiscontinuity (ON::continuity c, double t0, double t1, double *t, int *hint=nullptr, int *dtype=nullptr, double cos_angle_tolerance=ON_DEFAULT_ANGLE_TOLERANCE_COSINE, double curvature_tolerance=ON_SQRT_EPSILON) const override |
| int | GetNurbForm (ON_NurbsCurve &nurbsform, double tolerance=0.0, const ON_Interval *subdomain=nullptr) const override |
| bool | GetNurbFormParameterFromCurveParameter (double curve_t, double *nurbs_t) const override |
| bool | GetParameterTolerance (double t, double *tminus, double *tplus) const override |
| bool | GetSpanVector (double *knot_values) const override |
| double | GrevilleAbcissa (int) const |
| bool | HasBezierSpans () const |
| int | HasNurbForm () const override |
| bool | IncreaseDegree (int desired_degree) |
| void | Initialize (void) |
| bool | InsertKnot (double knot_value, int knot_multiplicity) |
| bool | IsArc (const ON_Plane *plane=nullptr, ON_Arc *arc=nullptr, double tolerance=ON_ZERO_TOLERANCE) const override |
| bool | IsClamped (int=2) const |
| bool | IsClosed () const override |
| bool | IsContinuous (ON::continuity c, double t, int *hint=nullptr, double point_tolerance=ON_ZERO_TOLERANCE, double d1_tolerance=ON_ZERO_TOLERANCE, double d2_tolerance=ON_ZERO_TOLERANCE, double cos_angle_tolerance=ON_DEFAULT_ANGLE_TOLERANCE_COSINE, double curvature_tolerance=ON_SQRT_EPSILON) const override |
| bool | IsDeformable () const override |
| virtual ON_Geometry::IsDeformable() override More... | |
| bool | IsDuplicate (const ON_NurbsCurve &other, bool bIgnoreParameterization, double tolerance=ON_ZERO_TOLERANCE) const |
| bool | IsInPlane (const ON_Plane &test_plane, double tolerance=ON_ZERO_TOLERANCE) const override |
| bool | IsLinear (double tolerance=ON_ZERO_TOLERANCE) const override |
| bool | IsPeriodic () const override |
| bool | IsPlanar (ON_Plane *plane=nullptr, double tolerance=ON_ZERO_TOLERANCE) const override |
| int | IsPolyline (ON_SimpleArray< ON_3dPoint > *pline_points=nullptr, ON_SimpleArray< double > *pline_t=nullptr) const override |
| bool | IsRational (void) const |
| Interface. More... | |
| bool | IsSingular () const |
| bool | IsValid (class ON_TextLog *text_log=nullptr) const override |
| ON_Object overrides. More... | |
| double | Knot (int knot_index) const |
| const double * | Knot () const |
| int | KnotCount (void) const |
| int | KnotMultiplicity (int knot_index) const |
| bool | MakeClampedUniformKnotVector (double delta=1.0) |
| bool | MakeDeformable () override |
| virtual ON_Geometry::MakeDeformable() override More... | |
| bool | MakeNonRational () |
| bool | MakePeriodicUniformKnotVector (double delta=1.0) |
| bool | MakePiecewiseBezier (bool bSetEndWeightsToOne=false) |
| bool | MakeRational () |
| ON_NurbsCurve & | operator= (const ON_NurbsCurve &src) |
| ON_NurbsCurve & | operator= (const ON_BezierCurve &bezier_curve) |
| int | Order (void) const |
| bool | Read (ON_BinaryArchive &binary_archive) override |
| int | RemoveSingularSpans () |
| bool | RemoveSpan (int span_index) |
| bool | RepairBadKnots (double knot_tolerance=0.0, bool bRepair=true) |
| bool | Reparameterize (double c) |
| bool | ReserveCVCapacity (int) |
| Tools for managing CV and knot memory. More... | |
| bool | ReserveKnotCapacity (int) |
| bool | Reverse () override |
| bool | SetCV (int, ON::point_style, const double *) |
| bool | SetCV (int, const ON_3dPoint &) |
| bool | SetCV (int, const ON_4dPoint &) |
| bool | SetDomain (double t0, double t1) override |
| bool | SetEndPoint (ON_3dPoint end_point) override |
| virtual More... | |
| bool | SetKnot (int knot_index, double knot_value) |
| bool | SetStartPoint (ON_3dPoint start_point) override |
| virtual More... | |
| bool | SetWeight (int, double) |
| unsigned int | SizeOf () const override |
| virtual ON_Object::SizeOf override More... | |
| int | SpanCount () const override |
| bool | SpanIsLinear (int span_index, double min_length, double tolerance) const |
| bool | SpanIsLinear (int span_index, double min_length, double tolerance, ON_Line *line) const |
| bool | SpanIsSingular (int span_index) const |
| bool | Split (double split_param, ON_Curve *&left_result, ON_Curve *&right_result) const override |
| double | SuperfluousKnot (int) const |
| bool | SwapCoordinates (int i, int j) override |
| bool | Transform (const ON_Xform &xform) override |
| bool | Trim (const ON_Interval &) override |
| double | Weight (int) const |
| bool | Write (ON_BinaryArchive &binary_archive) const override |
| bool | ZeroCVs () |
| zeros control vertices and, if rational, sets weights to 1 More... | |
Public Member Functions inherited from ON_Curve | |
| ON_Curve () ON_NOEXCEPT | |
| ON_Curve (const ON_Curve &) | |
| virtual | ~ON_Curve () |
| ON_3dVector | CurvatureAt (double t) const |
| ON_3dVector | DerivativeAt (double t) const |
| void | DestroyCurveTree () |
| void | DestroyRuntimeCache (bool bDelete=true) override |
| virtual ON_Object::DestroyRuntimeCache override More... | |
| virtual ON_Curve * | DuplicateCurve () const |
| bool | Ev1Der (double t, ON_3dPoint &point, ON_3dVector &first_derivative, int side=0, int *hint=0) const |
| bool | Ev2Der (double t, ON_3dPoint &point, ON_3dVector &first_derivative, ON_3dVector &second_derivative, int side=0, int *hint=0) const |
| bool | EvaluatePoint (const class ON_ObjRef &objref, ON_3dPoint &P) const override |
| virtual ON_Geometry override More... | |
| bool | EvCurvature (double t, ON_3dPoint &point, ON_3dVector &tangent, ON_3dVector &kappa, int side=0, int *hint=0) const |
| bool | EvPoint (double t, ON_3dPoint &point, int side=0, int *hint=0) const |
| bool | EvTangent (double t, ON_3dPoint &point, ON_3dVector &tangent, int side=0, int *hint=0) const |
| bool | FirstSpanIsLinear (double min_length, double tolerance) const |
| bool | FirstSpanIsLinear (double min_length, double tolerance, ON_Line *span_line) const |
| bool | FrameAt (double t, ON_Plane &plane) const |
| bool | GetDomain (double *t0, double *t1) const |
| curve interface More... | |
| virtual bool | GetSpanVectorIndex (double t, int side, int *span_vector_index, ON_Interval *span_domain) const |
| bool | GetTightBoundingBox (class ON_BoundingBox &tight_bbox, bool bGrowBox=false, const class ON_Xform *xform=nullptr) const override |
| virtual ON_Geometry GetTightBoundingBox override More... | |
| bool | IsArcAt (double t, const ON_Plane *plane=0, ON_Arc *arc=0, double tolerance=ON_ZERO_TOLERANCE, double *t0=0, double *t1=0) const |
| bool | IsClosable (double tolerance, double min_abs_size=0.0, double min_rel_size=10.0) const |
| virtual bool | IsEllipse (const ON_Plane *plane=nullptr, ON_Ellipse *ellipse=nullptr, double tolerance=ON_ZERO_TOLERANCE) const |
| bool | LastSpanIsLinear (double min_length, double tolerance) const |
| bool | LastSpanIsLinear (double min_length, double tolerance, ON_Line *span_line) const |
| ON_NurbsCurve * | NurbsCurve (ON_NurbsCurve *pNurbsCurve=nullptr, double tolerance=0.0, const ON_Interval *subdomain=nullptr) const |
| ON::object_type | ObjectType () const override |
| ON_Curve & | operator= (const ON_Curve &) |
| ON_3dPoint | PointAt (double t) const |
| ON_3dPoint | PointAtEnd () const |
| ON_3dPoint | PointAtStart () const |
| bool | SetDomain (ON_Interval domain) |
| ON_3dVector | TangentAt (double t) const |
Public Member Functions inherited from ON_Geometry | |
| ON_Geometry ()=default | |
| ON_Geometry (const ON_Geometry &)=default | |
| ~ON_Geometry ()=default | |
| ON_BoundingBox | BoundingBox () const |
| virtual class ON_Brep * | BrepForm (class ON_Brep *brep=nullptr) const |
| virtual void | ClearBoundingBox () |
| virtual ON_COMPONENT_INDEX | ComponentIndex () const |
| bool | GetBoundingBox (ON_BoundingBox &bbox, bool bGrowBox=false) const |
| bool | GetBoundingBox (ON_3dPoint &bbox_min, ON_3dPoint &bbox_max, bool bGrowBox=false) const |
| virtual bool | HasBrepForm () const |
| ON_Geometry & | operator= (const ON_Geometry &)=default |
| bool | Rotate (double sin_angle, double cos_angle, const ON_3dVector &rotation_axis, const ON_3dPoint &rotation_center) |
| bool | Rotate (double rotation_angle, const ON_3dVector &rotation_axis, const ON_3dPoint &rotation_center) |
| bool | Scale (double scale_factor) |
| bool | Translate (const ON_3dVector &translation_vector) |
Public Member Functions inherited from ON_Object | |
| ON_Object () ON_NOEXCEPT | |
| ON_Object (const ON_Object &) | |
| virtual | ~ON_Object () |
| virtual ON_AggregateComponentStatus | AggregateComponentStatus () const |
| bool | AttachUserData (class ON_UserData *pUserData) |
| unsigned int | ClearAllComponentStates () const |
| virtual unsigned int | ClearComponentStates (ON_ComponentStatus states_to_clear) const |
| virtual unsigned int | ClearComponentStates (ON_COMPONENT_INDEX component_index, ON_ComponentStatus states_to_clear) const |
| unsigned int | CopyUserData (const ON_Object &source_object, ON_UUID source_userdata_item_id, ON_Object::UserDataConflictResolution userdata_conflict_resolution) |
| void | CopyUserData (const ON_Object &source_object) |
| virtual bool | DeleteComponents (const ON_COMPONENT_INDEX *ci_list, size_t ci_count) |
| bool | DetachUserData (class ON_UserData *pUserData) |
| void | EmergencyDestroy () |
| class ON_UserData * | FirstUserData () const |
| virtual unsigned int | GetComponentsWithSetStates (ON_ComponentStatus states_filter, bool bAllEqualStates, ON_SimpleArray< ON_COMPONENT_INDEX > &components) const |
| class ON_UserData * | GetUserData (const ON_UUID &userdata_uuid) const |
| bool | GetUserString (const wchar_t *key, ON_wString &string_value) const |
| int | GetUserStringKeys (ON_ClassArray< ON_wString > &user_string_keys) const |
| int | GetUserStrings (ON_ClassArray< ON_UserString > &user_strings) const |
| bool | IsKindOf (const ON_ClassId *pClassId) const |
| virtual void | MarkAggregateComponentStatusAsNotCurrent () const |
| virtual void | MemoryRelocate () |
| virtual ON_UUID | ModelObjectId () const |
| unsigned int | MoveUserData (ON_Object &source_object, ON_UUID source_userdata_item_id, ON_Object::UserDataConflictResolution userdata_conflict_resolution, bool bDeleteAllSourceItems) |
| void | MoveUserData (ON_Object &source_object) |
| ON_Object & | operator= (const ON_Object &) |
| void | PurgeUserData () |
| virtual unsigned int | SetComponentStates (ON_COMPONENT_INDEX component_index, ON_ComponentStatus states_to_set) const |
| virtual unsigned int | SetComponentStatus (ON_COMPONENT_INDEX component_index, ON_ComponentStatus status_to_copy) const |
| bool | SetUserString (const wchar_t *key, const wchar_t *string_value) |
| int | SetUserStrings (int count, const ON_UserString *user_strings, bool bReplace) |
| void | TransformUserData (const class ON_Xform &xform) |
| virtual bool | UpdateReferencedComponents (const class ON_ComponentManifest &source_manifest, const class ON_ComponentManifest &destination_manifest, const class ON_ManifestMap &manifest_map) |
| int | UserStringCount () const |
Static Public Member Functions | |
| static ON_NurbsCurve * | New () |
| static ON_NurbsCurve * | New (const ON_NurbsCurve &nurbs_curve) |
| static ON_NurbsCurve * | New (const ON_BezierCurve &bezier_curve) |
| static ON_NurbsCurve * | New (int dimension, bool bIsRational, int order, int cv_count) |
Public Attributes | |
| double * | m_cv |
| int | m_cv_capacity |
| int | m_cv_count |
| number of control vertices ( >= order ) More... | |
| int | m_cv_stride |
| control vertex net memory More... | |
| int | m_dim |
| Implementation. More... | |
| int | m_is_rat |
| double * | m_knot |
| int | m_knot_capacity |
| knot vector memory More... | |
| int | m_order |
| order = degree+1 ( order >=2 ) More... | |
Additional Inherited Members | |
Public Types inherited from ON_Object | |
| enum | UserDataConflictResolution : unsigned char { UserDataConflictResolution::destination_object = 0, UserDataConflictResolution::source_object = 1, UserDataConflictResolution::source_copycount_gt = 2, UserDataConflictResolution::source_copycount_ge = 3, UserDataConflictResolution::destination_copycount_gt = 4, UserDataConflictResolution::destination_copycount_ge = 5, UserDataConflictResolution::delete_item = 6 } |
Static Public Attributes inherited from ON_Geometry | |
| static const ON_Geometry | Unset |
Protected Member Functions inherited from ON_Curve | |
| bool | ParameterSearch (double t, int &index, bool bEnableSnap, const ON_SimpleArray< double > &m_t, double RelTol=ON_SQRT_EPSILON) const |
/ / Copyright (c) 1993-2012 Robert McNeel & Associates. All rights reserved. / OpenNURBS, Rhinoceros, and Rhino3D are registered trademarks of Robert / McNeel & Associates. / / THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT EXPRESS OR IMPLIED WARRANTY. / ALL IMPLIED WARRANTIES OF FITNESS FOR ANY PARTICULAR PURPOSE AND OF / MERCHANTABILITY ARE HEREBY DISCLAIMED. / / For complete openNURBS copyright information see http://www.opennurbs.org. / //////////////////////////////////////////////////////////////
Definition of NURBS curve
| ON_NurbsCurve::ON_NurbsCurve | ( | ) |
|
virtual |
| ON_NurbsCurve::ON_NurbsCurve | ( | const ON_NurbsCurve & | ) |
| ON_NurbsCurve::ON_NurbsCurve | ( | const ON_BezierCurve & | bezier_curve | ) |
Description: Create a NURBS curve equal to bezier with domain [0,1]. Parameters: bezier_curve - [in]
| ON_NurbsCurve::ON_NurbsCurve | ( | int | dimension, |
| bool | bIsRational, | ||
| int | order, | ||
| int | cv_count | ||
| ) |
Description: Create a NURBS curve with knot a cv memory allocated. Parameters: dimension - [in] (>= 1) bIsRational - [in] true to make a rational NURBS order - [in] (>= 2) The order=degree+1 cv_count - [in] (>= order) number of control vertices
| bool ON_NurbsCurve::Append | ( | const ON_NurbsCurve & | ) |
|
overridevirtual |
Description: If this curve is closed, then modify it so that the start/end point is at curve parameter t. Parameters: t - [in] curve parameter of new start/end point. The returned curves domain will start at t. Returns: true if successful. Remarks: Overrides virtual ON_Curve::ChangeClosedCurveSeam
Reimplemented from ON_Curve.
|
overridevirtual |
Description: Change the dimension of a curve. Parameters: desired_dimension - [in] Returns: true if the curve's dimension was already desired_dimension or if the curve's dimension was successfully changed to desired_dimension.
Reimplemented from ON_Curve.
| bool ON_NurbsCurve::ChangeEndWeights | ( | double | w0, |
| double | w1 | ||
| ) |
Description: Use a combination of scaling and reparameterization to change the end weights to the specified values. Parameters: w0 - [in] weight for first cv w1 - [in] weight for last cv Returns: true if successful. See Also: ON_ChangeRationalNurbsCurveEndWeights Remarks: The domain, eucleanean locations of the control points, and locus of the curve do not change, but the weights, homogeneous cv values and internal knot values may change. If w0 and w1 are 1 and the curve is not rational, the curve is not changed.
| bool ON_NurbsCurve::ClampEnd | ( | int | end | ) |
Description: Clamp end knots. Does not modify control points. Parameters: end - [in] 0 = clamp start, 1 = clamp end, 2 = clamp start and end Returns: true if successful
| const ON_4dPoint ON_NurbsCurve::ControlPoint | ( | int | cv_index | ) | const |
Parameters: cv_index - [in] zero based control point index Returns: Control point as an ON_4dPoint. Remarks: If cv_index or the nurbs curve is not valid, then ON_4dPoint::Nan is returned. If dim < 3, unused coordinates are zero. If dim >= 4, the first three coordinates are returned. If is_rat is false, the weight is 1.
| double ON_NurbsCurve::ControlPolygonLength | ( | ) | const |
returns the length of the control polygon
| bool ON_NurbsCurve::ConvertSpanToBezier | ( | int | , |
| ON_BezierCurve & | |||
| ) | const |
Converts a span of the NURBS curve into a bezier. If the span is empty (m_knot[span_index+m_order-2] == m_knot[span_index+m_order-1]), then false is returned.
| bool ON_NurbsCurve::Create | ( | int | dimension, |
| bool | bIsRational, | ||
| int | order, | ||
| int | cv_count | ||
| ) |
Description: Create a NURBS curve with knot a cv memory allocated. Parameters: dimension - [in] (>= 1) bIsRational - [in] true to make a rational NURBS order - [in] (>= 2) The order=degree+1 cv_count - [in] (>= order) number of control vertices
| bool ON_NurbsCurve::CreateClampedUniformNurbs | ( | int | dimension, |
| int | order, | ||
| int | point_count, | ||
| const ON_3dPoint * | point, | ||
| double | knot_delta = 1.0 |
||
| ) |
Description: Create a clamped uniform NURBS curve from a list of control points Parameters: dimension - [in] 1, 2 or 3 order - [in] (>=2) order=degree+1 point_count - [in] (>=order) number of control vertices point - [in] array of control vertex locations. knot_delta - in knot spacing Returns: true if successful
| bool ON_NurbsCurve::CreatePeriodicUniformNurbs | ( | int | dimension, |
| int | order, | ||
| int | point_count, | ||
| const ON_3dPoint * | point, | ||
| double | knot_delta = 1.0 |
||
| ) |
Description: Create a periodic uniform NURBS curve from a list of control points Parameters: dimension - [in] 1, 2 or 3 order - [in] (>=2) order=degree+1 point_count - [in] (>=max(3,order-1)) number of distinct control vertices point - [in] array of distinct control vertex locations. knot_delta - in knot spacing Returns: true if successful
| double* ON_NurbsCurve::CV | ( | int | cv_index | ) | const |
Description: Expert user function to get a pointer to control vertex memory. If you are not an expert user, please use ON_NurbsCurve::GetCV( ON_3dPoint& ) or ON_NurbsCurve::GetCV( ON_4dPoint& ). Parameters: cv_index - [in] Returns: Pointer to control vertex. Remarks: If the NURBS curve is rational, the format of the returned array is a homogeneos rational point with length m_dim+1. If the NURBS curve is not rational, the format of the returned array is a nonrational euclidean point with length m_dim. See Also ON_NurbsCurve::CVStyle ON_NurbsCurve::GetCV ON_NurbsCurve::Weight
| int ON_NurbsCurve::CVCount | ( | void | ) | const |
| int ON_NurbsCurve::CVSize | ( | void | ) | const |
| ON::point_style ON_NurbsCurve::CVStyle | ( | ) | const |
Description: Returns the style of control vertices in the m_cv array. Returns: table ON::not_rational m_is_rat is false ON::homogeneous_rational m_is_rat is true
|
overridevirtual |
virtual ON_Object::DataCRC override
Reimplemented from ON_Object.
|
overridevirtual |
Description: virtual ON_Curve::Degree override. Returns: m_order-1
Implements ON_Curve.
| void ON_NurbsCurve::Destroy | ( | ) |
Description: Deallocate knot and cv memory. Zeros all fields.
|
overridevirtual |
ON_Geometry overrides.
Description: virtual ON_Geometry::Dimension override Returns: value of m_dim
Reimplemented from ON_Geometry.
|
overridevirtual |
ON_Curve overrides.
Description: virtual ON_Curve::Domain override. Returns: domain of the NURBS curve.
Implements ON_Curve.
|
overridevirtual |
Description: virtual ON_Object::Dump override
Reimplemented from ON_Object.
| void ON_NurbsCurve::EmergencyDestroy | ( | ) |
Description: Call if memory used by ON_NurbsCurve becomes invalid.
|
overridevirtual |
Description: virtual ON_Curve::Evaluate override.
Implements ON_Curve.
|
overridevirtual |
Description: Where possible, analytically extends curve to include domain. Parameters: domain - [in] if domain is not included in curve domain, curve will be extended so that its domain includes domain. Will not work if curve is closed. Original curve is identical to the restriction of the resulting curve to the original curve domain, Returns: true if successful.
Reimplemented from ON_Curve.
|
overridevirtual |
virtual ON_Geometry GetBBox override
Reimplemented from ON_Geometry.
|
overridevirtual |
Description: virtual ON_Curve::GetCurveParameterFromNurbFormParameter override
Reimplemented from ON_Curve.
| bool ON_NurbsCurve::GetCV | ( | int | , |
| ON::point_style | , | ||
| double * | |||
| ) | const |
| bool ON_NurbsCurve::GetCV | ( | int | , |
| ON_3dPoint & | |||
| ) | const |
| bool ON_NurbsCurve::GetCV | ( | int | , |
| ON_4dPoint & | |||
| ) | const |
| bool ON_NurbsCurve::GetGrevilleAbcissae | ( | double * | ) | const |
|
overridevirtual |
Description: Search for a derivatitive, tangent, or curvature discontinuity. Parameters: c - [in] type of continity to test for. If ON::continuity::C1_continuous t0 - [in] search begins at t0 t1 - [in] (t0 < t1) search ends at t1 t - [out] if a discontinuity is found, the *t reports the parameter at the discontinuity. hint - [in/out] if GetNextDiscontinuity will be called repeatedly, passing a "hint" with initial value *hint=0 will increase the speed of the search. dtype - [out] if not nullptr, *dtype reports the kind of discontinuity found at *t. A value of 1 means the first derivative or unit tangent was discontinuous. A value of 2 means the second derivative or curvature was discontinuous. cos_angle_tolerance - [in] default = cos(1 degree) Used only when c is ON::continuity::G1_continuous or ON::continuity::G2_continuous. If the cosine of the angle between two tangent vectors is <= cos_angle_tolerance, then a G1 discontinuity is reported. curvature_tolerance - [in] (default = ON_SQRT_EPSILON) Used only when c is ON::continuity::G2_continuous or ON::continuity::Gsmooth_continuous. ON::continuity::G2_continuous: If K0 and K1 are curvatures evaluated from above and below and |K0 - K1| > curvature_tolerance, then a curvature discontinuity is reported. ON::continuity::Gsmooth_continuous: If K0 and K1 are curvatures evaluated from above and below and the angle between K0 and K1 is at least twice angle tolerance or ||K0| - |K1|| > (max(|K0|,|K1|) > curvature_tolerance, then a curvature discontinuity is reported. Returns: true if a discontinuity was found on the interior of the interval (t0,t1). Remarks: Overrides ON_Curve::GetNextDiscontinuity.
Reimplemented from ON_Curve.
|
overridevirtual |
Description: virtual ON_Curve::GetNurbForm override.
| nurbsform | returns 0: unable to create NURBS representation with desired accuracy. 1: success - returned NURBS parameterization matches the curve's to wthe desired accuracy 2: success - returned NURBS point locus matches the curve's to the desired accuracy but, on the interior of the curve's domain, the curve's parameterization and the NURBS parameterization may not match to the desired accuracy. |
| subdomain | OPTIONAL subdomain of curve |
Reimplemented from ON_Curve.
|
overridevirtual |
Description: virtual ON_Curve::GetNurbFormParameterFromCurveParameter override
Reimplemented from ON_Curve.
|
overridevirtual |
Description: virtual ON_Curve::GetParameterTolerance override.
| t | returns tminus < tplus: parameters tminus <= s <= tplus |
Reimplemented from ON_Curve.
|
overridevirtual |
Description: virtual ON_Curve::GetSpanVector override. Get number of parameters of distinct knots in NURBS curve's domain. Parameters: knot_values - [out] an array of length SpanCount()+1 is filled in with the distinct knot values in the list (m_knot[m_order-2],...,m_knot[m_cv_count-1) Returns: true if successful
Implements ON_Curve.
| double ON_NurbsCurve::GrevilleAbcissa | ( | int | ) | const |
| bool ON_NurbsCurve::HasBezierSpans | ( | ) | const |
Returns true if the NURBS curve has bezier spans (all distinct knots have multiplitity = degree)
|
overridevirtual |
Description: virtual ON_Curve::HasNurbForm override.
Reimplemented from ON_Curve.
| bool ON_NurbsCurve::IncreaseDegree | ( | int | desired_degree | ) |
| void ON_NurbsCurve::Initialize | ( | void | ) |
Description: Zeros all fields.
| bool ON_NurbsCurve::InsertKnot | ( | double | knot_value, |
| int | knot_multiplicity | ||
| ) |
Description: Insert a knot and update cv locations. Parameters: knot_value - [in] m_knot[order-2] < knot_value < m_knot[m_cv_count-1] knot_multiplicity - [in] 1 to degree - includes multiplicity of existing knots. Remarks: Does not change parameterization or locus of curve. Returns: true if successful
|
overridevirtual |
Description: virtual ON_Curve::IsArc override.
Reimplemented from ON_Curve.
| bool ON_NurbsCurve::IsClamped | ( | int | = 2 | ) | const |
|
overridevirtual |
Description: virtual ON_Curve::IsClosed override. Returns: true if NURBS curve is closed. (Either curve has clamped end knots and euclidean location of start CV = euclidean location of end CV, or curve is periodic.)
Reimplemented from ON_Curve.
|
overridevirtual |
Description: Test continuity at a curve parameter value. Parameters: c - [in] continuity to test for t - [in] parameter to test hint - [in] evaluation hint point_tolerance - [in] if the distance between two points is greater than point_tolerance, then the curve is not C0. d1_tolerance - [in] if the difference between two first derivatives is greater than d1_tolerance, then the curve is not C1. d2_tolerance - [in] if the difference between two second derivatives is greater than d2_tolerance, then the curve is not C2. cos_angle_tolerance - [in] default = cos(1 degree) Used only when c is ON::continuity::G1_continuous or ON::continuity::G2_continuous. If the cosine of the angle between two tangent vectors is <= cos_angle_tolerance, then a G1 discontinuity is reported. curvature_tolerance - [in] (default = ON_SQRT_EPSILON) Used only when c is ON::continuity::G2_continuous or ON::continuity::Gsmooth_continuous. ON::continuity::G2_continuous: If K0 and K1 are curvatures evaluated from above and below and |K0 - K1| > curvature_tolerance, then a curvature discontinuity is reported. ON::continuity::Gsmooth_continuous: If K0 and K1 are curvatures evaluated from above and below and the angle between K0 and K1 is at least twice angle tolerance or ||K0| - |K1|| > (max(|K0|,|K1|) > curvature_tolerance, then a curvature discontinuity is reported. Returns: true if the curve has at least the c type continuity at the parameter t. Remarks: Overrides ON_Curve::IsContinuous.
Reimplemented from ON_Curve.
|
overridevirtual |
virtual ON_Geometry::IsDeformable() override
Reimplemented from ON_Geometry.
| bool ON_NurbsCurve::IsDuplicate | ( | const ON_NurbsCurve & | other, |
| bool | bIgnoreParameterization, | ||
| double | tolerance = ON_ZERO_TOLERANCE |
||
| ) | const |
Description: See if this and other are same NURBS geometry. Parameters: other - [in] other NURBS curve bIgnoreParameterization - [in] if true, parameterization and orientaion are ignored. tolerance - [in] tolerance to use when comparing control points. Returns: true if curves are tne same.
|
overridevirtual |
Description: virtual ON_Curve::IsInPlane override.
Implements ON_Curve.
|
overridevirtual |
Description: virtual ON_Curve::IsLinear override.
Reimplemented from ON_Curve.
|
overridevirtual |
Description: virtual ON_Curve::IsPeriodic override. Returns: true if NURBS curve is periodic (degree > 1, periodic knot vector, last degree many CVs are duplicates of first degree many CVs).
Reimplemented from ON_Curve.
|
overridevirtual |
Description: virtual ON_Curve::IsPlanar override.
Reimplemented from ON_Curve.
|
overridevirtual |
Description: Several types of ON_Curve can have the form of a polyline including a degree 1 ON_NurbsCurve, an ON_PolylineCurve, and an ON_PolyCurve all of whose segments are some form of polyline. IsPolyline tests a curve to see if it can be represented as a polyline. Parameters: pline_points - [out] if not nullptr and true is returned, then the points of the polyline form are returned here. t - [out] if not nullptr and true is returned, then the parameters of the polyline points are returned here. Returns: table 0 curve is not some form of a polyline >=2 number of points in polyline form
Reimplemented from ON_Curve.
| bool ON_NurbsCurve::IsRational | ( | void | ) | const |
Interface.
| bool ON_NurbsCurve::IsSingular | ( | ) | const |
Returns: True if every span in the NURBS curve is singular. See Also: ON_NurbsCurve::RepairBadKnots() ON_NurbsCurve::RemoveShortSegments()
|
overridevirtual |
ON_Object overrides.
Reimplemented from ON_Geometry.
| double ON_NurbsCurve::Knot | ( | int | knot_index | ) | const |
Description: Get knot value. Parameters: knot_index - [in] 0 <= knot_index <= KnotCount()-1 Returns: knot value = m_knot[knot_index] See Also: ON_NurbsCurve::SetKnot, ON_NurbsCurve::KnotMultiplicity
| const double* ON_NurbsCurve::Knot | ( | ) | const |
Description: Get pointer to knot vector array. Returns: pointer to knot vector array (m_knot). See Also: ON_NurbsCurve::SetKnot, ON_NurbsCurve::Knot, ON_NurbsCurve::InsertKnot
| int ON_NurbsCurve::KnotCount | ( | void | ) | const |
| int ON_NurbsCurve::KnotMultiplicity | ( | int | knot_index | ) | const |
Description: Get knot multiplicity. Parameters: knot_index - [in] 0 <= knot_index <= KnotCount()-1 Returns: knot multiplicity = m_knot[knot_index] See Also: ON_NurbsCurve::SetKnot, ON_NurbsCurve::Knot, ON_NurbsCurve::InsertKnot
| bool ON_NurbsCurve::MakeClampedUniformKnotVector | ( | double | delta = 1.0 | ) |
Description: Make knot vector a clamped uniform knot vector based on the current values of m_order and m_cv_count. Does not change values of control vertices. Parameters: delta - in knot spacing. Returns: true if successful. Remarks: Allocates m_knot[] if it is not big enough. See Also: ON_MakeClampedUniformKnotVector
|
overridevirtual |
virtual ON_Geometry::MakeDeformable() override
Reimplemented from ON_Geometry.
| bool ON_NurbsCurve::MakeNonRational | ( | ) |
| bool ON_NurbsCurve::MakePeriodicUniformKnotVector | ( | double | delta = 1.0 | ) |
Description: Make knot vector a periodic uniform knot vector based on the current values of m_order and m_cv_count. Does not change values of control vertices. Parameters: delta - in knot spacing. Returns: true if successful. Remarks: Allocates m_knot[] if it is not big enough. See Also: ON_MakePeriodicUniformKnotVector
| bool ON_NurbsCurve::MakePiecewiseBezier | ( | bool | bSetEndWeightsToOne = false | ) |
Description: Clamps ends and adds knots so the NURBS curve has bezier spans (all distinct knots have multiplitity = degree). Paremeters: bSetEndWeightsToOne - [in] If true and the first or last weight is not one, then the first and last spans are reparameterized so that the end weights are one. Returns: true if successful.
| bool ON_NurbsCurve::MakeRational | ( | ) |
|
static |
Description: Use ON_NurbsCurve::New(...) instead of new ON_NurbsCurve(...) Returns: Pointer to an ON_NurbsCurve. Destroy by calling delete. Remarks: See static ON_Brep* ON_Brep::New() for details.
|
static |
|
static |
|
static |
| ON_NurbsCurve& ON_NurbsCurve::operator= | ( | const ON_NurbsCurve & | src | ) |
| ON_NurbsCurve& ON_NurbsCurve::operator= | ( | const ON_BezierCurve & | bezier_curve | ) |
Description: Set NURBS curve equal to bezier with domain [0,1]. Parameters: bezier_curve - [in]
| int ON_NurbsCurve::Order | ( | void | ) | const |
|
overridevirtual |
Description: virtual ON_Object::Read override
Reimplemented from ON_Object.
| int ON_NurbsCurve::RemoveSingularSpans | ( | ) |
Returns: Number of spans removed.
| bool ON_NurbsCurve::RemoveSpan | ( | int | span_index | ) |
Paramaters: span_index - [in] The index of a non-empty span to remove. span_index >= 0 span_index <= m_cv_count-m_order m_knot[span_index+m_order-2] < m_knot[span_index+m_order-1] Returns: True if the span was successfully removed. Remarks: The NURBS curve must have 2 or more spans (m_cv_count > m_order). Set m0 = mulitiplicity of the knot at m_knot[span_index+m_order-2] and m1 = mulitiplicity of the knot at m_knot[span_index+m_order-1]. If (m0 + m1) < degree, then the degree-(m0+m1) cvs will be added to the NURBS curve. If (m0+m1) > degree, then (m0+m1)-degree cvs will be removed from the curve. See Also: ON_NurbsCurve::RepairBadKnots() ON_NurbsCurve::RemoveShortSegments()
| bool ON_NurbsCurve::RepairBadKnots | ( | double | knot_tolerance = 0.0, |
| bool | bRepair = true |
||
| ) |
Description: Looks for problems caused by knots that are close together or have mulitplicity >= order. If bRepair is true, the problems are fixed. Does not change the domain. Parameters: knot_tolerance - [in] >= 0 When in doubt, use zero. bRepair - [in] If true, then problems are repaired. Otherwise this function looks for problemsn that can be repaired, but does not modify the curve. Returns: True if bad knots were found and can be repaired. See Also: ON_NurbsCurve::RemoveShortSegments
| bool ON_NurbsCurve::Reparameterize | ( | double | c | ) |
Description: Use a linear fractional transformation to reparameterize the NURBS curve. This does not change the curve's domain. Parameters: c - [in] reparameterization constant (generally speaking, c should be > 0). The control points and knots are adjusted so that output_nurbs(t) = input_nurbs(lambda(t)), where lambda(t) = c*t/( (c-1)*t + 1 ). Note that lambda(0) = 0, lambda(1) = 1, lambda'(t) > 0, lambda'(0) = c and lambda'(1) = 1/c. Returns: true if successful. Remarks: The cv and knot values are values are changed so that output_nurbs(t) = input_nurbs(lambda(t)). See Also: ON_ReparameterizeRationalNurbsCurve
| bool ON_NurbsCurve::ReserveCVCapacity | ( | int | ) |
Tools for managing CV and knot memory.
| bool ON_NurbsCurve::ReserveKnotCapacity | ( | int | ) |
|
overridevirtual |
Description: virtual ON_Curve::Reverse override. Reverse parameterizatrion by negating all knots and reversing the order of the control vertices. Remarks: Domain changes from [a,b] to [-b,-a]
Implements ON_Curve.
| bool ON_NurbsCurve::SetCV | ( | int | , |
| ON::point_style | , | ||
| const double * | |||
| ) |
| bool ON_NurbsCurve::SetCV | ( | int | , |
| const ON_3dPoint & | |||
| ) |
| bool ON_NurbsCurve::SetCV | ( | int | , |
| const ON_4dPoint & | |||
| ) |
|
overridevirtual |
Description: virtual ON_Curve::SetDomain override. Set the domain of the curve Parameters: t0 - [in] t1 - [in] new domain will be [t0,t1] Returns: true if successful.
Reimplemented from ON_Curve.
|
overridevirtual |
virtual
Description: Force the curve to end at a specified point. Parameters: end_point - [in] Returns: true if successful. Remarks: Some end points cannot be moved. Be sure to check return code. See Also: ON_Curve::SetStartPoint ON_Curve::PointAtStart ON_Curve::PointAtEnd
Reimplemented from ON_Curve.
| bool ON_NurbsCurve::SetKnot | ( | int | knot_index, |
| double | knot_value | ||
| ) |
Description: Set knot value. Parameters: knot_index - [in] 0 <= knot_index <= KnotCount()-1 knot_value - [in] Remarks: m_knot[] must exist. Use ReserveKnotCapacity to allocate m_knot[]. Returns: true if successful See Also: ON_NurbsCurve::ReserveKnotCapacity
|
overridevirtual |
virtual
Description: Force the curve to start at a specified point. Parameters: start_point - [in] Returns: true if successful. Remarks: Some end points cannot be moved. Be sure to check return code. See Also: ON_Curve::SetEndPoint ON_Curve::PointAtStart ON_Curve::PointAtEnd
Reimplemented from ON_Curve.
| bool ON_NurbsCurve::SetWeight | ( | int | , |
| double | |||
| ) |
Description: Set value of control vertex weight. If curve is non-rational, it will be converted to rational.
|
overridevirtual |
virtual ON_Object::SizeOf override
Reimplemented from ON_Curve.
|
overridevirtual |
Description: virtual ON_Curve::SpanCount override. Get number of nonempty smooth (c-infinity) spans in curve Returns: Number of nonempty smooth (c-infinity) spans. Remarks: A nonempty span is bracked by knots m_knot[i] < m_knot[i+1] with m_order-2 <= i < m_cv_count-1.
Implements ON_Curve.
| bool ON_NurbsCurve::SpanIsLinear | ( | int | span_index, |
| double | min_length, | ||
| double | tolerance | ||
| ) | const |
Parameters: span_index - [in] (0 <= span_index <= m_cv_count-m_order) min_length -[in] minimum length of a linear span tolerance -[in] distance tolerance to use when checking control points between the span ends Returns true if the span is a non-degenrate line. This means:
| bool ON_NurbsCurve::SpanIsLinear | ( | int | span_index, |
| double | min_length, | ||
| double | tolerance, | ||
| ON_Line * | line | ||
| ) | const |
| bool ON_NurbsCurve::SpanIsSingular | ( | int | span_index | ) | const |
Paramaters: span_index - [in] The index of a non-empty span to test. span_index >= 0 span_index <= m_cv_count-m_order m_knot[span_index+m_order-2] < m_knot[span_index+m_order-1] Returns: true if the span_index parameter is valid and the span is singular (collapsed to a point). false if the span is not singular or span_index does not identify a non-empty span.
|
overridevirtual |
Description: virtual ON_Curve::Split override.
Split() divides the curve at the specified parameter. The parameter must be in the interior of the curve's domain. The pointers passed to ON_NurbsCurve::Split must either be nullptr or point to an ON_NurbsCurve. If the pointer is nullptr, then a curve will be created in Split(). You may pass "this" as one of the pointers to Split(). For example,
ON_NurbsCurve right_side; crv.Split( crv.Domain().Mid() &crv, &right_side );
would split crv at the parametric midpoint, put the left side in crv, and return the right side in right_side.
| split_param | t = curve parameter to split curve at |
| left_result | left portion returned here (must be an ON_NurbsCurve) |
| right_result | right portion returned here (must be an ON_NurbsCurve) |
Reimplemented from ON_Curve.
| double ON_NurbsCurve::SuperfluousKnot | ( | int | ) | const |
|
overridevirtual |
Description: virtual ON_Geometry::SwapCoordinates override. Swaps control vertex coordinate values with indices i and j. Parameters: i - [in] coordinate index j - [in] coordinate index
Reimplemented from ON_Geometry.
|
overridevirtual |
Description: virtual ON_Geometry::Transform override. Transforms the NURBS curve.
Parameters: xform - [in] transformation to apply to object.
Remarks: When overriding this function, be sure to include a call to ON_Object::TransformUserData() which takes care of transforming any ON_UserData that may be attached to the object.
Reimplemented from ON_Curve.
|
overridevirtual |
Description: virtual ON_Curve::Trim override.
Reimplemented from ON_Curve.
| double ON_NurbsCurve::Weight | ( | int | ) | const |
|
overridevirtual |
Description: virtual ON_Object::Write override
Reimplemented from ON_Object.
| bool ON_NurbsCurve::ZeroCVs | ( | ) |
zeros control vertices and, if rational, sets weights to 1
| double* ON_NurbsCurve::m_cv |
Control points.
| int ON_NurbsCurve::m_cv_capacity |
If m_cv_capacity > 0, then m_cv[] is an array of at least m_cv_capacity doubles whose memory is managed by the ON_NurbsCurve class using onmalloc(), onrealloc(), and onfree(). If m_cv_capacity is 0 and m_cv is not nullptr, then m_cv[] is assumed to be big enough for any requested operation and m_cv[] is not deleted by the destructor.
| int ON_NurbsCurve::m_cv_count |
number of control vertices ( >= order )
| int ON_NurbsCurve::m_cv_stride |
control vertex net memory
The pointer to start of "CV[i]" is m_cv + i*m_cv_stride.
| int ON_NurbsCurve::m_dim |
Implementation.
NOTE: These members are left "public" so that expert users may efficiently create NURBS curves using the default constructor and borrow the knot and CV arrays from their native NURBS representation. No technical support will be provided for users who access these members directly. If you can't get your stuff to work, then use the constructor with the arguments and the SetKnot() and SetCV() functions to fill in the arrays. (>=1)
| int ON_NurbsCurve::m_is_rat |
1 for rational B-splines. Rational control vertices use homogeneous form and explicit weight values are in m_cv[] array. 0 for non-rational B-splines. Control verticies have an implicit weight value of 1.0. An explicit weight value is not set in the m_cv[] array.
| double* ON_NurbsCurve::m_knot |
Knot vector. ( The knot vector has length m_order+m_cv_count-2. )
| int ON_NurbsCurve::m_knot_capacity |
knot vector memory
If m_knot_capacity > 0, then m_knot[] is an array of at least m_knot_capacity doubles whose memory is managed by the ON_NurbsCurve class using onmalloc(), onrealloc(), and onfree(). If m_knot_capacity is 0 and m_knot is not nullptr, then m_knot[] is assumed to be big enough for any requested operation and m_knot[] is not deleted by the destructor.
| int ON_NurbsCurve::m_order |
order = degree+1 ( order >=2 )