{"id":2743,"date":"2017-10-10T02:28:48","date_gmt":"2017-10-10T09:28:48","guid":{"rendered":"https:\/\/blogs.plm.automation.siemens.com\/t5\/Solid-Edge-Blog\/3D-Geometry-API-A-Gentle-Introduction\/ba-p\/438144"},"modified":"2026-03-26T07:29:51","modified_gmt":"2026-03-26T11:29:51","slug":"3d-geometry-api-a-gentle-introduction","status":"publish","type":"post","link":"https:\/\/blogs.sw.siemens.com\/solidedge\/3d-geometry-api-a-gentle-introduction\/","title":{"rendered":"3D Geometry API – A Gentle Introduction"},"content":{"rendered":"

Among tangible or visible geometric elements, the prominently accessed collections in a Part or Sheetmetal document are the Features, Sketches, Profiles, PMI and the Reference Planes. The most sought after automation requirements include parametric updating of models or creation of simple parts involving sketches that are extruded or revolved.<\/SPAN><\/P>
\n

  <\/SPAN><\/P>
\n

It is rare for a designer who is also typically a Mechanical guy having specialized as an automation programmer caring to think about diving into low level geometry like the faces, edges and vertices to manipulate model geometry in a more powerful and direct manner. <\/SPAN><\/P><\/p>\n

But once you know how to extract and use it, the possibilities are endless. Some common examples would be custom composite holes or Sheetmetal punch shapes. A scenario of a custom composite hole would be a .150 diameter counterbore with a depth of .200.  At the bottom of the counterbore is a thru hole of .050 diameter with a nearside countersink of .070 diameter.<\/SPAN><\/P><\/p>\n

\"01_Custom_Composite_Hole.png\"<\/span> <\/SPAN><\/P>
\n

Although this article does not aim to show you all the geometric calculations and APIs involved in achieving such composite holes, it is a beginning in the right direction.<\/SPAN><\/P><\/p>\n

Note the additional Solid Edge Geometry reference that must be added which provides for the meaty part of the API involved in 3D geometry access and manipulation:<\/SPAN><\/P><\/p>\n

 \"05_References.png\"<\/span><\/SPAN><\/P><\/p>\n

Faces and Edges can be accessed for the entire model using the workflow below:<\/SPAN><\/P><\/p>\n

Dim seApp As SolidEdgeFramework.Application = GetActiveObject(“SolidEdge.Application”)
\nDim seDoc As SolidEdgePart.PartDocument = seApp.ActiveDocument
\n 
\nDim seModel As Model = seDoc.Models(0)
\nDim seBody As Body = seModel.Body
\n 
\nDim seFaces As Faces = seBody.Faces(FeatureTopologyQueryTypeConstants.igQueryAll)
\nDim seEdges As Edges = seBody.Edges(FeatureTopologyQueryTypeConstants.igQueryAll)<\/PRE><\/p>\n
The FeatureTopologyQueryTypeConstants come from the SolidEdgeGeometry reference.<\/SPAN><\/P>
\n
The other possible filters are:<\/SPAN><\/P><\/p>\n
 \"03_Query.png\"<\/span><\/SPAN><\/P><\/p>\n
You can either query all faces or edges using igQueryAll and then check each one using its Geometry property in a loop as below:<\/SPAN><\/P><\/p>\n
Dim seFace As Face
\n 
\nFor i As Integer = 0 To seFaces.Count – 1
\nseFace = seFaces.Item(i)
\n  If TypeOf (seFace.Geometry) Is SolidEdgeGeometry.Plane Then
\n    Debug.WriteLine(seFace.Area)
\n  End If
\nNext<\/PRE><\/p>\n
Similarly, to check edges you use the Geometry property as shown next. <\/SPAN><\/P>
\n
\"02_TipIcon.png\"<\/span> Note how the geometry is compared with Line<\/EM> and not<\/STRONG> with Line2D<\/EM> from the SolidEdgeFrameworkSupport library. These two are entirely different species.<\/SPAN><\/P><\/p>\n
For Each seEdge As Edge In seEdges
\n  If TypeOf seEdge.Geometry Is Line Then
\n    Debug.WriteLine(GetEdgeLength(seEdge))
\n  End If
\nNext<\/PRE><\/p>\n
Where the GetEdgeLength function looks like:<\/SPAN><\/P>
\n
 <\/SPAN> <\/P>
\n
Public Function GetEdgeLength(ByVal seEdge As Edge) As Double
\n  Dim StartVertex As Vertex = seEdge.StartVertex()
\n  Dim EndVertex As Vertex = seEdge.EndVertex
\n 
\n  Dim StartVertexCoordinates(2) As Double
\n  StartVertex.GetPointData(StartVertexCoordinates)
\n 
\n  Dim EndVertexCoordinates(2) As Double
\n  EndVertex.GetPointData(EndVertexCoordinates)
\n 
\n  Dim StartX As Double = StartVertexCoordinates(0)
\n  Dim StartY As Double = StartVertexCoordinates(1)
\n  Dim StartZ As Double = StartVertexCoordinates(2)
\n 
\n  Dim EndX As Double = EndVertexCoordinates(0)
\n  Dim EndY As Double = EndVertexCoordinates(1)
\n  Dim EndZ As Double = EndVertexCoordinates(2)
\n 
\n  Dim EdgeLength As Double
\n  EdgeLength = Math.Sqrt((StartX – EndX) ^ 2 + (StartX – EndY) ^ 2 + (StartXZ – EndZ) ^ 2)
\n 
\n  Return EdgeLength
\nEnd Function<\/PRE>
\n
Another shorter method of getting the length of an edge is using the GetLengthAtParam function:<\/SPAN><\/P><\/p>\n
Dim seEdges As Edges = seBody.Edges(FeatureTopologyQueryTypeConstants.igQueryAll)
\n  
Dim EdgeLength As Double, MinParam As Double, MaxParam As Double
  
For Each seEdge As Edge In seEdges
\n  If TypeOf seEdge.Geometry Is Line Then
    seEdge.GetParamExtents(MinParam, MaxParam)
    seEdge.GetLengthAtParam(MinParam, MaxParam, EdgeLength)
\n    Debug.WriteLine(EdgeLength)
\n  End If
\nNext<\/PRE><\/p>\n
In the function for getting the edge length you also get a quick introduction to the Vertex object. The function also shows there are direct functions to get the start and end vertex of an edge.<\/SPAN><\/P>
\n
All vertices of the body can be accessed simply using with no additional parameters:<\/SPAN><\/P><\/p>\n
Dim seVertices As Vertices = seBody.Vertices()
\nDebug.WriteLine(seVertices.Count)<\/PRE><\/p>\n
Similarly, vertices for one specific face can be extracted using:<\/SPAN><\/P><\/p>\n
seFace = seFaces.Item(0)
\nseVertices = seFace.Vertices
\nDebug.WriteLine(seVertices.Count)<\/PRE><\/p>\n
Further, there are faces attached to an edge which can be obtained as below:<\/SPAN><\/P><\/p>\n
Dim seFaceArray() As Object = { }
\nDim FaceCount As Integer
\nDim seEdge As Edge = seEdges.Item(0)<\/p>\n
seEdge.GetFaces(FaceCount, seFaceArray)<\/PRE><\/p>\n
When you debug the above lines of code, note that the number of faces associated with an edge are always 2 so FaceCount will be 2<\/P><\/p>\n
 \"04_FaceCount.png\"<\/span><\/SPAN><\/P>
\n
Finally there are edges and faces attached to a vertex which can be obtained as below:<\/SPAN><\/P><\/p>\n
Dim seVertex As Vertex = seVertices.Item(0)<\/p>\n
seEdges = seVertex.Edges()
\nseFaces = seVertex.Faces<\/PRE><\/p>\n
This shows that the Geometry objects like Faces, Edges and Vertices do not have a hierarchical structure like the other objects in the Solid Edge object model.<\/EM><\/P><\/p>\n
In the next part of this article learn about:<\/SPAN><\/P><\/p>\n

    \n
  1. What are Edge and Face IDs.<\/li>\n
  2. How to reliably extract a face from its ID when the face is modified.<\/li>\n
  3. Extracting Edges and faces of features.<\/li>\n
  4. Special faces and edges of features.<\/li>\n
  5. Highlighting edges, faces and vertices.<\/li>\n
  6. How to use the TopoTools free tool to identify and highlight faces, edges and vertices.<\/li>\n
    <\/OL><\/p>\n","protected":false},"excerpt":{"rendered":"
    Among tangible or visible geometric elements, the prominently accessed collections in a Part or Sheetmetal document are the Features, Sketches, Profiles, PMI and the Reference Planes. The most sought…<\/p>\n","protected":false},"author":42979,"featured_media":2758,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"spanish_translation":"","french_translation":"","german_translation":"","italian_translation":"","polish_translation":"","japanese_translation":"","chinese_translation":"","footnotes":""},"categories":[1,96],"tags":[33],"industry":[],"product":[],"coauthors":[],"class_list":["post-2743","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-news","category-tips-tricks","tag-developer"],"featured_image_url":"https:\/\/blogs.sw.siemens.com\/wp-content\/uploads\/sites\/8\/2019\/09\/02_TipIcon-1.png","_links":{"self":[{"href":"https:\/\/blogs.sw.siemens.com\/solidedge\/wp-json\/wp\/v2\/posts\/2743","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blogs.sw.siemens.com\/solidedge\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blogs.sw.siemens.com\/solidedge\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blogs.sw.siemens.com\/solidedge\/wp-json\/wp\/v2\/users\/42979"}],"replies":[{"embeddable":true,"href":"https:\/\/blogs.sw.siemens.com\/solidedge\/wp-json\/wp\/v2\/comments?post=2743"}],"version-history":[{"count":6,"href":"https:\/\/blogs.sw.siemens.com\/solidedge\/wp-json\/wp\/v2\/posts\/2743\/revisions"}],"predecessor-version":[{"id":2760,"href":"https:\/\/blogs.sw.siemens.com\/solidedge\/wp-json\/wp\/v2\/posts\/2743\/revisions\/2760"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/blogs.sw.siemens.com\/solidedge\/wp-json\/wp\/v2\/media\/2758"}],"wp:attachment":[{"href":"https:\/\/blogs.sw.siemens.com\/solidedge\/wp-json\/wp\/v2\/media?parent=2743"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blogs.sw.siemens.com\/solidedge\/wp-json\/wp\/v2\/categories?post=2743"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blogs.sw.siemens.com\/solidedge\/wp-json\/wp\/v2\/tags?post=2743"},{"taxonomy":"industry","embeddable":true,"href":"https:\/\/blogs.sw.siemens.com\/solidedge\/wp-json\/wp\/v2\/industry?post=2743"},{"taxonomy":"product","embeddable":true,"href":"https:\/\/blogs.sw.siemens.com\/solidedge\/wp-json\/wp\/v2\/product?post=2743"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/blogs.sw.siemens.com\/solidedge\/wp-json\/wp\/v2\/coauthors?post=2743"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}