框架_拉伸 · SCW

📖 功能概述

该组件是面向框架系统（SCW）的型材拉伸变体。它与US（型材拉伸）共享U1/U2/U3三大处理阶段，但在信息聚合阶段使用 SCW_U3 而非标准 U3，区别在于：

不需要Panel输入：SCW_US不依赖面板表皮提取单元号、批次等信息。
图层路径更简洁：不包含单元号层级。
信息Key集更精简：仅17个键，不包括面板相关的复杂数据。

该组件的Exposure被设置为 senary（六级），在LK → Util菜单中默认隐藏，仅在其他组件有引用时显示。

📥 输入参数

名称	类型	必填	说明
型材截面	Brep	必填	需要拉伸的型材截面，必须为平面曲面。
基准平面	Plane	必填	截面基准平面。
转换	Transform	必填	截面转换数据。
基线	Curve	必填	型材拉伸基线。
端部铣切1	Brep	可选	型材端部铣切体。请确保与基线相交。可选
端部铣切2	Brep	可选	型材端部铣切体。可选
其他铣切	Brep	可选	型材其余铣切体。列表
圆孔	Brep	可选	型材圆孔。列表
机丝孔	Brep	可选	型材机丝孔。列表
沉头孔	Brep	可选	型材沉头孔。列表
名称	Text	可选	型材名称。默认 "XX"。
类型	Text	可选	型材类型。默认 "铝型材"。

📤 输出参数

名称	类型	说明
型材	Brep	拉伸完成后的型材实体。
铣切体	Brep	所有铣切体的汇总列表。列表
图层	Text	格式：`模型::{类型}::{横向/竖向}::{名称}-{模号}`（无单元号层级）
信息Key	Generic	17个键名列表。列表
信息Value	Generic	与Key一一对应的属性值列表。列表
截面平面	Plane	截面放置平面。
型材平面	Plane	型材局部坐标平面。

🧠 SCW_U3 与标准U3的差异

一、信息Key集对比

SCW_US 的 Key 列表仅包含17项，远少于US的32项：

名称 · 类型 · 模号 · pln · 截面ID · 拉伸-截面 · 拉伸-截面pln · 拉伸-路径 · 截面-TS · 截面-基准pln · 起端切面 · 终端切面 · 内部切割体 · 圆孔 · 机丝孔 · 沉头孔 · 横向/竖向

缺失的键包括：面板ID、单元号、批次、序号、L、W、T、单位、自由项、编号、物料编码、工程属性、加工图号等装配表相关字段。

二、SCW_U3 处理逻辑

1 通过截面ID找到Rhino物件，读取"模号"。
2 从U1过程的ArchivableDictionary中解包截面pln和基线。
3 计算型材平面pln（逻辑与标准U3相同，根据基线线性/曲线+横向/竖向计算）。
4 图层路径：模型::{类型}::{横向/竖向}::{名称}-{模号}（不含单元号）。
5 信息汇总：仅包含名称、类型、模号、pln，以及从U1/U2传递过来的几何数据。

三、图层路径差异

US 图层： 模型::{单元号}::{类型}::{横向/竖向}::{名称}-{模号}
SCW_US 图层： 模型::{类型}::{横向/竖向}::{名称}-{模号}

框架系统的型材通常直接集成到更大的框架结构中，不按单元号分组，因此图层路径更加扁平化。

四、总体流程与US的异同

相同点：
• U1 过程完全一致（截面简化、截面移位、SuperExtrude扫掠）
• U2 过程完全一致（几何特征汇总）
• 端部铣切与基线的相交检查一致
• 铣切/圆孔/沉头孔兼容性检查一致

不同点：
• 不使用 Panel 输入参数
• U3 使用 SCW_U3 而非标准U3
• 无编号/加工图号生成
• Information Key 只保留几何相关键
• 输出信息Value中末尾添加"横向/竖向"字符串

🧪 典型使用场景

场景	详细说明
框架系统型材	在大跨度框架结构中，型材不依附于具体单元，而是构成独立的框架体系。SCW_US 专为此场景设计。
简化属性输出	如果不需要装配表信息（序号、编号、物料编码等），SCW_US的输出更简洁。
无需Panel的场景	当拉伸型材时没有对应的面板/表皮信息可用，SCW_US提供了一个不需Panel输入的工作路径。

⚠️ 注意事项

Exposure senary 隐藏：该组件默认不在GH组件面板中显示，需要被其他组件引用后才能出现。如果用户需要直接拖拽使用，可能需要通过GH的Component收集器。
没有信息列表处理：SCW_US 不处理序号、编号、物料编码等装配表数据。输出Value中也不包含这些字段。
缺少"横向/竖向"在信息Value中：Key列表虽然包含"横向/竖向"，但Value列表中该项是在主流程末尾由 U3_dataList.Add(...) 添加的，不在SCW_U3内部的返回值中。
不依赖表皮：与US不同，SCW_US 不接收Panel输入，也不从表读取单元号和批次。图层路径也相应简单。
兼容性检查：同样检测端部铣切与基线的相交、铣切实体性、圆柱/铣切兼容性检查等。
端部铣切不能为空：两个端部铣切输入是必需的（未标记Optional）。如果未连接，会引发空引用异常。

📋 组件信息

名称	框架_拉伸
英文名	SCW_US
分类	LK → Util
Exposure	`senary`（六级，默认隐藏）
按钮1模式1	截面不简化
按钮1模式2	截面简化
按钮2模式1	横向
按钮2模式2	竖向
基类	ButtonComponent2（双独立按钮）
文件	US\SCW_US.cs
GUID	{CA01004B-D2F0-4422-AC4D-8FE3E9C78E80}

框架_拉伸 · SCW_US