Skip to content
brep-conformancegithub

chamfer_distances

Blends · api.md § chamfer_distances · all operations

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}

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.

FunctionFieldsReturns
fillets, edges, radiusSolid
fillet_radiis, edges, radiiSolid
fillet_variables, edge, from, r_from, r_toSolid
fillet_conics, edges, setback, rhoSolid
fillet_g2s, edges, offset, centerSolid
fillet_setbacks, edges, radius, setbackSolid
fillet_setback_g2s, edges, radius, setbackSolid
fillet_facess, face_a, face_b, radiusSolid
full_rounds, side_a, middle, side_bSolid
chamfers, edges, distanceSolid
chamfer_twos, edge, face, d1, d2Solid
chamfer_distancess, edges, distancesSolid