The Mesh objects can be manipulated by adding new facets, deleting facets, importing from an STL file, transforming the mesh and much more. For a complete overview of what can be done see also the Mesh Workbench documentation. A mesh object cannot be added to an existing document directly. Therefore the document must create an object with a property class that supports meshes. Example:
m = Mesh.Mesh()
... # Manipulate the mesh
d = FreeCAD.activeDocument() # Get a reference to the actie document
f = d.addObject("Mesh::Feature", "Mesh") # Create a mesh feature
f.Mesh = m # Assign the mesh object to the internal property
d.recompute()
addFacet(Facet)Description: Adds a facet to the mesh
Returns:
addFacets(list)Description: Adds a list of facets to the mesh
Returns:
addMesh(Mesh)Description: Combines this mesh with another mesh.
Returns:
clear( )Description: Clears the mesh
Returns:
coarsen( )Description: Coarsens the mesh
Returns:
collapseEdge(Edge)Description: Removes an edge and both facets that share this edge
Returns:
collapseFacet(Facet)Description: Removes a facet
Returns:
collapseFacets(list)Description: Removes a list of facets
Returns:
copy( )Description: Creates a copy of this mesh
Returns: a Mesh object
countComponents( )Description: Get the number of topological independent areas
Returns: an integer
countNonUniformOrientedFacets( )Description: Get the number of wrong oriented facets
Returns: an integer
countSegments( )Description: Get the number of segments which may also be 0
Returns: an integer
crossSections( )Description: Get cross-sections of the mesh through several planes
Returns:
difference(Mesh)Description: Difference of this and the given mesh object.
Returns:
fillupHoles( )Description: Fillup holes
Returns:
fixDeformations( )Description: Repair deformed facets
Returns:
fixDegenerations( )Description: Remove degenerated facets
Returns:
fixIndices( )Description: Repair any invalid indices
Returns:
fixSelfIntersections( )Description: Repair self-intersections
Returns:
flipNormals( )Description: Flip the mesh normals
Returns:
foraminate( )Description: Get a list of facet indices and intersection points
Returns:
getPlanes( )Description: Get all planes of the mesh as segment. In the worst case each triangle can be regarded as single plane if none of its neighbors is coplanar.
Returns:
getSegment(integer)Description: Get a list of facet indices that describes a segment
Returns:
getSeparateComponents( )Description: Returns a list containing the different components (separated areas) of the mesh as separate meshes
Returns: a list
harmonizeNormals( )Description: Adjust wrong oriented facets
Returns:
hasNonManifolds( )Description: Check if the mesh has non-manifolds
Returns: a boolean
hasNonUniformOrientedFacets( )Description: Checks if the mesh has facets with inconsistent orientation
Returns:
hasSelfIntersections( )Description: Check if the mesh intersects itself
Returns:
inner( )Description: Get the part inside of the intersection
Returns:
insertVertex(Vertex)Description: Inserts a vertex into a facet
Returns:
intersect(Mesh)Description: Intersection of this and the given mesh object.
Returns:
isSolid( )Description: Check if the mesh is a solid
Returns:
meshFromSegment( )Description: Create a mesh from segment
Returns:
nearestFacetOnRay(tuple, tuple)Description: Get the index and intersection point of the nearest facet to a ray. The first parameter is a tuple of three floats the base point of the ray, the second parameter is ut uple of three floats for the direction. The result is a dictionary with an index and the intersection point or an empty dictionary if there is no intersection.
Returns: a dictionary
offset(float)Description: Move the point along their normals
Returns:
offsetSpecial(float)Description: Move the point along their normals
Returns:
optimizeEdges( )Description: Optimize the edges to get nicer facets
Returns:
optimizeTopology( )Description: Optimize the edges to get nicer facets
Returns:
outer( )Description: Get the part outside the intersection
Returns:
printInfo( )Description: Get detailed information about the mesh
Returns:
read( )Description: Read in a mesh object from file.
Returns:
refine( )Description: Refine the mesh
Returns:
removeComponents(integer)Description: Remove components with less or equal to number of given facets
Returns:
removeDuplicatedFacets( )Description: Remove duplicated facets
Returns:
removeDuplicatedPoints( )Description: Remove duplicated points
Returns:
removeFacets(list)Description: Remove a list of facet indices from the mesh
Returns:
removeFoldsOnSurface( )Description: Remove folds on surfaces
Returns:
removeNonManifolds( )Description: Remove non-manifolds
Returns:
rotate( )Description: Apply a rotation to the mesh
Returns:
setPoint(int, Vector)Description: Sets the point at index.
Returns:
smooth( )Description: Smooth the mesh
Returns:
snapVertex( )Description: Insert a new facet at the border
Returns:
splitEdge( )Description: Split edge
Returns:
splitEdges( )Description: Split all edges
Returns:
splitFacet( )Description: Split facet
Returns:
swapEdge( )Description: Swap the common edge with the neighbor
Returns:
transform( )Description: Apply a transformation to the mesh
Returns:
transformToEigen( )Description: Transform the mesh to its eigenbase
Returns:
translate(Vector)Description: Apply a translation to the mesh
Returns:
unite(Mesh)Description: Union of this and the given mesh object.
Returns:
write(string)Description: Write the mesh object into file.
Returns:
writeInventor( )Description: Write the mesh in OpenInventor format to a string.
Returns: a string
AreaReturns: the area of the mesh object.
CountEdgesReturns: the number of vertices of the mesh object.
CountFacetsReturns: the number of facets of the mesh object.
CountPointsReturns: the number of points of the mesh object.
FacetsReturns: A collection of facets; With this attribute it is possible to get access to the facets of the mesh: for f in mesh.Facets: print f. Facet.Points is a list of coordinate-tupels for the vertices. Facet.PointIndices is a list of indice for the vertices of the facet. WARNING! store Facets in a local variable as it is generated on the fly, each time it is accessed.
PointsReturns: A collection of the mesh points; With this attribute it is possible to get access to the points of the mesh: for p in mesh.Points: print p.x, p.y, p.z,p.Index.WARNING! store Points in a local variable as it is generated on the fly, each time it is accessed.
TopologyReturns: the points and face indices as tuple. Topology[0] is a list of all vertices. Each being a tuple of 3 coordinates. Topology[1] is a list of all polygons. Each being a list of vertex indice into Topology[0] WARNING! store Topology in a local variable as it is generated on the fly, each time it is accessed.
VolumeReturns: the volume of the mesh object.
BoundBoxReturns: the BoundBox of the object
MatrixReturns: the current transformation of the object as matrix
PlacementReturns: the current transformation of the object as placement
This page is retrieved from https://wiki.freecad.org/Mesh_API