Dimension Tolerances
Functions Introduced:
The function
ProToleranceDefaultGet() tells you the current default value for a given tolerance, that is, the value set in the configuration file to be used for new models. There is a separate tolerance for linear and angular dimensions (
PROTOLERANCE_LINEAR and
PROTOLERANCE_ANGULAR) and for each number of decimal places in the range 1 to 6 (12 tolerance settings in all).
If the round off attribute for the given dimension is set, the function
ProDimensionDisplayedToleranceGet() retrieves the displayed rounded values of the upper and lower limits of the specified dimension. Otherwise, it retrieves the stored values of the tolerances as done by the function
ProSolidToleranceGet(). For example, consider a dimension that is set to round off to two decimal places and has the upper and lower tolerances 0.123456. By default, the tolerance values displayed are also rounded off to two decimal places. In this case, the function
ProDimensionDisplayedToleranceGet() retrieves the upper and lower values as 0.12.
The input argument of the function
ProDimensionDisplayedToleranceGet() is a dimension handle. The output arguments of this function are pointers to the rounded values of the upper and lower limits of the specified dimension. You must allocate a memory location for each of the output arguments. Pass a
NULL pointer if you do not want to use an output argument. You cannot pass a null for both the output arguments.
The functions
ProSolidToleranceGet() and
ProSolidToleranceSet() let you find and set the current value of the specified dimensional tolerance. The function
ProDimensionIsToleranceDisplayed() tells you whether the tolerances of the specified dimension are currently being displayed. Refer to the
Creo Parametric Detailed Drawings Help for more information.
The function
ProDimensionToltypeGet() returns the display format for the specified dimension tolerance using the enumerated data type
ProDimToleranceType. The valid values are:
• PRO_TOL_DEFAULT—Displays dimensions without tolerances. Similar to the nominal option in Creo Parametric.
• PRO_TOL_LIMITS—Displays dimension tolerances as upper and lower limits.
|
Note:
|
This format is not available when only the tolerance value for a dimension is displayed.
|
• PRO_TOL_PLUS_MINUS—Displays dimensions as nominal with plus-minus tolerances. The positive and negative values are independent.
• PRO_TOL_PLUS_MINUS_SYM—Displays dimensions as nominal with a single value for both the positive and the negative tolerance.
• PRO_DIM_TOL_SYM_SUPERSCRIPT—Displays dimensions as nominal with a single value for positive and negative tolerance. The text of the tolerance is displayed in a superscript format with respect to the dimension text.
• PRO_DIM_TOL_BASIC—Displays dimensions as basic dimensions. Basic dimensions are displayed in an enclosed feature control frame . Tolerances are not displayed in basic dimensions, only the numerical part of the dimension value and its symbol are enclosed in the rectangular box. Any additional text in the dimension value is not included in the box.
Use the function
ProDimensionToltypeSet() to set the display format for the specified dimension tolerance.
The function
ProDimensionToleranceGet() reports the deviation of the upper and lower tolerances from the nominal value. The values are always reported as independent upper and lower tolerance values; the actual display of the tolerance is determined by
ProDimensionToltypeGet(). Tolerances are not applicable for reference dimensions.
|
Note:
|
If the upper tolerance value is negative, it will be displayed with a ‘-’ sign. But if the lower tolerance value is negative, it will be displayed with a ‘+’ sign.
|
The function
ProDimensionToleranceSet() sets the upper and lower tolerance limits. The values are always accepted as independent upper and lower tolerance values; the actual display of the tolerance is determined by
ProDimensionToltypeSet(). It is not applicable to reference dimensions.
The functions
ProDimensionTolerancedecimalsGet() and
ProDimensionTolerancedecimalsSet() obtain and assign the number of decimal places shown for the upper and lower values of the dimension tolerance. Thus, the decimals of the dimension tolerance can be set independent of the number of dimension decimals. By default, the number of decimal places for tolerance values is calculated based upon the “linear_tol” settings of the model.
|
Note:
|
The input tolerance_decimals to the ProDimensionTolerancedecimalsSet() function should be a non-negative number and it should be such that when you apply either the upper or the lower values of the tolerance to the given dimension, the total number of digits before and after the decimal point in the resulting values does not exceed 13. |
If the dimension tolerance value is a fraction, the functions
ProDimensionTolerancedenominatorGet() and
ProDimensiondenominatorSet() obtain and assign the value for the largest possible denominator for the upper and lower tolerance values. By default, this value is defined by the
config.pro option,
dim_fraction_denominator.