geometry_simplify_mesh
Simplifies a mesh to a smaller, similar looking mesh. Note that if your mesh vertices are not connected you may need to call the geometry_weld_mesh command first to get good results.
References:
arguments
- "boundary_approx_weight" : Float32 (default: 1)
Specifies a positive weight of the cost for the approximation of the mesh boundary. The higher the value, the better the shape of the boundary will be preserved compared to the inner parts of the mesh. This option has no effect if keep_boundary is set to true.
- "boundary_feature_weight" : Float32 (default: 1)
This option allows to control the sensitivity of the decimator with respect to sharp corners on the boundary. Increasing this value will tell the algorithm to preserve these features more precisely. Its value has to be positive. This option has no effect if keep_boundary is set to true.
- "feature_angle_threshold" : Float32 (default: 0.314159)
This option specifies an angular threshold for feature edges. If the dihedral angle of two faces incident to an edge is smaller than this value, the edge is treated as a feature edge, which prohibits simplification operations across the edge. Coarsing operations along the edge are however still allowed.
- "keep_boundary" : Boolean (default: true)
By default topological boundaries are strictly preserved. If this option is turned off, boundaries may be simplified as well.
- "mesh_name" : String
Name of the mesh object. Must be a Triangle_mesh or Polygon_mesh object. Polygon_mesh objects will be tessellated prior to simplification.
- "simplified_mesh_name" : String
Name of Triangle_mesh object to create by simplifying the input mesh.
- "target_fraction" : Float32 (default: 0)
Specifies the resulting target mesh size in number of triangles as a relative fraction of the input mesh size. Values outside the range of [0, 1] are clamped. The algorithm simplifies the mesh to at most the target size. Other criteria, such as "target_quality" and topological restrictions may stop the simplification earlier. The default setting of 0.0 thus asks the simplification to simplify as much as possible given the other quality constraints.
- "target_quality" : Float32 (default: 0)
Specifies the quality of the simplified mesh. Increasing this value reduces the amount of simplification, i.e., increases fidelity compared to the input model. Useful values are in the range of 0.0 and 1.0, but also higher values might be used in rare cases. Values below 0.0 are clamped. This parameter is independent of the size of the object. The algorithm simplifies the mesh to at most the given quality bound.Other criteria, such as "target_fraction" and topological restrictions may stop the simplification earlier.The default setting of 0.0 thus asks the simplification to simplify as much as possible given the other constraints.