# 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