fmeobjects.FMEGeometryTools.triangulateToSurface

FMEGeometryTools.triangulateToSurface()

triangulateToSurface(geometry),

This routine will return a FMEGeometry object with triangle faces. This feature can support all geometries except for FMEAggregate, FMECSGSolid, FMECompositeSolid and FMEMultiSolid. The output FMEGeometry is never None. The resulting FMEGeometry is not guaranteed to contain only triangles, so it is the user’s responsiblity to check this. The geometry type of the returned FMEGeometry object depends on the type of input geometry:

• If the input is a FMETriangleStrip, FMETriangleFan, or FMEFace that is already triangular, the resulting FMEGeometry is a copy of the input geometry and hence has the same geometry type as the input.

• If the input is a sliver face, the resulting FMEGeometry is a copy of the original geometry.

• If the input is a non-triangular and non-sliver Face, non-triangular Area, or RectangleFace, the resulting FMEGeometry is a FMECompositeSurface, whose components are triangular Faces. Otherwise the component is a FMECompositeSurface consisting of triangular Faces.

• If the input is a CompositeSurface, the resulting FMEGeometry is a FMECompositeSurface. The type of each component in the resulting FMECompositeSurface is determined as described above.

• If the input is a MultiSurface, the resulting FMEGeometry is a FMEMultiSurface. The type of each component in the resulting FMEMultiSurface is determined as described above.

• If the input is a Box, Extrusion, or BRepSolid, the resulting FMEGeometry is a FMEBRepSolid.

• If the input is a MultiArea, the resulting IFMEGeometry is a FMEMultiSurface. The type of each component in the resulting FMEMultiSurface is determined as described above.

• If the input is a Mesh, the resulting FMEGeometry is a FMEMultiSurface.

• For the case of FMEArea, the triangulation will occur with respect to the x- and y-coordinates, the z values are ignored, yet they will be retained in the output. If there are any errors an exception will be thrown.

Parameters:

geometry (FMEGeometry) – The geometry to triangulate to the surface.

Return type:

FMEGeometry

Returns:

Note: This method returns a terminal geometry type of the FMEGeometry; i.e. one of the leaf classes in the FMEGeometry inheritance graph. For example, a FMETriangleStrip is returned if the geometry truly is a triangle strip.

Raises:

FMEException – An exception is raised if an error occurred.