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.ShrinkSurfaceToEdge(thisBrepFace, multiple=False)

Shrinks the underlying untrimmed surface of this Brep face right to the trimming boundaries. Note, shrinking the trimmed surface can sometimes cause problems later since having the edges so close to the trimming boundaries can cause commands that use the surface edges as input to fail.

Parameters: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, False on failure.
Return type:bool
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