Customizing Weld Drawing Symbols
Functions introduced:
This section describes three notification functions invoked by Creo+ when the user instantiates a weld symbol that documents a weld in drawing mode. Your callback functions can output information which is used to modify the weld symbol that appears on the drawing. The effect is to allow much greater customization of the appearance of the weld symbol than is possible without Creo TOOLKIT .
|
Note:
|
From Pro/ENGINEER Wildfire 5.0 onward, you can also create weld symbols in weld features as 3D Symbol Annotation Elements. Creo TOOLKIT allows you to access the Weld Symbol Annotation Elements using exisitng ProAnnotation*() functions. For more information on the functions, refer the Annotations: Annotation Features and Annotations section. |
Each callback has input arguments which identify the drawing, the weld assembly, the weld feature being annotated, and the path to the drawing symbol being used. The functions for read-access to welds, described in the previous section, would be used inside the callbacks to find out about the weld being annotated.
Refer to the
Event-driven Programming: Notifications section for more data on how to set a notification.
Weld symbol notification types are:
• PRO_DRAWING_WELD_SYMPATH_GET—allows the callback function to override the entire weld symbol by specifying the path and file name of a substitute symbol.
• PRO_DRAWING_WELD_GROUPIDS_GET—allows the callback to selectively include or exclude symbol groups contained in the symbol. Additional inputs to the callback are a flag to show which way the symbol will point (left or right) and an array of the names of the groups in the symbol; the output is an array of booleans which select the groups to be included.
• PRO_DRAWING_WELD_SYMTEXT_GET—allows the callback to substitute for variable text in the symbol.
All three notifications can be set at the same time, allowing you to use your own set of generic symbols which are designed to be customized according to the weld type and properties.
Example 1: Weld Callback Notification
The sample code in UgWeld.c located at <creo_toolkit_loadpoint>/protk_appls/pt_userguide/ptu_weld shows how to use weld callback notification functions.