Synopsis

PDX_MSGT gcr_CompCurve(long option, MDA_PTR orig_db_ptr, double cont_toler[4], MDA_COUNT num_of_curves, MDA_PTR *curve_ptrs, char *sense, double *parm_range, int gdx_model, MDA_PTR *gdx_cc_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 flags 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

MDA memory containing the database pointers of the GDX curves forming the composite curve. Always consumed by this function even on error.

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

MDA memory containing 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 length of the parametric domain for the curve. Always consumed by this function even on error.

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_cc_ptr

Entity database pointer of the GDX Composite Curve

Tolerances

      GDX COPLANAR_TOL
      .fi

Return

      GCR_NOERR
      GCR_INVALIDMODEL
      Low level error return
      .fi