Revit API 开发周边：自定义填充样式 Fill Pattern

前言

本文介绍 Revit 填充样式的自定义创建。

内容

打开 Revit 的 “管理 》其它设置 》填充样式”，可以找到 Revit 的填充图案：

选择一个填充图案，编辑。对于一个基本图案，有两种类型，平行线或者交叉填充。如果是平行线，只需给出角度和平行线的间距，如果是交叉，那么还有给出另一个方向的间距。
平行线：

交叉填充：

对于自定义的图案，则较为复杂，以下图为例，这也是官方的一个例子，创建自定义填充图案文件：

你可以点开官方的链接，直接 copy 它的内容，会发现无法运行，因为它的内容有错误。生成的填充图案的最终结果 pat 文件应该是这样的：

*Concrete Paver,
;%TYPE=MODEL
    0, 0,       0,       5.656,     5.656,     3.3125,     -8
    0, 0,       3.3125,  5.656,     5.656,     3.3125,     -8
   90, 0,       0,       5.656,     5.656,     3.3125,     -8
   90, 3.3125,  0,       5.656,     5.656,     3.3125,     -8
   45, 3.3125,  3.3125,  8,         8,         3.3125,     -4.6875
  -45, 3.3125,  0,       8,         8,         3.3125,     -4.6875

下面按照官方的思路来进行分析，来看看如何生成一个这样的样式 pattern。
这个样式由 6 步构成：

第一步：

 0, 0,       0,       5.656,     5.656,     3.3125,     -8

使用下列值创建第一个填充图案描述：
角度: 0
此值是笔线绘制的角度。例如，0 度角表示线是水平直线；90 度角表示线是垂直直线。
原点: 0, 0
这两个值是 x 原点和 y 原点，用于指明起始点。
位移: 5.656, 5.656
这两个值用于确定 x 轴位移和 y 轴位移（也就是指任何移动的起点与下一移动的起点之间的 x 轴距离和 y 轴距离）。
落笔: 3.3125
抬笔: -8
落笔和抬笔分别用于指明落笔和抬笔的长度。负数表示笔抬起。

效果：

填充图案中，一小段黑线的长度是 3.3125，黑线后留空长度为 8。然后再起一条黑线，再留空。填充图案是从原点开始的（0,0），它不仅可以通过位移（5.656, 5.656）往右上方向延伸，还可以往左、往下延伸。

第二步：

    0, 0,       0,       5.656,     5.656,     3.3125,     -8
    0, 0,       3.3125,  5.656,     5.656,     3.3125,     -8

使用下列值创建第二个填充图案描述：
角度: 0
原点: 0, 3.3125
位移: 5.656, 5.656
落笔: 3.3125
抬笔: -8

效果：

第三步：

    0, 0,       0,       5.656,     5.656,     3.3125,     -8
    0, 0,       3.3125,  5.656,     5.656,     3.3125,     -8
   90, 0,       0,       5.656,     5.656,     3.3125,     -8

使用下列值创建第三个填充图案描述：
角度: 90
原点: 0, 0
位移: 5.656, 5.656
落笔: 3.3125
抬笔: -8

效果：

第四步：

    0, 0,       0,       5.656,     5.656,     3.3125,     -8
    0, 0,       3.3125,  5.656,     5.656,     3.3125,     -8
   90, 0,       0,       5.656,     5.656,     3.3125,     -8
   90, 3.3125,  0,       5.656,     5.656,     3.3125,     -8

使用下列值创建第四个填充图案描述：
角度: 90
原点: 3.3125, 0
位移: 5.656, 5.656
落笔: 3.3125
抬笔: -8

效果：

第五步：

    0, 0,       0,       5.656,     5.656,     3.3125,     -8
    0, 0,       3.3125,  5.656,     5.656,     3.3125,     -8
   90, 0,       0,       5.656,     5.656,     3.3125,     -8
   90, 3.3125,  0,       5.656,     5.656,     3.3125,     -8
   45, 3.3125,  3.3125,  8,         8,         3.3125,     -4.6875

使用下列值创建第五个填充图案描述：
角度: 45
原点: 3.3125, 3.3125
位移: 8, 8
落笔: 3.3125
抬笔: -4.6875

效果：

第六步：

    0, 0,       0,       5.656,     5.656,     3.3125,     -8
    0, 0,       3.3125,  5.656,     5.656,     3.3125,     -8
   90, 0,       0,       5.656,     5.656,     3.3125,     -8
   90, 3.3125,  0,       5.656,     5.656,     3.3125,     -8
   45, 3.3125,  3.3125,  8,         8,         3.3125,     -4.6875
  -45, 3.3125,  0,       8,         8,         3.3125,     -4.6875

使用下列值创建第六个填充图案描述：
角度: -45
原点: 3.3125, 0
位移: 8, 8
落笔: 3.3125
抬笔: -4.6875

效果：