MeshSplitOptions

MeshBooleanOptions

Contains a set of data to pass to mesh splitting operations.

Remarks: This is the base of MeshBooleanOptions, so an instance used for mesh booleans can also be passed to the splitting methods that take these options.

Properties

CancellationToken

#Since v8.0

public CancellationToken CancellationToken { get; set; }

A token that allows to request the cancellation of the operation.

CompleteOpenCuts

#Since v9.0

public bool CompleteOpenCuts { get; set; }

Gets or sets whether cuts that stop inside the mesh are completed.

An intersection curve that stops inside the mesh does not separate one side from the other, so the mesh is returned whole. When this is enabled, each such open end is joined to the nearest border of the mesh, or to another cut, by the shortest path along existing edges or straight across a quad or an n-gon between two of its vertices.

This yields a best-effort cut where the intersection alone leaves the answer undetermined: the added stretch follows the mesh rather than the cutter, so it is not an intersection result. No vertex is added or moved; faces crossed straight are re-tiled from their own vertices. Cuts that already close, or that already run from border to border, are unaffected.

Value: The default value is false.

CreateNgons

#Since v9.0

public bool CreateNgons { get; set; }

Gets or sets whether ngons are created along the split ridge, to preserve the boundary look.

Value: The default value is true.

OpenCutEnds

#Since v9.0

public Point3d[] OpenCutEnds { get; }

Gets the ends of the intersections that stop inside a mesh, as found by the last operation that used these options: empty when there were none, null when RequestOpenCutEnds was disabled.

ProgressReporter

#Since v8.0

public IProgress<double> ProgressReporter { get; set; }

Gets or sets the object that is responsible to keep track of calculation progression.

RequestOpenCutEnds

#Since v9.0

public bool RequestOpenCutEnds { get; set; }

Gets or sets whether the operation reports where intersections stop inside a mesh it splits.

Such a cut separates nothing. When this is enabled, OpenCutEnds holds the ends of those cuts after the call. Nothing is computed when it is disabled.

Value: The default value is false.

SplitAtCoplanar

#Since v9.0

public bool SplitAtCoplanar { get; set; }

Gets or sets whether coplanar areas are separated. If false, coplanar areas will not be separated.

Value: The default value is true.

TextLog

#Since v8.0

public TextLog TextLog { get; set; }

Gets or sets a text log to write computed operations into.

Tolerance

#Since v8.0

public double Tolerance { get; set; }

Gets or sets a tolerance value for intersections and overlaps. Intersection.MeshIntersectionsTolerancesCoefficient

Value: The default value is RhinoMath.ZeroTolerance*10. However, this is only a reference value for testing and geometry developers should generally use the document tolerance, multiplied by Intersection.MeshIntersectionsTolerancesCoefficient.