chamfer_distances
Blends · api.md § chamfer_distances · all operations
definition
chamfer_distances(s: Solid, edges: list<Point3>, distances: list<Length>) -> Solid
Bevels edges as chamfer does, in one operation, with each point's chain at its own distance, so that chamfers of unequal distances meet at shared corners. distances must give one distance for each point, and each distance must be as chamfer requires. Away from those corners, each edge is as chamfer cuts it at that edge's distance. The corner is open within limits. The result lies, point for point, within the solid chamfered at the smallest of the corner's distances. The volume of the result is no less than the volume of the solid chamfered at the largest of the corner's distances. The result holds every point of that second solid farther than the largest distance from the corner along any edge. Nearer the corner, the three chamfers' planes meet at a point, and a result may run out to that point or be cut flat across short of it.
Example. Solid 1 is a 10 × 20 × 30 mm box with one corner at the origin.
> {"cmd": "chamfer_distances", "s": 1, "edges": [[0, 0, 15], [10, 0, 15]], "distances": [1, 2]}
< {"ok": 2}common to blends
An edge is named by a point on it. Each point names the edge of s that passes within 10·ε of the point, where ε is the suite's tolerance of 1e-7 mm. A call with a point that names no edge refuses. Naming an edge by a point does not depend on how any kernel numbers or labels its topology, and a test can compute such a point from the solid's definition.
A blend runs along the whole tangent chain of its edge. The chain is the named edge and every edge reached from it through vertices where the next edge leaves in the direction in which the last edge arrived. The top loop of a prism on a rounded rectangle is one chain, so a point on any edge of that loop blends the whole loop. Following the chain is the work of the function, and so of the kernel. An adapter passes on the edge the point names and no other edge.
| Function | Fields | Returns |
|---|---|---|
fillet | s, edges, radius | Solid |
fillet_radii | s, edges, radii | Solid |
fillet_variable | s, edge, from, r_from, r_to | Solid |
fillet_conic | s, edges, setback, rho | Solid |
fillet_g2 | s, edges, offset, center | Solid |
fillet_setback | s, edges, radius, setback | Solid |
fillet_setback_g2 | s, edges, radius, setback | Solid |
fillet_faces | s, face_a, face_b, radius | Solid |
full_round | s, side_a, middle, side_b | Solid |
chamfer | s, edges, distance | Solid |
chamfer_two | s, edge, face, d1, d2 | Solid |
chamfer_distances | s, edges, distances | Solid |