Synopsis

PDX_MSGT gcr_CompCurve2(long option, MDA_PTR orig_db_ptr, double cont_toler[4], MDA_COUNT num_of_curves, MDA_PTR curve_ptrs[], PDX_BOOL sense[], double parm_range[], int gdx_model, MDA_PTR *gdx_comp_curve_ptr)

Purpose

Create a GDX Composite Curve.

Description

The GDX Composite Curve's planar, xy_planar, and plane_normal fields are set by calling gdx_GetCurvePlanarity with the zero tolerance for point in plane check set to GDX COPLANAR_TOL. The GDX Composite Curve's closed field is set by calling gdx_GetCurveClosure. The GDX Composite Curve's trans_code field is set by calling gdx_GetCompositeContinuity with the cont_toler set to cont_toler.

The orig_db_ptr argument should contain the database pointer of the entity that the new entity was created from (usually this should be obtained by the calling routine via mda_GetOrigDbptr) or MDA_NULL_PTR. See the mda_intro man page for more information about predecessor entities.

\fBRules\fR .IP • 3 num_of_curves > 0 .LP

Input

option

GCR_NOVALIDATE

No validation will occur on the input data.

GCR_SETTRANS

Set the curve transition codes (default is to set trans_code field to NULL)

GCR_PLANAR

Assumes the comp curve created is planar. No calculation of planarity check made, and planar flaga are set to true

orig_db_ptr

The original entities orig_db_ptr as obtained from the mda_GetOrigDbptr call, or MDA_NULL_PTR

num_of_curves

The number of GDX curves forming the composite curve.

curve_ptrs

The database pointers of the GDX curves forming the composite curve.

sense

PDX_TRUE

sense of curve agrees with sense of composite curve

PDX_FALSE

sense of curve disagrees with sense of composite curve

parm_range

The list of GDX curve reparametrisation values, or NULL (optional). A value of 0.0 indicates that the curve uses the original curve's parametrisation, otherwise the value indicates the lenght of the parametric domain for the curve.

cont_toler

The continuity tolerance. The distance between the derivatives must be less then or equal this value to have derivative continuity .nf [0] = Model Space Distance (G0) [1] = Radian angular difference (G1) [2] = Curvature difference (G2) [3] = Normalized derivative difference .fi

gdx_model

The GDX model for entity creation

Output

gdx_comp_curve_ptr

Entity database pointer of the GDX Composite Curve

Tolerances

      GDX COPLANAR_TOL
      .fi

Return

      GCR_NOERR
      GCR_INVALIDMODEL
      Low level error return
      .fi