Synopsis

PDX_MSGT gcr_EdgeCurve2(long option, MDA_PTR orig_db_ptr, MDA_PTR mod_curve_ptr, MDA_COUNT num_surf_ptrs, MDA_PTR surf_ptrs[], MDA_COUNT num_parm_ptrs, MDA_PTR parm_ptrs[], PDX_BOOL mod_pref_flag, int gdx_model, MDA_PTR *gdx_ec_ptr)

Purpose

Create a GDX Edge Curve.

Description

Currently, this function does not check to see if the curves (parameter or model) lie on the surfaces. It does check the exists of the curves defined below.

If mod_curve_ptr is set to MDA_NULL_PTR, then surf_ptrs[0] and parm_ptrs[0] are expected to be set to valid GDX entities. If num_parm_ptrs > 0, then num_surf_ptrs = num_parm_ptrs (i.e., if parameter space curves are specified, there must be a one to one correspondence between surf_ptrs and parm_ptrs.

If num_of_surf_ptrs is zero, the calling program is responsible for calling gcr_EdgeCurveAddFace to create the 'faces' of the edge curve. This will be done automatically if gcr_Face or gcr_Face2 is invoked with the GCR_ADD_EC_FACES option. 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.

Input

option

GCR_NOVALIDATE

No validation will occur on the input data

orig_db_ptr

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

mod_curve_ptr

Model space curve or MDA_NULL_PTR. If MDA_NULL_PTR, surf_ptrs[0] and parm_ptrs[0] are required.

num_surf_ptrs

The number of GDX surface database pointers in surf_ptrs. num_surf_ptrs = 0 indicates faces will be added later (see above).

surf_ptrs

Array of GDX surface entity database pointers corresponding to the model and parameter space curves given by mod_curve_ptr and parm_ptrs. surf_ptrs[0] must always be specified to correspond to mod_curve_ptr and/or parm_ptrs[0].

num_parm_ptrs

The number of GDX curve database pointers in parm_ptrs.

parm_ptrs

Array of GDX curve entity database pointers corresponding to the parameter space curves if present, or NULL. If not NULL, must correspond one to one with the GDX surfaces given by surf_ptrs.

mod_pref_flag

PDX_TRUE

Model space curve preferred

PDX_FALSE

Parameter splace curve preferred

gdx_model

The GDX model for entity creation

Output

gdx_ec_ptr

The Entity database pointer of the GDX Edge Curve

Tolerances

      .fi

Return

      GCR_NOERR
      GCR_BAD_GDX_MODEL
      Low level error return
      .fi