# Synopsis

PDX_MSGT gdx_ShellsToFaces(long option, int num_shells, MDA_PTR gdx_shell_ptrs[], PDX_BOOL shell_senses[], int *num_faces, PDX_BOOL **face_senses, MDA_PTR **gdx_face_ptrs)

# Purpose

Get an array of faces from shells.

# Description

Copy the face pointers from array of shells into an array. This function allocates the array of face pointers. When the face is copied, all the shared data it has with other faces, is lost.

# Input

## option

Not used.

## num_shells

Number of shells in the shell pointer array

## gdx_shell_ptrs

DB pointers of shells with shells

## shell_senses

Array of Shell Senses. If NULL, the returned faces_senses will be the face_senses in the shell. If array of senses, then then each face_sense returned will be the combination of the shell sense and the face sense.

# Output

## num_faces

Number of shells in the array of shell pointers

## face_senses

Array of shell senses. C memory malloced in this function.

## gdx_face_ptrs

Array of shell pointers. C memory malloced in this function.

# Return

          Low level error return
          .fi