Reading Geometric Tolerances

The function ProGtolNameGet() returns the name of the geometric tolerance (gtol) as a wchar_t* string. Use the function ProWstringFree() to free the string.

The function ProGtolTypeGet() returns the type of the gtol using the enumerated data type ProGtolType. The various types of gtol, are straightness, flatness, and so on.

The function ProGtolTopModelGet() returns the model that defines the origin of ProSelection structures used to define references inside the gtol. This will usually be the model that contains the gtol; but if the gtol was created in drawing mode and added to a solid in a drawing view, the owner will be the drawing, while the model is the solid.

ProGtolReferencesGet() returns a ProArray of the geometric entities referenced by the specified gtol. The entities are additional references used to create the gtol.

Use the function ProAnnotationreferencearrayFree() to free the ProArray.

The function ProGtolDatumReferencesGet() returns the primary, secondary, and tertiary datum references for a gtol as wchar_t* strings. Use the function ProWstringFree() to free the strings.

The function ProGtolCompositeGet() retrieves the value and the datum references, that is, the primary, secondary, and tertiary references for the specified composite gtol.

The function ProGtolCompositeGet() returns an array of values in which the first value is the primary value of the gtol and the rest are secondary, tertiary, and so on.

The function ProGtolValueStringGet() retrieves the value specified in the gtol as a wchar_t* string. Use the function ProWstringFree() to free the string.

The function ProGtolValueStringGet() returns a value string which is the primary value of the gtol and is displayed in the first box of the Composite Frame in the gtol ribbon.

For more information about gtols and the ribbon tab, refer to the online help.

Use the function ProGtolSymbolStringGet() to retrieve the string value in the specified font for the gtol symbol. The input arguments are:

• symbol—Specifies the type of symbol using the enumerated data type ProGtolSymbol. The valid values are:

◦ PRO_GTOL_SYMBOL_DIAMETER—Specifies the diameter for the feature.

◦ PRO_GTOL_SYMBOL_FREE_STATE—Specifies that the model is not subjected to any force, except the gravitational force.

◦ PRO_GTOL_SYMBOL_STAT_TOL—Specifies statistical tolerance.

◦ PRO_GTOL_SYMBOL_TANGENT_PLANE—Specifies the tangent plane.

◦ Material Symbols—The material conditions are represented using the following values:

PRO_GTOL_SYMBOL_LMC—Specifies least material condition and is displayed by the symbol

◦ PRO_GTOL_SYMBOL_MMC—Specifies maximum material condition and is displayed by the symbol

◦ PRO_GTOL_SYMBOL_RFS—Specifies the material condition regardless of the feature size and is displayed by the symbol

◦ PRO_GTOL_SYMBOL_DEFAULT_RFS—Specifies the material condition regardless of the feature size, but does not show a symbol in the frame.

◦ PRO_GTOL_SYMBOL_LMC_R—Specifies least material condition with reciprocity. The reciprocity is displayed on drawings with the symbol ® after the symbol

◦ PRO_GTOL_SYMBOL_MMC_R—Specifies maximum material condition with reciprocity. The reciprocity is displayed on drawings with the symbol ® after the symbol

Note:

You can use the reciprocity condition together with the maximum material condition or the minimum material condition to use the maximum tolerance allowed for a feature. The material conditions with reciprocity are applicable only for the ISO standard.

◦ Indicator Symbols—Indicators are displayed after the gtol symbol according to the standard. The Indicator symbols are represented using the following values:

PRO_INDICATOR_SYMBOL_ANGULARITY—Specifies the angular position of a feature to a reference.

◦ PRO_INDICATOR_SYMBOL_PERPENDICULARITY—Specifies that the two features must be perpendicular to each other. It is also used to indicate perpendicularity for features such as axis to a reference.

◦ PRO_INDICATOR_SYMBOL_PARALLELISM—Specifies that the two features must be parallel to each other. It is also used to indicate parallelism for features such as axis to a reference.

◦ PRO_INDICATOR_SYMBOL_SYMMETRY—Specifies that the two features must be symmetric about a center.

◦ PRO_INDICATOR_SYMBOL_RUNOUT—Applicable only for direction feature. Specifies that the direction of the width of the tolerance zone is equal to run-out, that is perpendicular to the surface of the tolerance feature.

◦ PRO_GTOL_SYMBOL_TRANSLATION—Specifies the translation symbol.

• font—Specifies the tolerancing font used for symbols. The valid values are defined in the enumerated data ProSymbolFont:

◦ PRO_FONT_LEGACY—Specifies that symbols use the legacy font.

◦ PRO_FONT_ASME—Specifies that symbols use ASME font.

◦ PRO_FONT_ISO—Specifies that symbols use ISO font.

◦ PRO_FONT_STROKED_ASME—Specifies that symbols use stroked ASME fonts that are native to .

◦ PRO_FONT_STROKED_ISO—Specifies that symbols use stroked ISO fonts that are native to .

The function ProGtolIndicatorsGet() retrieves all the indicators assigned to the specified gtol. It returns ProArray of indicator types, symbols, and datum feature symbols.

The function ProGtolCompositeShareRefGet() checks if the datum references are shared between all the rows defined in the composite gtol.

The functions ProGtolSymbolStringGet() and ProGtolValueStringGet(), provide information on the different symbolic modifiers available to the gtol.

The function ProGtolAllOverGet() returns a boolean value that indicates if the All Over symbol has been set in the specified gtol. The function ProGtolAllAroundGet() checks if the All Around symbol has been set for the specified gtol. The All Over symbol and All Around symbol specifies that the profile tolerance must be applied to all the three dimensional profile of the part. The symbol is available only for surface profile gtol, that is, of type PROGTOLTYPE_SURFACE.

The function ProGtolAddlTextBoxedGet() checks if a box has been created around the specified additional text in a geometric tolerance.

The function ProGtolBoundaryDisplayGet() checks if the boundary modifier has been set for the specified gtol. Use the function ProGtolUnilateralGet() to check if the profile boundary has been set to unilateral in the specified gtol. If set to unilateral, the function also checks if the tolerance disposition is in the outward direction of the profile.

Note:

When the new ProGtol*Get() functions, except ProGtolTopModelGet(), ProGtolReferencesGet(), ProGtolReferenceDelete(), and ProGtolValidate() are called on geometric tolerances created in releases prior to 4.0 F000, these legacy geometric tolerances are converted to the new 4.0 geometric tolerances. In this case, the revision number of the model is also incremented.

Isto foi útil?