58 lines
2.9 KiB
Python
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
|