Geometric References
Creo Simulate items use a geometric reference structure to contain references to Creo+ geometry items. This structure is represented in Creo TOOLKIT by the opaque handle ProMechGeomref.
Functions Introduced:
• ProMechgeomrefAlloc()
• ProMechgeomrefTypeGet()
• ProMechgeomrefSubtypeGet()
• ProMechgeomrefIdGet()
• ProMechgeomrefPathGet()
• ProMechgeomrefFree()
• ProMechgeomrefProarrayFree()
• ProMechgeomrefTypeSet()
• ProMechgeomrefSubtypeSet()
• ProMechgeomrefIdSet()
• ProMechgeomrefPathSet()
The function ProMechgeomrefAlloc() allocates memory for the geometric entity. The function returns a handle to the geometric entity.
The function ProMechgeomrefTypeGet() returns the type for the specified geometric entity. The output argument type can have one of the following values:
• PRO_MECH_POINT—Specifies a point.
• PRO_MECH_EDGE—Specifies an edge.
• PRO_MECH_SURFACE—Specifies a surface.
• PRO_MECH_VERTEX—Specifies a vertex.
• PRO_MECH_QUILT—Specifies a quilt.
• PRO_MECH_BOUNDARY—Specifies a boundary. This type is valid for all surfaces.
• PRO_MECH_CURVE—Specifies a curve.
• PRO_MECH_MODEL—Specifies a model. This type is valid for all parts and assemblies.
• PRO_MECH_AXIS—Specifies the axis.
• PRO_MECH_COORD_SYSTEM—Specifies the coordinate system.
• PRO_MECH_LAYER—Specifies a layer.
• PRO_MECH_VOLUME—Specifies a set of associated surfaces that visually represents an entity with volume.
• PRO_MECH_INT*—Specifies the datum reference features that store the design intent objects. Intent objects are families of associated points, curves, edges, or surfaces that logically define boundaries of geometry created or modified by a feature. The types of datum reference features available are:
◦ PRO_MECH_INT_PNT—Specifies intent datum point references.
◦ PRO_MECH_INT_CURVE—Specifies intent curve references.
◦ PRO_MECH_INT_EDGE—Specifies intent edge references.
◦ PRO_MECH_INT_SURFACE—Specifies intent surface references.
• PRO_MECH_FEAT—Specifies the references to a Weld Feature. The weld feature should be of type:
◦ Groove or Fillet
◦ A surface weld
• PRO_MECH_COSMETIC—Specifies a cosmetic entity that is created as a container for lattice beams or walls. The cosmetic entities are created by simplified lattice features, and also by features that intersect or copy the lattices, such as extrude and mirror features.
• PRO_MECH_BODY—Specifies a body.
The function ProMechgeomrefTypeSet() sets the type of the geometric entity.
The function ProMechgeomrefSubtypeGet() returns the subtypes of the specified geometric entity. Only certain types of geometric entities require subtypes. The geometric entity types and their respective subtypes are as follows:
• PRO_MECH_POINT
◦ PRO_MECH_POINT_SINGLE—Specifies the placement of a point at any location.
◦ PRO_MECH_POINT_FEATURE—Specifies the placement of a point along a surface.
◦ PRO_MECH_POINT_PATTERN—Specifies the placement of a point along a curve.
• PRO_MECH_VERTEX
◦ PRO_MECH_VERTEX_EDGE_START—Specifies the start point of the referenced edge.
◦ PRO_MECH_VERTEX_EDGE_END—Specifies the end point of the referenced edge.
• PRO_MECH_COORD_SYSTEM
◦ PRO_MECH_CSYS_CARTESIAN—Specifies a Cartesian coordinate system.
◦ PRO_MECH_CSYS_CYLINDRICAL—Specifies a cylindrical coordinate system.
◦ PRO_MECH_CSYS_SPHERICAL—Specifies a spherical coordinate system.
• PRO_MECH_SURFACE
◦ PRO_MECH_SURFACE_NORMAL—Specifies that the surface reference uses the standard normal direction.
◦ PRO_MECH_SURFACE_REVERSED—Specifies that the surface reference uses the standard normal direction.
• PRO_MECH_CURVE
◦ PRO_MECH_CURVE_NORMAL—Specifies that the curve proceeds in the default direction (from t=0 to t=1).
◦ PRO_MECH_CURVE_REVERSED—Specifies that the curve reference uses the reverse direction of the curve.
• PRO_MECH_EDGE
◦ PRO_MECH_EDGE_SURF_0
◦ PRO_MECH_EDGE_SURF_1
• PRO_MECH_FEAT
◦ PRO_MECH_FEAT_3D_LATT—Specifies a 3D lattice.
◦ PRO_MECH_FEAT_2P5D_LATT—Specifies a 2.5D lattice.
The function ProMechgeomrefSubtypeSet() sets the subtypes for the specified geometric entity.
The function ProMechgeomrefIdGet() returns the ID of the specified entity.
The function ProMechgeomrefIdSet() sets the ID of the specified entity.
The function ProMechgeomrefPathGet()returns the complete path of the assembly-component references from the root assembly to the part or assembly that owns the specified geometric reference entity.
The function ProMechgeomrefPathSet()sets the complete path of the assembly-component references.
Use the function ProMechgeomrefFree()o free the geometric reference entity from the memory.
Use the function ProMechgeomrefProarrayFree()to free the array of geometric entities from the memory.