64 lines
3.6 KiB
Python
64 lines
3.6 KiB
Python
"""Explicit boundary segments keep designed straight edges truly straight."""
|
||
import math
|
||
from build123d import Edge, Wire, Face, Sketch, Vector
|
||
|
||
|
||
def validate(context, target, params):
|
||
segments = params.get('segments', [])
|
||
if not 2 <= len(segments) <= 100:
|
||
return ['PROFILE_SEGMENTS: 闭合轮廓需要2到100段']
|
||
previous = None
|
||
for segment in segments:
|
||
kind, points = segment.get('kind'), segment.get('points', [])
|
||
if kind not in ('line', 'spline', 'arc', 'bezier') or not isinstance(points, list):
|
||
return ['PROFILE_SEGMENTS: kind必须是line/spline/arc/bezier,points必须为二维点列表']
|
||
required = 2 if kind in ('line', 'bezier') else 3
|
||
if len(points) < required or (kind in ('line', 'arc') and len(points) != required):
|
||
return ['PROFILE_SEGMENTS: line需要2点,arc需要3点,spline至少3点']
|
||
if any(not isinstance(p, list) or len(p) != 2 or any(type(v) not in (int, float) or not math.isfinite(v) for v in p) for p in points):
|
||
return ['PROFILE_SEGMENTS: 每个点必须包含两个数值']
|
||
if kind == 'bezier' and len(points) > 25:
|
||
return ['PROFILE_SEGMENTS: bezier最多25个控制点']
|
||
if 'tangents' in segment:
|
||
tangents = segment['tangents']
|
||
if kind != 'spline' or not isinstance(tangents, list) or len(tangents) != 2:
|
||
return ['PROFILE_TANGENTS: 仅spline可指定起点、终点两个切线向量']
|
||
if any(not isinstance(t, list) or len(t) != 2 or any(type(v) not in (int,float) or not math.isfinite(v) for v in t) or math.hypot(*t)<1e-9 for t in tangents):
|
||
return ['PROFILE_TANGENTS: 切线必须是有限、非零二维向量,方向沿轮廓行进方向']
|
||
if type(segment.get('smooth_to_next',False)) is not bool:
|
||
return ['PROFILE_SMOOTH: smooth_to_next必须是布尔值']
|
||
if previous is not None and (Vector(*previous)-Vector(*points[0])).length > 1e-6:
|
||
return ['PROFILE_OPEN: 相邻段端点必须重合']
|
||
previous = points[-1]
|
||
if (Vector(*previous)-Vector(*segments[0]['points'][0])).length > 1e-6:
|
||
return ['PROFILE_OPEN: 最后一段必须回到起点']
|
||
return []
|
||
|
||
|
||
def run(context, target, params):
|
||
errors = validate(context, target, params)
|
||
if errors:
|
||
raise ValueError('; '.join(errors))
|
||
edges = []
|
||
for segment in params['segments']:
|
||
points = [Vector(*p) for p in segment['points']]
|
||
if segment['kind'] == 'line':
|
||
edges.append(Edge.make_line(*points))
|
||
elif segment['kind'] == 'arc':
|
||
edges.append(Edge.make_three_point_arc(*points))
|
||
elif segment['kind'] == 'bezier':
|
||
edges.append(Edge.make_bezier(*points))
|
||
else:
|
||
tangents = [Vector(*t) for t in segment['tangents']] if 'tangents' in segment else None
|
||
edges.append(Edge.make_spline(points, tangents=tangents))
|
||
for i,segment in enumerate(params['segments']):
|
||
if segment.get('smooth_to_next',False):
|
||
a,b=edges[i].tangent_at(1).normalized(),edges[(i+1)%len(edges)].tangent_at(0).normalized()
|
||
angle=math.degrees(math.acos(max(-1,min(1,a.dot(b)))))
|
||
if angle > .1:
|
||
raise ValueError(f'PROFILE_TANGENCY: 段{i}与段{(i+1)%len(edges)}连接处切向夹角{angle:.4f}度,要求不超过0.1度。使用spline端点切线或bezier控制点使相邻边相切,不要删除明确要求的平滑约束。')
|
||
face = Face(Wire(edges))
|
||
if not face.is_valid:
|
||
raise ValueError('PROFILE_INVALID: 分段轮廓自交或无效')
|
||
return Sketch([face])
|