Files
CADmind/backend/capabilities/impl/sketch_segment_profile.py
2026-09-24 10:40:57 +08:00

64 lines
3.6 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""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])