Files
2026-09-24 10:40:57 +08:00

58 lines
2.9 KiB
Python

from build123d import Align, Axis, Circle, Plane, Pos, Rectangle, revolve
def validate(context, target, params):
errors = []
if params["groove_depth"] >= params["sphere_radius"] * 0.5:
errors.append("GROOVE_TOO_DEEP: 沟槽太深,会把球体挖穿或结构强度不足")
if target is not None:
# target 只能是"同一个球之前开过其它轴向沟槽的结果",不能是随便什么上一步的实体
# (常见误用: 把base/pillar这类跟球无关的实体,靠默认的"取上一步结果"传了进来)。
# 用体积做一个粗略但有效的合理性检查: 不管开了几条槽,体积都应该接近完整球体积,
# 差距太大就说明传错了对象。
import math
r = params["sphere_radius"]
full_sphere_volume = 4 / 3 * math.pi * r**3
if not (full_sphere_volume * 0.5 <= target.volume <= full_sphere_volume * 1.05):
errors.append(
"WRONG_TARGET: sphere_grooved 的 target 必须是'同一个球之前用 sphere_grooved "
"开过其它轴向沟槽的结果',不能是base/pillar等其它实体——如果这是给球开的第一条"
"沟槽,target 必须省略(留空),不要用默认的'上一步结果'"
)
return errors
def _grooved_sphere_around_x(sphere_radius, groove_depth, groove_half_width):
# 沟槽的2D轮廓构造只在X轴方向推导一次(半圆轮廓+挖槽+单次revolve),验证过是合法(valid)实体。
# 直接做3D的"球 减去 凹槽实体"会产生非法(invalid)几何(OCCT在两个曲面相切范围很大时的已知稳定性问题),
# 所以这里绝不用3D减法,全程只用2D布尔+一次revolve。
inner_r = sphere_radius - groove_depth
half_disk = (Plane.XY * Circle(sphere_radius)) & (
Plane.XY * Rectangle(3 * sphere_radius, 2 * sphere_radius, align=(Align.CENTER, Align.MIN))
)
notch = Plane.XY * Pos(-groove_half_width, inner_r, 0) * Rectangle(
2 * groove_half_width, sphere_radius + 5 - inner_r, align=(Align.MIN, Align.MIN)
)
grooved_profile = half_disk - notch
return revolve(grooved_profile, axis=Axis.X, revolution_arc=360)
def run(context, target, params):
sphere_radius = params["sphere_radius"]
axis = params["axis"]
grooved = _grooved_sphere_around_x(sphere_radius, params["groove_depth"], params["groove_half_width"])
if axis == "Y":
grooved = grooved.rotate(Axis.Z, 90)
elif axis == "Z":
grooved = grooved.rotate(Axis.Y, 90)
if target is None:
return grooved
# 已经开过其它轴向沟槽的球,要再开一条新槽:用两个各自独立构造、各自合法的"开槽球"做交集,
# 而不是从target里减去新槽的cutter——同样是为了避开3D减法在这里的稳定性问题,已实测三轴都开验证过合法。
return target & grooved