板件自定义函数：写在哪、何时用、怎么填¶
尺寸和位置公式管「板多大、放在哪」。复制几块、切斜角、打孔开槽这类操作写在板件的「自定义函数」里。公式编辑器里单击函数就能看到单个函数的说明，这一篇把 12 个函数放在一起讲：写在哪、什么时候用哪个、参数怎么填、几个应用例子，以及写完怎么检查。
参数都是写法示例
文中的孔径、孔深、槽宽、间距都是讲写法用的示例。请按您的板件和五金工艺改，写完一定在 SketchUp 里核对结果。
写在哪¶
- 在 柜体管理 里打开柜体，点中要加函数的板件或组件。
- 在右侧属性里展开 高级设置（默认折叠），找到 自定义函数，点 + 公式编辑器。
- 左侧函数列表：单击函数看说明和示例；双击打开填参数的小窗。
- 在小窗里填好每一格，点 插入到公式，函数写回原来的编辑器。点取消关闭小窗，原来的内容不变。
- 在编辑器里点 计算结果 核对，再点 保存。几何函数点 计算结果 后只显示「该公式为几何函数，保存后在 SU 中执行。」，不显示数字，也没有造型预览，实际形状要同步到SU后看。
- 按平常的流程对柜子 同步到SU，在 SketchUp 里看结果。
小窗里预先填好的数字只是示意，不是默认值，每一格都按实际填。
三种格子不要混写¶
| 格子 | 写什么 | 例子 |
|---|---|---|
| 尺寸、位置、旋转、阵列 | 算出一个数字的公式 | k-2*bh |
| 隐藏条件 | 算出真或假的条件 | cbsl==0 |
| 自定义函数 | 复制、造型、孔槽函数 | 斜切(左,下,45) |
斜切(...)、打孔(...) 这类函数只写在自定义函数里，不要填进宽度、位置这些数字格子。变量和条件的写法见公式入门。
坐标从哪里量¶
函数里的点 [x,y,z] 按这块板（当前物体）自己的局部坐标写。它和柜体的 X 宽、Y 深、Z 高不是一回事，也不是连接件孔位的坐标系，不要把那两套数字直接搬过来。示例里 Z 写 bh（板厚变量），方向写成 [0,0,1] 这样的向量。写完以同步到 SU 后的实际位置为准。
什么时候用哪个¶
| 想做的事 | 用这个函数 |
|---|---|
| 把这块板按固定间距复制几块 | 拷贝阵列 |
| 不显示板件某几面的边线 | 隐藏边线 |
| 板角倒角、海棠角 | 倒角 |
| 门框、型材 45° 拼角 | 斜切 |
| 在板面上切掉矩形或多边形的一块 | 切割板件 |
| 在这块板上打孔、开槽 | 打孔、开槽 |
| 沿一条线开连续的槽，如背板槽、走线槽 | 槽线 |
| 给五金定孔位，孔可以落在别的板上 | 孔线、孔线阵列、孔线均分 |
复制：拷贝阵列¶
- 方向：复制的方向向量，如
[1,0,0]； - 步长：相邻两块之间的实际位移，不会自动加板厚；
- 数量：总块数，包含原来那一块。数量小于等于 1 时不复制。
拷贝阵列([1,0,0],100,10)：一共 10 块，相邻两块相距 100。
想让层板之间净空 332、板厚 18，步长要写 350（净空加板厚），写 332 时净空只有 314（332 减去板厚 18），比目标 332 少了 18。
外形：隐藏边线、倒角、斜切、切割板件¶
隐藏边线¶
隐藏板件指定面的边线。参数是要隐藏的面，用方向向量列出，多个面写在一个列表里。
倒角 / 海棠角¶
- 边序号：要处理的边，如
[1,2,3,4]； - 方向：每条边一个值，1 = 正面倒角，0 = 不倒角，-1 = 反面倒角；
- 预留：每条边的预留，单位 mm。
倒角([1,2,3,4],[1,0,1,0],[5,5,5,5])：第 1、3 条边正面倒角，第 2、4 条边不倒角。边序号对应哪条边，在 SU 里看一次结果就能确认。
斜切¶
把板件的一个端面在大面内切成斜角，用于型材拼角、门框 45° 拼角。
- 端面：左 / 右 / 前 / 后 / 上 / 下，切板件的哪一头；
- 保留边：同样六选一，端面上哪一侧保持全长，另一侧的角往板内收；
- 角度：斜切线和端面的夹角，0～90，可以写公式。
一条只切一头，两头都切就写两条。结果按异形轮廓生成和导出。
切割板件¶
- 面：前 / 后 / 左 / 右 / 上 / 下；
- 点：两个点 = 矩形，多个点 = 多边形；
- 深度：切割深度，mm；
- 是否切割：可选，
true/false，默认true，写在深度后面、阵列前面； - 阵列：可选，
[数量,间距,[方向]]。
注意切割板件的阵列是数量在前、间距在后，和打孔、开槽相反。
加工：打孔、开槽、槽线¶
打孔和开槽都用「入刀面中心点 + 尺寸 + 法线」来写，孔槽开在这块板上。
- 中心点：入刀面上孔或槽的中心
[x,y,z]； - 尺寸：打孔是
[宽,高,深]，宽和高差不多就是圆孔；开槽是[长,宽,深]； - 法线：开口朝向，也就是入刀方向，
[0,0,1]表示朝 Z+； - 阵列：可选，
[[间距,数量,[方向]]]；两个方向都排时写两组[[...],[...]]。
打孔([20,20,bh],[5,5,5],[0,0,1],[[20,3,[0,1,0]],[20,3,[1,0,0]]])
开槽([20,20,bh],[50,5,5],[0,0,1],[[20,3,[0,1,0]]])
第一条是在两个方向上各按间距 20 排孔。
槽线¶
沿一条线连续开槽，用于背板槽、走线槽。起点和终点是槽中心线的两端。
五金孔位：孔线、孔线阵列、孔线均分¶
孔线系列用来给五金定孔位。和打孔不同：起点必须落在某块板件的面上，但不要求是当前这块板，系统按起点的实际空间位置找到命中的板件。起点按当前物体的局部坐标写。
| 函数 | 写法 | 用途 |
|---|---|---|
| 孔线 | 孔线(起点,孔尺寸,法线) |
单个孔位 |
| 孔线阵列 | 孔线阵列(起点,孔尺寸,法线,[间距,数量],[方向]) |
从起点沿方向按间距排孔，方向默认 [1,0,0] |
| 孔线均分 | 孔线均分(起点,终点,孔尺寸,法线,数量) |
在起点到终点之间按数量均分孔位 |
孔尺寸是 [宽,高,深]，法线是入刀方向。
孔线([20,20,bh],[5,5,30],[0,0,1])
孔线阵列([20,20,bh],[5,5,30],[0,0,1],[32,5],[1,0,0])
孔线均分([20,20,bh],[200,20,bh],[5,5,30],[0,0,1],5)
第二条是从起点开始、间距 32、5 个孔，适合 32mm 系统的一排孔。
抽屉深度¶
现有说明是「自动获取抽屉深度值，深度值数组可以为空」，但没有写明返回值怎么取、数组为空时用什么值。这里只列出签名和示例，不把它当作可以照做的几何操作；要用时请先在 SU 里核对结果。
应用例子¶
例 1：层板一共 3 块¶
在第一块层板的自定义函数里写：
结果一共 3 块：原来那块加两块复制，分别在原位、+350、+700。不要因为「复制」就把数量写成 4。
例 2：门框两头 45° 拼角¶
两头各写一条，下侧保持全长。同步后对着另一根框料看，两边斜角应该对上。
例 3：一排 32mm 系统孔¶
把起点改到您板件上的实际位置，孔径、孔深按五金说明书改。
完成检查¶
- 函数写在 自定义函数 里，没有填进尺寸或位置格子；
- 点过 计算结果 和 保存，并对柜子同步到SU；
- 拷贝阵列：数一下总块数等于「数量」，量相邻两块的位移等于「步长」；
- 斜切、倒角、切割：在 SU 里看切的是哪一头、哪条边；
- 孔槽：孔落在预期的板和面上，入刀方向对，孔深没有打穿；
- 所有工艺数值按工厂的板件和五金资料复核过。
常见问题¶
双击后打开的小窗，填错了怎么办？
点取消关掉小窗，原来的内容不变。已经插入的，在编辑器里直接改或删掉那一行。
参数里能写变量吗？
能。示例里的 bh 就是板厚变量，斜切的角度也可以写公式。写了变量的函数，换几组柜体尺寸各同步一次看结果。
打孔和孔线该用哪个？
孔开在这块板自己身上，用打孔、开槽；给五金定孔位、孔可能落在相邻的板上，用孔线系列。
下一步¶
- 公式入门：变量、条件与常用写法——尺寸、位置、隐藏条件怎么写；
- 柜体管理——板件和组件在界面上怎么改；
- 生成五金与孔槽——连接件规则生成的孔槽。