Synopsis

PDX_MSGT gmp_SetTolerances(long option, MAP_MAPPING *mapping)

Purpose

Initialize and lock the GDX tolerance parameters.

Description

This function processes GDX tolerances specified for mapping. The parameters in the following table are checked for being specified with mapping and if not found the corresponding defaults are used. After calling this function, the GDX subsystem will use the tolerances until another call is made to gdx_InitTolerances or gdx_ClearTolerances. Thus the GDX tolerances are effectively locked. Subsequent calls to gmp_SetTolerances, gdx_SetTolerances, or gdx_SetTolerances2 will be unable to change the settings of the GDX tolerances unless gdx_ClearTolerances is called first.

.nf GMP_ZERO_TOL GMP_MODEL_SPACE_PNT_TOL GMP_PARM_SPACE_PNT_TOL GMP_ISO_PARM_TOL GMP_CONVERGE_TOL GMP_KNOT_TOL GMP_INTERSECT_TOL GMP_PARALLEL_LINES_TOL GMP_ANGLE_TOL GMP_PNT_PROJ_TOL GMP_COLLINEAR_TOL GMP_COPLANAR_TOL GMP_NORMAL_MAG_TOL GMP_SINGULAR_TOL GMP_TANGENT_TOL GMP_CURVATURE_TOL GMP_DERIVATIVE_TOL .fi

A typical mapping function would utilize gmp_SetTolerances as shown below. Note that the GDX tolerances become locked after gmp_SetTolerances and remain in that condition until gdx_ClearTolerances is called after the mapping operation/conversion is done. The GDX tolerances are thus unlocked when map_ProcessEntity is called.

.nf { gmp_SetTolerances ( GMP_NOOPT, info->mapping ); . . Do mapping operation/conversion . . gdx_ClearTolerances (GDX_NOOPT);

map_ProcessEntity ( MAP_NOOPT, db_ptr, info ) } .fi

Input

option

Option (not used)

mapping

Mapping to obtain parameters from

Return

GMP error code