FLDget_poly_nnodes, FLDset_poly_nnodes

Synopsis

get/set the node connectivity list of a specified cell set

Common Version:

int FLDset_poly_nnodes (
OMobj_id cell_set,
int *poly_conn_array,
int size, int mode);

Wide Version:

int FLDget_poly_nnodes (
OMobj_id cell_set,
int **poly_conn_array,
xp_long *size, int mode);

Narrow Version:

int FLDget_poly_nnodes_n (
OMobj_id cell_set,
int **poly_conn_array,
int *size, int mode);

Description

These routines get/set the nnodes array within a specified Polyhedron cell set

The FLDget_poly_nnodes routine can be used for both getting and setting the poly_nnodes_list array. When setting with a "get" routine (mode = OM_GET_ARRAY_WR or OM_GET_ARRAY_RW), it returns an integer representing a pointer to an integer representing a pointer to a pre-allocated array, and the developer just needs to fill in the values.

If the cell set is a Polyhedron, this routine returns the array of integers each of them representing number of nodes (or nunber of sides) for each polygon. For example if your Polyhedron cell_set has 3 polys, triangle, quad and five-sided polygon, the poly_nnodes_array will look {3,4,5}. To set this array use FLDset_poly_nnodes().

Parameters

cell_set

The integer id of a cell set, as returned by the FLDget_cell_set routine.

poly_nnodes_array

In FLDget_poly_nnodes, poly_nnodes_array is the address of an integer representing a pointer to an array in which the list is returned. Call ARRfree() on this an integer representing a pointer when you are done using it.

In FLDset_poly_nnodes, poly_nnodes_array is an integer representing a pointer to an array from which the list will be copied.

size

In FLDget_poly_nnodes, size is an integer in which the size of the poly_nnodes_array is returned. In FLDset_poly_nnodes, size is an integer that sets the size of the poly_nnodes_array.

"size" is the number of elements in the array irrespective of type. (It is usually defined as ncells * cell_nnodes.)

mode

An integer constant that establishes the access mode for the array subobject. Constants for the possible values are defined in avs/om.h as follows.

Examples

none.

Files

v/fld.v.

See Also

none.