RhinoCompute.BrepFace¶
-
RhinoCompute.BrepFace.pullPointsToFace(thisBrepFace, points, tolerance, multiple=false)¶ Pulls one or more points to a brep face.
Arguments: - 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[]
-
RhinoCompute.BrepFace.draftAnglePoint(thisBrepFace, testPoint, testAngle, pullDirection, edge, multiple=false)¶ Returns the surface draft angle and point at a parameter.
Arguments: - 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
-
RhinoCompute.BrepFace.removeHoles(thisBrepFace, tolerance, multiple=false)¶ Remove all inner loops, or holes, from a Brep face.
Arguments: - 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
-
RhinoCompute.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.
Arguments: - 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
-
RhinoCompute.BrepFace.split(thisBrepFace, curves, tolerance, multiple=false)¶ Split this face using 3D trimming curves.
Arguments: - 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
-
RhinoCompute.BrepFace.isPointOnFace(thisBrepFace, u, v, multiple=false)¶ Tests if a parameter space point is in the active region of a face.
Arguments: - 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 relationship between the point and the face.
Return type: PointFaceRelation
-
RhinoCompute.BrepFace.isPointOnFace1(thisBrepFace, u, v, tolerance, multiple=false)¶ Tests if a parameter space point is in the active region of a face.
Arguments: - u (float) – Parameter space point U value.
- v (float) – Parameter space point V value.
- tolerance (float) – 3D tolerance used when checking to see if the point is on a face or inside of a loop.
- 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 relationship between the point and the face.
Return type: PointFaceRelation
-
RhinoCompute.BrepFace.trimAwareIsoIntervals(thisBrepFace, direction, constantParameter, multiple=false)¶ Gets intervals where the iso curve exists on a BrepFace (trimmed surface)
Arguments: - 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[]
-
RhinoCompute.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.
Arguments: - 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[]
-
RhinoCompute.BrepFace.changeSurface(thisBrepFace, surfaceIndex, multiple=false)¶ Expert user tool that replaces the 3d surface geometry use by the face.
Arguments: - 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
-
RhinoCompute.BrepFace.rebuildEdges(thisBrepFace, tolerance, rebuildSharedEdges, rebuildVertices, multiple=false)¶ Rebuild the edges used by a face so they lie on the surface.
Arguments: - tolerance (float) – tolerance for fitting 3d edge curves.
- rebuildSharedEdges (bool) – if False 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