自由扩展指引

找到文件夹

插件调用预设的默认文件夹位于以下地址（其中 Administrator 和 SketchUp 2022 根据 windows 账户及安装的SU版本可能会有变化）： C:\Users\Administrator\AppData\Roaming\SketchUp\SketchUp 2022\SketchUp\Plugins\Zhouxi_Magiz 一种直达的方式，是点击SU菜单 > 扩展程序 > Magiz > 切换样式库，右键点击 default 文件夹，从新窗口中打开。 文件夹由三类文件构成。styles.rb 是保存样式参数的ruby文件，shape.skp 是保存预设的组件模型文件，剩余的jpg、png、gif 文件是贴图材质文件。

简单扩展

插件对预设的调用均通过名称实现，即从所有名称包含了参数关键词的元素中进行随机选择。 所有参数的单位为米。

1. 材质扩展

如在 styles.rb 文件中定义的材质参数为“A”，文件夹中的图片材质名有“A1”、"A2"、"B1"、"B2"，最终会在“A1”、"A2"中随机选择一个用于贴图。若用户添加了一个“A3”的材质文件，则最终会在“A1”、"A2"、“A3”中随机选择一个用于贴图。 用户可以通过文件名自定义材质的尺寸。加入类似 2x、x3、2x4 等由小写x和数字组成的参数定义了材质的“长x高”，每一位都可以省略不写，长的缺省值为3米，高的缺省值为生成建筑时定义的层高。该参数也可以在SU中直接加入到材质名中。

2. 组件扩展

用户可以打开shape.skp（SU菜单 > 扩展程序 > Magiz > 添加组件），内部有两个组件，一个包含了全部被调用的线角的剖面模型，一个包含了所有被调用组件。前者暂时不需要修改，双击后者，如在内部添加一个新的空调组件模型，修改组件的名称为“AC03”，则最终生成模型的屋顶上有1/3的概率出现新增的空调模型。

按上述内容在现有基础上对材质和模型进行修改和增补，可以简单快速地实现丰富的效果。若是闲得发慌的用户可以向下阅读，对参数进行修改。

深度扩展

修改 styles.rb 的参数很不直观，调试功能也不完善，请谨慎修改。 用户可以用 windows文本编辑器，更推荐使用VSC、Hbuilderx等进行编辑。 用户只需要修改=号后方的内容。如 @update = 样式更新的日期，显示在插件生成建筑的对话框上部。 在@update 下方加入 @debug= 1 可以打开输出调试信息的功能。 @styles 是哈希表类型的样式参数，包含两层。第一层是样式分类的名称，第二层保存具体的参数。 参数为三位数组的形式，含义为： [ 边线偏移量、生成元素的形式、元素的排列方式 ]。

1. 修改边线偏移量

第一位针对单个面的所有边线，根据与X、Y轴的角度进行不同的偏移计算。 边线偏移量为两位数组，含义为： [ X轴偏移、 Y轴偏移]。负值为向外偏移，正值为向内偏移。 可以使用如“2~4*2”的表达式进行加减乘除计算，其中2~4 代表2到4的随机整数，也可以写成~3代表0到3的随机整数，仅有~则代表上一次计算的随机数。缺省为0。

2. 修改生成元素，及材质关键词

元素的形式为六位数组，基本形式为： [ 类型、名称、尺寸、移动、旋转]。因为根据类型不同，后续参数的形式也不同，有些复杂，估计没人想看就略过了。 重点是其中定义了“2.1 材质扩展”中提到的对文件夹内材质的调用。 材质参数基本上为数组的形式，表示按顺序在组件内部的面上贴图。如["ZBQM:red", "ZBQM:green"]，表示用两种材质为偏向X、Y轴的面分别贴图。 材质参数也可以写成字符串的形式，表示在组件外部赋材质。后者用于简单上色，因为无法对每个面精确贴图。目前支持"white", "silver", "gray", "dark", "alpha", "glass"的预设材质名，用于灰色系上色。 材质参数的“:”后可以定义附加参数，定义贴图的不同方式。 尺寸参数如 2x、x3、2x4 等由小写x和数字组成的参数定义了材质的“长x高”，每一位都可以省略不写，长的缺省值为3米，高的缺省值为生产建筑时定义的层高。 red、green 代表只在沿模型红轴或绿轴的面上进行贴图，缺省是所有面。 double 代表面的两侧均进行贴图，缺省只在外侧。 stretch 是按材质的计算尺寸与面的尺寸进行拉伸贴图，实现垂直和水平等分的贴图效果。inside、horizon，是实现严格按照材质的计算尺寸进行贴图的效果。其中inside会在面的内部画一个标准尺寸的矩形再进行贴图，而horizon是水平方向贴图按等分进行拉伸，只生成两段水平线条。缺省是vertical，即垂直方向贴图按等分进行拉伸，只生成两段垂直线条。 crown 用于屋顶贴图，从水平顶部开始，周边的垂直面都会无缝延续贴图

3. 修改元素的排列方式

元素的排列方式为三位数组，有两种类型。 [ "FLOOR"、层高、总高度 ]，用于竖向楼层排列，根据后两位参数计算近似的层高，实现等分的排列效果。 [ "EDGE"、间距、两端缩进距离 ]，用于生成沿边线排列的组件，根据每一段直线段长度，减去两端缩进距离，计算近似间距，实现等分的排列效果。

问题咨询

微信公众号： Ketchup
邮箱：453154007@qq.com
两周检查一次邮箱，如需及时回复请微信联系