Synopsis

PDX_MSGT gcr_EdgeCurve(long option, MDA_PTR orig_db_ptr, MDA_PTR mod_curve_ptr, MDA_COUNT num_of_faces, struct t_gdx_edge_curve_faces *faces, 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 faces[0].surf and faces[0].parm 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_faces 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

= MDA_NULL_PTR. Otherwise,

num_of_faces

The number of faces structures containing database pointers to surfaces and coresponding parameter curves. num_of_faces = 0 indicates faces will be added later (see above).

faces

[n].parm may optionally be MDA_NULL_PTR. Always consumed by this function even on error.

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