Synopsis

PDX_MSGT gcr_Shell(long option, MDA_PTR orig_db_ptr, MDA_COUNT num_of_faces, struct t_gdx_shell_faces *faces, int gdx_model, MDA_PTR *gdx_shell_ptr)

Purpose

Create a GDX Shell.

Description

Given the number of faces, and the face structures create a GDX Shell. The sense flags in the face structures indicate the sense of the faces with respect to the shell, PDX_TRUE means the sense agrees.

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

num_of_faces

Number of faces that make up the Shell, must be > 0.

faces

MDA memory contaings structures of the senses and database pointers of facess that make up the shell. Always consumed by this function even on error.

gdx_model

The GDX model for entity creation

Output

gdx_shell_ptr

Entity database pointer of the GDX Shell

Tolerances

      .fi

Return

      GCR_NOERR
      GCR_INVALID_MODEL
      Low level error return
      .fi