Annotations: Geometric Tolerances
The functions in this section allow a Creo TOOLKIT application to read, modify, and create geometric tolerances (gtols) in a solid or drawing. We recommend that you study the Creo Parametric documentation on geometric tolerances, and develop experience with manipulating geometric tolerances using the Creo Parametric commands before attempting to use these functions.
Geometric Tolerance Objects
Overview
The geometric tolerance objects enable you to access internal data structure of geometric tolerances (gtol). The object also references and gets attachment details for gtols.
From Creo Parametric 4.0 F000 onward, the object Gtoldata has been deprecated. All the ProGtolData* functions have also been deprecated. Use the new ProGtol* functions instead. The new functions are defined in the header files ProGtol.h and ProGtolAttach.h.
Note
Geometric tolerance functions deprecated in Creo Parametric 4.0 F000 must not be used with the new geometric tolerance functions available from Creo Parametric 4.0 F000 in a Creo TOOLKIT application. If the functions are used together in an application, the results may be unpredictable.
ProGtol
Geometric tolerances in a Creo Parametric model are referenced by the data handle, ProGtol. This handle is identical to ProModelitem, in which the type field is set to PRO_GTOL. You can use ProSelect() with the option gtol to select a gtol, after which you can extract the ProGtol handle using ProSelectionModelitemGet().
ProGtolAttach
This is an opaque handle object that references an internal data structure which provides complete attachment details for a gtol. The structure contains attachment information such as, type of placement, annotation plane, location and references and so on for a gtol.
Visiting Geometric Tolerances
Function Introduced:
  • ProMdlGtolVisit()
    		•
    The function ProMdlGtolVisit() visits geometric tolerances stored in a part, assembly, or drawing. The forms of the visit and filter functions are similar to those of most other visit functions-they receive a ProGtol pointer as input argument to identify the gtol.
    Reading Geometric Tolerances
    The functions explained in this section enable you to access and read the properties of a geometric tolerance.
    Function Introduced:
  • ProGtolNameGet()
    		•
  • ProGtolTypeGet()
    		•
  • ProGtolTopModelGet()
    		•
  • ProGtolReferencesGet()
    		•
  • ProGtolDatumReferencesGet()
    		•
  • ProGtolValueStringGet()
    		•
  • ProGtolCompositeGet()
    		•
  • ProGtolCompositeShareRefGet()
    		•
  • ProGtolSymbolStringGet()
    		•
  • ProGtolIndicatorsGet()
    		•
  • ProGtolAllAroundGet()
    		•
  • ProGtolAllOverGet()
    		•
  • ProGtolAddlTextBoxedGet()
    		•
  • ProGtolBoundaryDisplayGet()
    		•
  • ProGtolUnilateralGet()
    		•
    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 Creo Parametric 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 Image.
    ○  PRO_GTOL_SYMBOL_MMC—Specifies maximum material condition and is displayed by the symbol Image.
    ○  PRO_GTOL_SYMBOL_RFS—Specifies the material condition regardless of the feature size and is displayed by the symbol Image.
    ○  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 Image.
    ○  PRO_GTOL_SYMBOL_MMC_R—Specifies maximum material condition with reciprocity. The reciprocity is displayed on drawings with the symbol ? after the symbol Image.
    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 Creo.
    ○  PRO_FONT_STROKED_ISO—Specifies that symbols use stroked ISO fonts that are native to Creo.
    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 Creo Parametric 4.0 F000, these legacy geometric tolerances are converted to the new Creo Parametric 4.0 geometric tolerances. In this case, the revision number of the model is also incremented.
    Creating a Geometric Tolerance
    Functions Introduced:
  • ProGtolTypeSet()
    		•
  • ProGtolReferencesAdd()
    		•
  • ProGtolReferenceDelete()
    		•
  • ProGtolDatumReferencesSet()
    		•
  • ProGtolValueStringSet()
    		•
  • ProGtolCompositeSet()
    		•
  • ProGtolCompositeShareRefSet()
    		•
  • ProGtolAllAroundSet()
    		•
  • ProGtolAllOverSet()
    		•
  • ProGtolAddlTextBoxedSet()
    		•
  • ProGtolElbowlengthSet()
    		•
  • ProGtolBoundaryDisplaySet()
    		•
  • ProGtolUnilateralSet()
    		•
  • ProMdlGtolCreate()
    		•
  • ProGtolDtlnotesCollect()
    		•
    The basic steps in creating a gtol are:
    1. Allocate a ProGtolAttach structure using ProGtolAttachAlloc().
    2. Set the attachment properties using the ProGtolAttach*Set() functions.
    3. Set tolerance properties using the ProGtol*Set() functions.
    4. Create the tolerance using ProMdlGtolCreate(). Once the tolerance is created, you must use the function ProAnnotationShow() to display it.
    5. Free ProGtolAttach using ProGtolAttachFree().
    The function ProGtolTypeSet() sets the type of geometric tolerance using the enumerated data type ProGtolType.
    Use the function ProGtolReferencesAdd() to add datum references to the specified gtol.
    Note
    When a reference includes more than one collection, the function ProGtolReferencesAdd() returns the error PRO_TK_MAX_LIMIT_REACHED and no reference is added.
    Use the function ProGtolReferenceDelete() to delete the datum references from the specified gtol.
    The function ProGtolIndicatorsSet() sets the indicators for the specified gtol. The input arguments are:
    •  gtol—Specifies the gtol.
    •  types—Specifies a ProArray of indicator types using the enumerated data type ProGtolIndicatorType. Use the function ProArrayFree() to free the array.
    •  symbols—Specifies a ProArray of strings for indicator symbols. Free the array using the function ProWstringproarrayFree().
    •  dfs—Specifies a ProArray of strings for datum feature symbols. Free the array using the function ProWstringproarrayFree().
    The function ProGtolCompositeSet() sets the value and datum references, primary, secondary, and tertiary for the specified composite gtol.
    Use the function ProGtolCompositeShareRefSet() to specify if datum references in a composite gtol must be shared between all the defined rows. Pass the input argument share as PRO_B_TRUE to share the references.
    The function ProGtolValueStringSet() sets the specified value for a gtol.
    Use the function ProGtolDatumReferencesSet() to set the datum references for the specified gtol. The datum references are set as wchar_t* strings. Use the function ProWstringFree() to free the strings.
    The datum references are given to ProGtolDatumReferencesSet() in the form of wchar_t* strings. Use the function ProWstringFree() to free the strings.
    The function ProGtolElbowlengthSet() sets the elbow along with its properties for a leader type of gtol. The function is supported for leader type gtols which are placed on the annotation plane. The input arguments are:
    •  gtol—Specifies a gtol.
    •  elbow_length—Specifies the length of the elbow in model coordinates.
    •  elbow_direction—Specifies the direction of the elbow in model coordinates. The gtol text also moves in this direction.
    The function ProGtolBoundaryDisplaySet() sets the boundary modifier for the specified gtol. Use the function ProGtolUnilateralSet() to set the profile boundary as unilateral in the specified gtol. The function also sets the tolerance disposition to the outward direction of the profile.
    The function ProGtolAllAroundSet() sets the All Over symbol for the specified geometric tolerance.
    The function ProGtolAllAroundSet() sets the All Around symbol for the specified geometric tolerance.
    The function ProGtolAddlTextBoxedSet() creates a box around the specified additional text in a geometric tolerance. Boxes can be created around additional text added above and below the frame of the geometric tolerance.
    From Creo Parametric 4.0 F000 onward, stacked geometric tolerance creates separate notes for each tolerance. For a stacked geometric tolerance, the functions ProGtolDtlnoteGet(), ProDtlnoteDataGet(), and ProDtlnotedataLinesCollect() will return information about individual notes for each geometric tolerance.
    The function ProGtolDtlnotesCollect() returns the detail notes that represent a geometric tolerance in the specified drawing. The input arguments follow:
    •  solid_model_gtol—The handle to the geometric tolerance.
    •  drawing —The drawing where the note is displayed.
    The function returns an array of drawing notes that represents the geometric tolerance.
    Attaching the Geometric Tolerances
    The functions explained in this section enable you to access and set attachment options for the geometric tolerance.
    Function Introduced:
  • ProGtolAttachGet()
    		•
  • ProGtolAttachSuppressedLeadersGet()
    		•
  • ProGtolAttachSet()
    		•
  • ProGtolAttachTypeGet()
    		•
  • ProGtolAttachLeadersGet()
    		•
  • ProGtolAttachLeadersSet()
    		•
  • ProGtolleaderGet()
    		•
  • ProGtolleaderZExtensionlineGet()
    		•
  • ProGtolEnvelopeGetWithFlags()
    		•
  • ProGtolEnvelopeGet()
    		•
  • ProGtolleadersFree()
    		•
  • ProGtolAttachOffsetItemGet()
    		•
  • ProGtolAttachOffsetItemSet()
    		•
  • ProGtolAttachFreeGet()
    		•
  • ProGtolAttachFreeSet()
    		•
  • ProGtolleaderFree()
    		•
  • ProGtolAttachOnDatumGet()
    		•
  • ProGtolAttachOnDatumSet()
    		•
  • ProGtolAttachOnAnnotationGet()
    		•
  • ProGtolAttachOnAnnotationSet()
    		•
  • ProGtolAttachMakeDimGet()
    		•
  • ProGtolAttachMakeDimSet()
    		•
  • ProGtolMakeDimensionGet()
    		•
    The function ProGtolAttachGet() retrieves all the attachment related information for a gtol as a ProGtolAttach structure. Use the function ProGtolAttachSet() to set the attachment options. If the function ProGtolAttachSet() specifies one or more leaders, the leaders are described by a separate opaque object called ProGtolleader. This object is allocated by call to the function ProGtolleaderAlloc(). Use the function ProGtolleaderFree() to free the allocated memory.
    The function ProGtolAttachTypeGet() retrieves the type of attachment for a gtol. It uses the enumerated data type ProGtolAttachType to provide information about the placement of the gtol. The valid values are:
    •  PRO_GTOL_ATTACH_DATUM – Specifies that the gtol is placed on its reference datum.
    •  PRO_GTOL_ATTACH_ANNOTATION—Specifies that the gtol is attached to an annotation.
    •  PRO_GTOL_ATTACH_ANNOTATION_ELBOW—Specifies that the gtol is attached to the elbow of an annotation.
    •  PRO_GTOL_ATTACH_FREE—Specifies that the gtol is placed as a free. It is unattached to the model or drawing.
    •  PRO_GTOL_ATTACH_LEADERS—Specifies that the gtol is attached with one or more leader to geometry such as, edge, dimension witness line, coordinate system, axis center, axis lines, curves, or surface points, vertices, section entities, draft entities, and so on. The leaders are represented using an opaque handle, ProGtolleader.
    •  PRO_GTOL_ATTACH_OFFSET—Specifies that the gtol frame can be placed at an offset from the following drawing objects: dimension, dimension arrow, gtol, note, and symbol.
    •  PRO_GTOL_ATTACH_MAKE_DIM—Specifies that the gtol frame is attached to a dimension line.
    Use the function ProGtolAttachLeadersGet() to get attachment details for leader type of gtol. The output arguments are:
    •  plane—Specifies the annotation plane. For gtols defined in drawing, it returns NULL.
    •  type—Specifies the attachment type for the leader using the enumerated data type ProGtolLeaderAttachType.
    •  leaders—Specifies a ProArray of gtol leaders.
    •  location—Specifies the location of gtol text in model coordinates.
    Use the function ProGtolAttachSuppressedLeadersGet() to get the number of leaders that are suppressed due to missing references.
    Use the function ProGtolAttachLeadersSet() to set the attachment options for leader type of gtol.
    To unpack the information in the ProGtolleader handle, use the function ProGtolleaderGet(). After reading the leaders, free the leader array by calling ProGtolleadersFree().
    The function ProGtolleaderZExtensionlineGet() retrieves the Z-Extension line of the gtol leader. The leader location coordinates are required when the gtol is moved to a different annotation plane.
    The function ProGtolEnvelopeGetWithFlags() gets the envelope of the gtol. To retrieve coordinates of the gtol in a specified solid, if the gtol is displayed in the solid as well as in the drawing, the drawing must not be active. The input arguments are:
    •  gtol—The handle to the gtol using the object ProGtol.
    •  drawing—Specify the drawing using the object ProDrawing. Pass the value only for solid gtol shown in a drawing; otherwise, pass it as NULL.
    •  flags—Specify the gtol envelope flag using the enumerated data type ProGtolEnvelopeFlag. The value PRO_GTOL_ENVELOPE_SKIP_OUTSIDE_TEXT must be passed to get an envelope without an additional text; otherwise, pass it as PRO_GTOL_ENVELOPE_DEFAULT.
    The output argument envelope is the envelope surrounding the gtol in the model coordinate system. For flat-to-screen gtol, the envelope is in screen coordinates. For a drawing, it is in the screen coordinates. For additional texts, there is no padding.
    The function ProGtolEnvelopeGet() returns the envelope of the gtol. The output argument envelope is the envelope surrounding the gtol in the coordinate system of the model. For drawing, the envelope of the gtol is in the screen coordinates. While retrieving coordinates of the gtol in a specified solid, if the gtol is displayed in the solid as well as in the drawing, the drawing must not be active.
    The function ProGtolAttachOffsetItemGet() returns the offset references for the specified ProGtolAttach structure. The function returns the following output arguments:
    •  offset_ref—Specifies the offset reference as a ProSelection object. The reference can be a dimension, arrow of a dimension, another geometric tolerance, note, or a symbol instance. If there are no offset references, the output argument returns NULL.
    •  offset—Specifies the position of the offset reference as model coordinates.
    Use the function ProGtolAttachOffsetItemSet() to set the offset references for the specified ProGtolAttach structure.
    The function ProGtolAttachFreeGet() gets the details for free type of gtol. It retrieves information about the annotation plane and location of the gtol text in model coordinates. For gtols defined in drawing, the function returns NULL for annotation plane. Use the function ProGtolAttachFreeSet() to set the options for free type gtol.
    The functions ProGtolAttachOnDatumGet() and ProGtolAttachOnDatumSet() get and set datum symbol for the geometric tolerance. From Creo Parametric 4.0 F000 onward, datum symbols are defined using datum feature symbol. The functions work with the new datum feature symbol along with the legacy datum tag annotations.
    The function ProGtolAttachOnAnnotationGet() retrieves the annotation for the specified ProGtolAttach structure. The function ProGtolAttachOnAnnotationSet() sets the specified annotation to the attachment structure. The input arguments are:
    •  gtol_attach—Specifies the attachment structure ProGtolAttach for a geometric tolerance.
    •  p_annot—Specifies the annotation. For gtols in the solid you can set PRO_DIMENSION, PRO_GTOL, and PRO_NOTE type of annotations. For drawing gtols, you can set PRO_DIMENSION, PRO_GTOL, and PRO_NOTE type of annotations.
    •  elbow—Specifies that the annotation must be placed on the elbow of the leader instead of the gtol text. If the annotation type is set as PRO_NOTE, then you must set elbow as PRO_B_TRUE.
    The function ProGtolAttachMakeDimGet() gets all the information for a geometric tolerance created with Make Dim type of reference. Make Dim type of reference mode enables you to create a dimension line and place the gtol frame attached to it. The geometric tolerance appears in standard dimension format, but with the geometric tolerance instead of a dimension value. The output arguments are:
    •  plane—Specifies the annotation plane for the gtol.
    •  attachments_arr—Specifies the points on the model or drawing where the gtol is attached.
    •  dsense_arr—Specifies more information about how the gtol attaches to each attachment point of the model or drawing.
    •  orient_hint—Specifies the orientation of the gtol using the enumerated data type ProDimOrient. The valid values are
    ○  PRO_DIM_ORNT_HORIZ—Specifies a horizontal dimension.
    ○  PRO_DIM_ORNT_VERT—Specifies a vertical dimension.
    ○  PRO_DIM_ORNT_SLANTED—Specifies the shortest distance between two attachment points. This value is available only when the dimension is attached to points.
    ○  PRO_DIM_ORNT_ELPS_RAD1—Specifies the start radius for a dimension on an ellipse.
    ○  PRO_DIM_ORNT_ELPS_RAD2—Specifies the end radius for a dimension on an ellipse.
    ○  PRO_DIM_ORNT_ARC_ANG—Specifies the angle of the arc for a dimension of an arc.
    ○  PRO_DIM_ORNT_ARC_LENGTH—Specifies the length of the arc for a dimension of an arc.
    ○  PRO_DIM_ORNT_LIN_TANCRV_ANG—If the dimension is attached to a line and an end point of a curve, the default dimension will be a linear dimension showing the distance between the line and the curve point. Set this value if you want the dimension to show instead the angle between the line and the tangent at the curve point.
    ○  PRO_DIM_ORNT_RAD_DIFF—Specifies the linear dimension of the radial distance between two concentric arcs or circles.
    ○  PRO_DIM_ORNT_NORMAL—Specifies the linear dimension between two points to be placed normal to the selected reference.
    ○  PRO_DIM_ORNT_PARALLEL—Specifies the linear dimension between two points to be placed parallel to the selected reference.
    •  location—Specifies the location of gtol text as model coordinates.
    The function ProGtolAttachMakeDimSet() sets all the options to create a geometric tolerance with Make Dim type of reference.
    The function ProGtolMakeDimensionGet() gets the dimension of the Make Dim type of reference using a gtol object. The input argument is gtol specifies the valid geometric tolerance.
    The output argument dim returns ProDimension of Make Dim gtol.
    Deleting a Geometric Tolerance
    Function Introduced:
  • ProGtolDelete()
    		•
    The function ProGtolDelete permanently removes a gtol.
    Validating a Geometric Tolerance
    Function Introduced:
  • ProGtolValidate()
    		•
    The function ProGtolValidate checks if the specified geometric tolerance is syntactically correct. For example, when a string is specified instead of a number for a tolerance value, it is considered as syntactically incorrect. The input arguments are:
    •  gtol—Specifies the geometric tolerance to be checked.
    •  ProGtolValidityCheckType—Specifies the type of check. Currently, the tolerance is checked for correct syntax.
    Geometric Tolerance Layout
    The functions described in this section provide access to the layout for the text and symbols in a geometric tolerance.
    Functions Introduced:
  • ProGtolElbowlengthGet()
    		•
  • ProGtolLineEnvelopeGet()
    		•
  • ProGtolRightTextEnvelopeGet()
    		•
    The function ProGtolElbowlengthGet() returns the length and direction of the geometric tolerance leader elbow.
    The function ProGtolLineEnvelopeGet() returns the bounding box coordinates for one line from the geometric tolerance.
    The function ProGtolRightTextEnvelopeGet() returns the bounding box coordinates for the right text in a specified geometric tolerance.
    Note
    The functions ProGtolLineEnvelopeGet() and ProGtolRightTextEnvelopeGet() support the geometric tolerances placed on annotation planes.
    Additional Text for Geometric Tolerances
    You can place multi-line additional text to the right, left, bottom, and above a geometric tolerance control frame while creating and editing a gtol in both drawing and model modes.
    Functions Introduced:
  • ProGtolRightTextGet()
  • ProGtolRightTextSet()
    		•
  • ProGtolLeftTextGet()
    		•
  • ProGtolLeftTextSet()
    		•
  • ProGtolTopTextGet()
    		•
  • ProGtolTopTextSet()
    		•
  • ProGtolBottomTextGet()
    		•
  • ProGtolBottomTextSet()
    		•
    The function ProGtolRightTextGet() retrieves the text added to the right of the specified geometric tolerance.
    Use the function ProGtolRightTextSet() to set the text to be added to the right of the specified geometric tolerance.
    The function ProGtolLeftTextGet() retrieves the text added to the left of the specified geometric tolerance.
    Use the function ProGtolLeftTextSet() to set the text to be added to the left of the specified geometric tolerance.
    The function ProGtolTopTextGet() retrieves the text added to the top of the specified geometric tolerance.
    Use the function ProGtolTopTextSet() to set the text to be added to the top of the specified geometric tolerance.
    The function ProGtolBottomTextGet() retrieves the text added to the bottom of the specified geometric tolerance.
    Use the function ProGtolBottomTextSet() to set the text to be added to the bottom of the specified geometric tolerance.
    Note
    If the additional text extends over multiple lines, the input string must contain \n characters to indicate line breaks. The output string also contains \n characters indicating line breaks. The text added to the top of a gtol cannot extend beyond the length of the geometric tolerance control frame.
    Geometric Tolerance Text Style
    The functions described in this section access the text style properties of a geometric tolerance.
    Functions Introduced:
  • ProGtolTextstyleGet()
    		•
  • ProGtolTextstyleSet()
    		•
  • ProGtoltextTextstyleGet()
    		•
  • ProGtoltextTextstyleSet()
    		•
  • ProGtolTopTextHorizJustificationSet()
    		•
  • ProGtolTopTextHorizJustificationGet()
    		•
  • ProGtolBottomTextHorizJustificationSet()
    		•
  • ProGtolBottomTextHorizJustificationGet()
    • The function ProGtolTextstyleGet() returns the text style assigned of a specified geometric tolerance.
    The function ProGtolTextstyleSet() assigns the text style of a specified geometric tolerance.
    The function ProGtoltextTextstyleGet() retrieves the text style of the additional text applied to the specified geometric tolerance.
    The function ProGtoltextTextstyleSet() assigns the text style of the additional text applied to the specified geometric tolerance. Specify the instance of the additional text to be accessed using the enumerated data type ProGtolTextType.
    The function ProGtolTopTextHorizJustificationSet() sets the horizontal justification for the additional text applied to the specified geometric tolerance at the top.
    The function ProGtolTopTextHorizJustificationGet() retrieves the horizontal justification for the additional text applied to the specified geometric tolerance at the top.
    The function ProGtolBottomTextHorizJustificationSet() sets the horizontal justification for the additional text applied to the specified geometric tolerance at the bottom.
    The function ProGtolBottomTextHorizJustificationGet() retrieves the horizontal justification for the additional text applied to the specified geometric tolerance at the bottom.
    Prefix and Suffix for Geometric Tolerances
    You can easily add a prefix and suffix to a geometric tolerance in both drawing and model modes. They have the same text style as the geometric tolerance text.
    A prefix will be placed before the tolerance value; a suffix will be placed after the material condition, if one exists.
    Functions Introduced:
  • ProGtolPrefixGet()
    		•
  • ProGtolPrefixSet()
    		•
  • ProGtolSuffixGet()
    		•
  • ProGtolSuffixSet()
    		•
    The function ProGtolPrefixGet() obtains the prefix text for the specified geometric tolerance.
    The function ProGtolPrefixSet() assigns the prefix set for the specified geometric tolerance.
    The function ProGtolSuffixGet() obtains the suffix text for the specified geometric tolerance.
    The function ProGtolSuffixSet() assigns the suffix text for the specified geometric tolerance.
    Parameters for Geometric Tolerance Attributes
    System parameters are automatically generated for the attributes of a geometric tolerance upon the creation of the geometric tolerance. These parameters are used for downstream processes such as Coordinate Measuring Machine (CMM) operations, and in driving other annotation and feature relationships.
    Note
    Parameters are generated only for geometric tolerances created within annotation features because 2D or 3D geometric tolerances created outside annotation elements do not have a placeholder for parameters.
    The following table lists the various system parameters and the gtol attributes for which the parameters are generated:
    Parameter
    Gtol Attribute
    PTC_GTOL_PRIMAY_TOL
    Primary tolerance value
    PTC_GTOL_TYPE
    Geometric tolerance type
    PTC_GTOL_MATERIAL_CONDITION
    Material condition for the primary tolerance value
    PTC_GTOL_COMPOSITE_TOL
    Composite tolerance value; available only if the gtol type is Surface or Position
    PTC_GTOL_PERUNIT_TOL
    Pre-unit tolerance value; available only if the gtol type is Straightness, Perpendicular, Surface, Parallel, or Flatness
    PTC_GTOL_UNITLENGTH_TOL
    Unit length value; available only if the gtol type is Straightness, Perpendicular, Surface, or Parallel
    PTC_GTOL_UNITAREA_TOL
    Unit area value; available only if the gtol type is Flatness
    PTC_GTOL_PROJECTEDTOLZONE_TOL
    Projected tolerance zone value; available only if the gtol type is Angular, Perpendicular, Parallel, or Position
    PTC_GTOL_UNEQUALLYDISPOSED_TOL
    Unequally disposed tolerance value; available only if the gtol type is Surface
    You can access the parameters of gtol attributes by using the Creo TOOLKIT parameter functions ProParameter*Get() and ProParameter*Set(), and the UDF placement functions related to variable parameters ProUdfvarparam*() and ProUdfdataVarparamAdd(). Refer to the section Core: Parameters for more information on parameters.