CAD随机颗粒插件2D V2.0更新说明

1　概述

CAD随机颗粒插件2D 是一款运行在 AutoCAD 上的二维随机颗粒投放工具：只需设定区域尺寸、粒径区间、各档比例与目标填充率，即可在图纸上自动生成互不重叠、间距可控、分布随机的颗粒集合，并按级配自动分层管理。

本次 V2.0 在 V1.0 基础上新增 / 改进四项功能。本文逐一说明每项功能的用途、操作方法与注意事项。

1	长方形颗粒类型	新增
2	粒径比例表行序调整（上移 / 下移 / 粒径重排）	新增
3	删除「投放优化」参数，投放顺序统一由表格行序决定	移除
4	图纸中实际生成数量与提示数量一致	修复

2　新增功能一：长方形颗粒类型

2.1　功能用途

支持矩形骨料、片状或条状颗粒、规则板块等建模场景，可与圆形、多边形、正多边形在同一张图上任意混合投放。

2.2　操作步骤

1. 在【粒径比例】表右侧输入区，将「类型」下拉框选择为「长方形」；
2. 「最小直径」列填写长方形的宽度，「最大直径」列填写长度；
3. 填写该档在总面积中的比例（%）；
4. 点击「◀ 添加」，该档即加入粒径比例表；
5. （可选）用「▲ 上移 / ▼ 下移」或「粒径重排」调整行序。

2.3　尺寸与生成规则

• 宽度取自「最小直径」列，长度取自「最大直径」列，同一档内尺寸固定；
• 摆放朝向随机，可任意角度摆放；
• 宽度等于长度时为正方形，同样允许；
• 两列须满足 0 < 最小值 ≤ 最大值；
• 选择「长方形」时「边数」输入框自动禁用（仅多边形与正多边形需要边数）。

2.4　图层命名

长方形所在档的图层前缀为 rect。例如粒径比例表第 3 行为长方形时：

rect_003_OUTER	该档长方形的外层轮廓
rect_003_INNER	该档长方形的内层轮廓（仅启用内外两层时生成）

3　新增功能二：粒径比例表行序调整

3.1　功能用途

允许用户自定义各档粒径的排列顺序，使「表格序号 = 日志条项编号 = CAD 图层编号」三者完全一致，便于逐条对照与核对。

3.2　操作步骤

• ▲ 上移 / ▼ 下移：选中某一行后点击，将该行向上或向下移动一位（仅支持单行选择）；
• 粒径重排：一键将整张表按「最大直径」从大到小排列；
• 移动到首行或末行时自动忽略，不会越界。

3.3　编号联动规则

• 调整顺序后，表格序号自动从 1 开始重排；
• 运行日志中的「条项 N」与 CAD 图层名中的三位编号同步变化，始终与表格序号一致。

3.4　配置持久化

保存配置时会记录每一行的序号，重新加载后行序完整还原。对于未记录序号的旧版（V1.0）配置文件，将按「圆形 → 多边形 → 正多边形 → 长方形」的分组顺序显示，功能不受影响。

4　移除功能三：删除「投放优化（大粒径优先）」参数

4.1　移除原因

V2.0 的「粒径比例表行序调整」已经能够直接表达「大粒径优先」这一诉求：点一次「粒径重排」即可让表按粒径最大值从大到小排列，投放顺序随之变为大粒径优先。原先的「投放优化」开关与新功能职责重叠，故将其删除，使投放规则变得更单一、直观。

4.2　投放顺序规则

• 投放顺序的规则唯一化：一律按粒径比例表从上到下的行序投放，第 1 行先放、依次往下；
• 想要「大粒径优先」：点击「粒径重排」，表格按「最大直径」从大到小排列即可；
• 想要自定义先后：用「▲ 上移 / ▼ 下移」自由调整任意两行的位置。

4.3　界面与日志变化

• 界面上原「投放优化（大粒径优先）」复选框已移除；
• 运行日志中不再出现「投放优化：开 / 关」与「投放次序」字样，起始行仅说明「投放顺序：按粒径表行序」。

4.4　兼容性

旧配置文件（含 optimize_order 字段）仍可正常加载，程序会自动忽略该字段，功能不受影响。

【如何实现大粒径优先】先点「粒径重排」让表格按粒径最大值降序排列，再点「运　行」；此时第 1 行为最大粒径，投放顺序即为大粒径优先。

5　修复与改进：数量一致性

5.1　问题现象

CAD 图纸中实际生成的长方形等颗粒数量，与插件提示的数量不一致。

5.2　原因分析

• 完成提示只给出颗粒总数，未按类型区分；
• 启用内外两层时，图层中的实体数约为颗粒数的 2 倍，与提示口径不同；
• 个别实体绘制失败时被静默跳过，未给出任何提示。

5.3　修复内容

• 绘制过程精确统计实际成功写入 CAD 的实体数量；
• 完成提示与运行日志按类型分别给出实际数量：圆形、多边形、正多边形、长方形各多少个；
• 同时给出「实际写入 CAD 实体」总数，并说明启用内外两层时实体数约为颗粒数的 2 倍；
• 如有实体绘制失败，明确给出「警告：N 个实体绘制失败被跳过」，不再静默丢失。

【核对方式】完成提示中的数量即为图纸中实际生成的数量；可与日志中的「条项 N（类型）」逐条核对。

5.4　日志示例

========================================================
开始投放：区域 200×200（左下角 0,0），投放顺序：按粒径表行序，
          目标填充率 30%，最小间距 2.00
生成完成：312 颗，实际填充率 28.7%（目标 30%）
  条项1（圆形）：投放 60/60 颗，耗时 0.8s
  条项2（正多边形）：投放 45/45 颗，耗时 0.6s
  条项3（长方形）：投放 118/118 颗，耗时 3.2s
正在连接 AutoCAD 并绘制...
绘制完成：颗粒 312 颗（圆形 60 个、正多边形 45 个、长方形 118 个），
          实际写入实体 624 个（另含 0 图层区域外轮廓）

6　快速上手示例

以「区域 200×200、颗粒最小间距 2、目标填充率 30%、启用内外两层、两层间距 1.5」为例，依次添加五档粒径：

1	圆形	5	10	—	10
2	圆形	10	18	—	10
3	多边形	8	15	6	20
4	正多边形	10	18	5	20
5	长方形（宽 6 / 长 14）	6	14	—	20

1. 在左栏填写区域尺寸、最小间距、目标填充率与单条最长时间；
2. 勾选「启用内外两层」，两层间距填 1.5；
3. 按上表逐行填充并点「◀ 添加」；
4. （可选）点「粒径重排」让表格按粒径最大值降序排列；
5. 点「计算预估」查看各类型预估颗数；
6. 点「运　行」，完成后在弹出的提示框中核对各类型实际数量，并在 AutoCAD 中查看结果。

【快捷方式】可直接点「加载配置」载入随包的 config_example.json，一次性填入一套示例参数（含长方形档），再按需修改。

【注意】插件单机许可授权，不支持更换计算机使用。

原V1.0版本功能请查看：