# Synopsis

PDX_MSGT picr_Shell(long option, int model, MDA_PTR orig_db_ptr, int tag, int identifier, MDA_COUNT n_faces, MDA_PTR *faces, int *orients, MDA_PTR acorn, MDA_COUNT n_edges, MDA_PTR *edges, int sign, int shell_type, MDA_PTR *shell_ptr)

# Purpose

Create the PINT model Shell entity.

# Description

This function creates a PINT Shell entity for the given input data. The data provided must result in a valid definition. 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

### PICR_VALIDATE

Validate the entity fields

### PICR_NOVALIDATE

Do not validate the entity fields

## model

PINT model for entity creation

## identifier

Parasolid's identifier

## orig_db_ptr

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

## tag

Parasolid tag for this entity

## n_faces

number of faces in the shell

## faces

list of MDA_PTRs to region entities

## orients

list of orientation flags for faces

## acorn

MDA_PTR to vertex entity, if shell_type == PINT_SHELL_ACORN

## n_edges

number of edges in the shell

## edges

MDA_PTR to edge entities

## sign

### PINT_SHELL_POSITIVE

The volume of the shell is a finite region

### PINT_SHELL_NEGATIVE

The volume of the shell is an infinite region

### PINT_SHELL_OPEN

The shell does not enclose a volume

## shell_type

### PINT_SHELL_ACORN

The shell consists of one vertex

### PINT_SHELL_WIREFRAME

The shell consists of edges

### PINT_SHELL_WIREFRAME_FREE

The shell consists of faces

### PINT_SHELL_MIXED

The shell consists of faces and edges

# Output

## shell_ptr

The PINT model pointer

# Return

          Low level error return
          .fi