Geometric References
items use a geometric reference structure to contain references to geometry items. This structure is represented in by the opaque handle ProMechGeomref.
Functions Introduced:
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.