BrepFace

compute_rhino3d.BrepFace.PullPointsToFace(thisBrepFace, points, tolerance, multiple=False)

Pulls one or more points to a brep face.

Parameters:
  • points (list[rhino3dm.Point3d]) – Points to pull.
  • tolerance (float) – Tolerance for pulling operation. Only points that are closer than tolerance will be pulled to the face.
  • multiple (bool) – (default False) If True, all parameters are expected as lists of equal length and input will be batch processed
Returns:

An array of pulled points.

Return type:

rhino3dm.Point3d[]

compute_rhino3d.BrepFace.DraftAnglePoint(thisBrepFace, testPoint, testAngle, pullDirection, edge, multiple=False)

Returns the surface draft angle and point at a parameter.

Parameters:
  • testPoint (rhino3dm.Point2d) – The u,v parameter on the face to evaluate.
  • testAngle (float) – The angle in radians to test.
  • pullDirection (rhino3dm.Vector3d) – The pull direction.
  • edge (bool) – Restricts the point placement to an edge.
  • multiple (bool) – (default False) If True, all parameters are expected as lists of equal length and input will be batch processed
Returns:

True if successful, False otherwise.

Return type:

bool

compute_rhino3d.BrepFace.RemoveHoles(thisBrepFace, tolerance, multiple=False)

Remove all inner loops, or holes, from a Brep face.

Parameters:multiple (bool) – (default False) If True, all parameters are expected as lists of equal length and input will be batch processed
Return type:rhino3dm.Brep
compute_rhino3d.BrepFace.Split(thisBrepFace, curves, tolerance, multiple=False)

Split this face using 3D trimming curves.

Parameters:
  • curves (list[rhino3dm.Curve]) – Curves to split with.
  • tolerance (float) – Tolerance for splitting, when in doubt use the Document Absolute Tolerance.
  • multiple (bool) – (default False) If True, all parameters are expected as lists of equal length and input will be batch processed
Returns:

A brep consisting of all the split fragments, or None on failure.

Return type:

rhino3dm.Brep

compute_rhino3d.BrepFace.IsPointOnFace(thisBrepFace, u, v, multiple=False)

Tests if a parameter space point is on the interior of a trimmed face.

Parameters:
  • u (float) – Parameter space point u value.
  • v (float) – Parameter space point v value.
  • multiple (bool) – (default False) If True, all parameters are expected as lists of equal length and input will be batch processed
Returns:

A value describing the spatial relationship between the point and the face.

Return type:

PointFaceRelation

compute_rhino3d.BrepFace.TrimAwareIsoIntervals(thisBrepFace, direction, constantParameter, multiple=False)

Gets intervals where the iso curve exists on a BrepFace (trimmed surface)

Parameters:
  • direction (int) – Direction of isocurve. 0 = Isocurve connects all points with a constant U value.1 = Isocurve connects all points with a constant V value.
  • constantParameter (float) – Surface parameter that remains identical along the isocurves.
  • multiple (bool) – (default False) If True, all parameters are expected as lists of equal length and input will be batch processed
Returns:

If direction = 0, the parameter space iso interval connects the 2d points (intervals[i][0],iso_constant) and (intervals[i][1],iso_constant). If direction = 1, the parameter space iso interval connects the 2d points (iso_constant,intervals[i][0]) and (iso_constant,intervals[i][1]).

Return type:

rhino3dm.Interval[]

compute_rhino3d.BrepFace.TrimAwareIsoCurve(thisBrepFace, direction, constantParameter, multiple=False)

Similar to IsoCurve function, except this function pays attention to trims on faces and may return multiple curves.

Parameters:
  • direction (int) – Direction of isocurve. 0 = Isocurve connects all points with a constant U value.1 = Isocurve connects all points with a constant V value.
  • constantParameter (float) – Surface parameter that remains identical along the isocurves.
  • multiple (bool) – (default False) If True, all parameters are expected as lists of equal length and input will be batch processed
Returns:

Isoparametric curves connecting all points with the constantParameter value.

Return type:

rhino3dm.Curve[]

compute_rhino3d.BrepFace.ChangeSurface(thisBrepFace, surfaceIndex, multiple=False)

Expert user tool that replaces the 3d surface geometry use by the face.

Parameters:
  • surfaceIndex (int) – brep surface index of new surface.
  • multiple (bool) – (default False) If True, all parameters are expected as lists of equal length and input will be batch processed
Returns:

True if successful.

Return type:

bool

compute_rhino3d.BrepFace.RebuildEdges(thisBrepFace, tolerance, rebuildSharedEdges, rebuildVertices, multiple=False)

Rebuild the edges used by a face so they lie on the surface.

Parameters:
  • tolerance (float) – tolerance for fitting 3d edge curves.
  • rebuildSharedEdges (bool) – if False and and edge is used by this face and a neighbor, then the edge will be skipped.
  • rebuildVertices (bool) – if true, vertex locations are updated to lie on the surface.
  • multiple (bool) – (default False) If True, all parameters are expected as lists of equal length and input will be batch processed
Returns:

True on success.

Return type:

bool