Synopsis

PDX_MSGT gdb_PolyShellCheckProperties(long option, MDA_PTR gdx_ps_ptr, double **compare_values, PDX_BOOL *passed)

Purpose

Check properties of a GDX PolyShell Entity are in a specified range

Description

This function checks the polyshell properties specified by the option are in the specified range of values. If the specified property is within the range of values provided the function will return GDX_SUCCESS. If the value of the property is outside the range GDX_FAILURE will be returned.

Input

option

Specifies what to check for GDB_PS_PRINT Prints all the information evaluated and used for all the checks GDX_PS_VOLUME Only for solids. Return Success if volume of the polyshell is is within specified limits. GDX_PS_AREA Return Success if area of the polyshell is is within specified limits. GDX_PS_POLYGON_SEGS Return success if number of segments all polygons in the polyshell are within specified range.

gdx_ps_ptr

GDX PolyShell Entity database pointer

compare_values

2D array of values used to specify the property value ranges. The first index refers to the check being performed . Only specify values and allocate space for values needed for specified checks. Also, values must be specified in the same order as the options are listed above The second index iterates through the list of values provided for that check GDX_PS_VOLUME compare_values[][0] = min value of volume compare_values[][1] = max value of volume GDX_PS_AREA compare_values[][0] = min value of area compare_values[][1] = max value of area GDX_PS_NUM_PGON_SEGS compare_values[][0] = min num of polygon segments compare_values[][1] = max num of polygon segments e.g. if GDX_PS_AREA and GDX_PS_POLYGON_SEGS were the only checks then compare_values[0][0] = min value of area compare_values[0][1] = max value of area compare_values[1][0] = min num of polygon segments compare_values[1][1] = max num of polygon segments

Output

passed

Flag indicating whether or not the polyshell passed the specified checks PDX_TRUE All checks passed PDX_FALSE All checks failed