03预计算图框比例图标

LK COMPONENT DOCS

03预计算图框比例

根据图框的有效绘图区和每组图元的矩形范围,提前计算能完整容纳内容的整数比例分母,供图框生成与排版决策使用。

功能概览

该组件是 CAD 图框工作流的第三步。它比较待放入图框的矩形范围与模板中的有效绘图区,计算宽度和高度两个方向所需的放大比例,取更严格的一项,增加约 5% 余量后向上取整。得到候选值后,组件还会按最终的插入位置、旋转和统一比例检查矩形四角是否确实落入有效绘图区;若仍未完整包含,则逐级增大比例,直到通过检查或报告失败。

“图元外包围框”的数量决定输出数量。图框输入可以只提供一项并广播给全部矩形,也可以与矩形数量一致;平面同样可以广播,完全不输入时使用世界 XY。当前图框放置只支持世界 XY 平面方向,包括位于世界 XY 内但绕 Z 轴旋转的有效平面;倾斜到三维空间的平面不适合此 CAD 工作流。

03预计算图框比例逻辑教程图
比例不是简单相除后的原始小数:它包含约 5% 余量、向上取整和最终四角包含检查。

适用场景

  • 在真正生成和导出图框前,预估每组二维图元需要的图纸比例。
  • 用同一个标准图框批量计算多个零件、立面或排版区域的比例。
  • 提前筛选比例过大的图纸,决定是否改用更大图框或重新分组。
  • 让预览和最终 CAD 放置使用一致的图框中心、旋转与统一比例逻辑。

工作流程

  1. 先用“01获取CAD图框”得到有效图框数据,其中必须包含可用的有效绘图区。
  2. 为每组待出图内容准备一个有效 Rectangle,表示该组图元在目标平面中的完整范围。
  3. 需要旋转图框方向时提供目标平面;所有平面必须保持在世界 XY 中。不连接时采用世界 XY。
  4. 按广播规则连接图框、矩形和平面,组件为每个矩形计算一个比例分母。
  5. 将比例列表用于排版检查、标注或连接到后续图框生成与 CAD 导出步骤。

输入

端口是否必需数据与结构默认、匹配与误接说明
图框类(B)必需图框数据列表,通常来自“01获取CAD图框”。可为 1 项并广播给所有矩形,或与矩形数量完全一致。空列表、无效图框或其他通用数据不能参与计算。
图元外包围框(R)必需Rectangle 列表,每项代表一组内容的完整矩形范围。此列表数量决定输出数量,不采用循环匹配。每项必须有效且尺寸可用于比较;不要只提供内容的一部分,否则比例会被低估。
平面(P)可选目标平面列表,用于解释矩形方向并确定图框旋转。未输入时全部使用世界 XY;也可提供 1 项广播,或提供与矩形等量的平面。数量不符合规则会报错。当前 CAD 图框仅支持世界 XY 内的平面方向。

输出

端口结果与结构典型下游
图框比例(S)数字列表,与“图元外包围框”逐项对应。每项是经过余量、向上取整和包含校验后的比例分母,最小不会低于 1。最终生成图框并导出 CAD、图纸标题或比例文字、批量分组判断以及异常大比例筛选。

实际示例

某图框的有效绘图区为 360×240,待出图零件的矩形范围为 700×430,并使用世界 XY。宽度需要约 1.944,���度需要约 1.792,因此先取宽度要求;增加约 5% 后约为 2.042,再向上取整得到候选比例 3。组件按比例 3 将图框有效区域放置到零件范围中心,并检查零件矩形的四个角,全部位于有效区内后输出 3。若同一图框再连接第二个更小的矩形,图框输入只需一项即可广播,输出列表则按两个矩形分别给出两个比例。

配合使用

  • 上游使用“01获取CAD图框”提供模板;不要用普通矩形代替完整图框数据,因为有效绘图区来自模板。
  • 用边界框或排版结果建立每组内容的 Rectangle,并确保范围包含最终要放入图框的全部图元。
  • 把输出比例与对应的图元分组保持相同顺序,再交给最终图框生成和导出步骤。
  • 可用数值比较或列表筛选找出超过项目允许范围的比例,并在导出前改图框或调整排版。

常见问题与限制

为什么图框或平面数量错误?
两者只能为空的可选平面、单项广播,或与矩形数量完全一致;其他长度不会循环配对。
为什么结果比简单的宽高相除更大?
组件会增加约 5% 余量并向上取整,还会验证四个角是否完整落入有效绘图区。
为什么倾斜平面计算失败?
当前 CAD 图框放置要求世界 XY 平面内的统一比例变换。可绕 Z 轴改变方向,但不能使用倾斜到三维空间的平面。
为什么某项无效会导致整次没有完整输出?
组件按列表顺序验证并计算;遇到无效图框、矩形或平面时会报告对应项并中止本次结果发布。
比例能否小于 1?
不能。即使内容小于有效绘图区,输出比例分母也至少为 1。