定义某个用脚本编写的命令、工具或对象插件外观的参数,存储于与文件中放置的每个对象实例关联的一个参数记录中。这些记录会存储各次使用之间的持久性数据,并提供默认参数值。会显示一个对话框的一个菜单命令,例如:可能需要存储某用户输入的值以备后用。一种可能在弹出列表中提供多种模式选项的工具。如果用户想要选择不同的工具模式,则新设置可以在工具项的后续使用中被保存且重复使用。这些值都可以存储到菜单或工具的参数记录中,且之后在该命令或工具被再次选定时接受检索。交换文件会显示与新文件相关的存储值,或者,如果没有参数记录,则会在插件项被创建时,显示参数记录的默认值。
每个对象实例的参数,都可以利用“对象信息”面板访问对象参数记录中相应值的方式进行修改。文件中创建第一个对象(或工具)实例后,也会创建一个默认参数记录。与对象实例关联参数记录截然不同的是,此默认参数记录会利用该文件存储对象默认设置。在放置后续对象实例时,会用它来定义每个新对象实例的默认值。
从“插件管理器”的“自定义插件”选项卡,选择要定义或编辑的插件。
单击编辑定义。
“编辑插件定义”对话框打开。
参数 |
描述 |
基本 |
|
类型 |
显示要创建的插件的类型(菜单命令、工具、对象或包含文件) |
语言 |
根据插件脚本部分采用的语言,显示 Python 或 VectorScript(请参阅指定插件脚本) |
名称 |
指定新插件的名称;此亦为插件文件的名称,自动追加相应的扩展名(.px、 .vsm、.vst 或 .vso)。如要重命名插件,请随后更新工作空间以更新插件名称。 |
类别 |
向某个标题类别指派一个插件,以在“工作空间编辑器”中轻松找到此插件 |
参数 |
指定插件的默认参数。默认参数会在插入时应用于此插件。参数会按插件中指定的顺序列出;在 # 列中拖动即可更改参数顺序。 |
参数列表 |
列出默认对象参数,如果适用,则替换(本地化)名称、格式及默认值。对于线性对象,会显示包含线性对象轴长度的 LineLength 参数。对于矩形对象,则会显示 LineLength (对象实例的初始长度)和 BoxWidth (对象实例的初始宽度)参数。可为这些参数指定新的默认值,但不可将其删除。 |
新建 |
为插件创建一个新参数。“编辑参数”对话框打开。 指定参数名称,如果适用,则替换(本地化)名称并单击确定以创建插件参数。 要创建预定义参数选项的弹出列表,选择弹出类型。“编辑选项”对话框打开。列出选项;列表中的每一行代表弹出窗口中的一个选项。单击确定。如要编辑弹出的选项,单击选项。 |
编辑 |
编辑选定插件参数。某些第三方插件和内置插件允许参数编辑。 |
删除 |
删除选定的插件参数。 |
指定插件使用的文本字符串 |
|
字符串列表 |
列出插件使用的字符串(例如:指定插件所用特定颜色的颜色选择器值) |
向插件定义添加一个文本字符串。“添加类别”对话框打开。 下一个可用“资源标识”号会自动指派;指定类别名称并单击确定。 |
|
编辑 |
编辑当前选定的字符串。“编辑字符串”对话框打开。选择单个字符串值并单击编辑以打开“编辑字符串”对话框。 指定字符串值后单击确定;该值取决于类别;更多详情,请参阅 developer.vectorworks.net。 |
删除 |
删除当前选定的字符串 |
特性 |
特性设置允许插件如 Vectorworks 菜单命令、工具和对象一般作为。这些设置会控制与文件状态(选择状态、视图指向)及定义显示帮助文本相关的插件行为。 可用特性取决于插件类型。仅可指定自定义插件特性。 |
命令 |
|
可用性选项 |
针对每个绘图状态,指定条件是否必需(绘图状态条件对于命令的活动必不可少)、禁止(只要该绘图状态条件存在,命令则被停用)或可以忽略(绘图状态不会影响到命令激活) |
工具提示帮助 |
指定菜单命令帮助文本;描述菜单命令的帮助文本,会在光标停留于命令上方时显示(当前仅适用于 Mac) |
上下文帮助覆盖 |
输入 URL(以 http: 开始)以指定包含帮助信息的网页。要相对于 Vectorworks 程序文件夹指定一个文件,指明以 ./ (句点与右斜杠)起始的路径。 |
版本创建于 |
指定插件创建时的 Vectorworks 版本号。例如:针对 Vectorworks 2015、2016 和 2017,分别采用 20、21 和 22。 |
版本修改于 |
指定插件上一次修改时的 Vectorworks 版本号。例如:针对 Vectorworks 2015、2016 和 2017,分别采用 20、21 和 22。 |
版本废弃于 |
指定插件退役时的 Vectorworks 版本号。例如:针对 Vectorworks 2015、2016 和 2017,分别采用 20、21 和 22。 |
工具 |
|
工具栏字符串 |
指定要在工具栏内显示的描述性文本;这通常包括对象的名称,而且可包含指明用户要执行的操作的文本 |
图标 |
如果需要,可用一个自定义图标代替插件的默认图标。使用第三方图标编辑器创建两个版本的图标:一个针对标准分辨率显示,另一个针对高分辨率显示: ● 标准分辨率:图像居中于一块 26 像素宽乘以 20 像素高的区域中。以 .png 格式保存图标。 ● 高分辨率:图像居中于一块 52 像素宽乘以 40 像素高的区域居中。以 .png 格式保存图标,名称与标准分辨率图像相同,但在文件名末尾添加 “@2x” 后缀。例如:如果标准分辨率图标被命名为 3DModelingToolSet.png,则高分辨率图标必须命名为 3DModelingToolSet@2x.png;否则此程序不能找到此图标。 单击导入 PNG 图标以导入标准分辨率图标;如果高分辨率图标也以 @2x 名称命名,则软件亦会自动高分辨率图标。Vectorworks 程序针对设备的分辨率自动显示相应的图像。 |
投影 |
确定什么视图投影必须为活动。如果需要三维投影,则视图被更改。如果需要二维投影,则为此工具激活“屏幕平面”。组合投影并不会影响到视图投影。 |
执行脚本 |
工具被默认设置为选定后立即执行。但在某些情况下,可能需要脚本执行等待鼠标移动(比如基于用户鼠标移动互动式绘制的工具)。 |
上下文帮助覆盖 |
输入 URL(以 http: 开始)以指定包含帮助信息的网页。要相对于 Vectorworks 程序文件夹指定一个文件,指明以 ./ (句点与右斜杠)起始的路径。 |
版本创建于 |
指定插件创建时的 Vectorworks 版本号。例如:针对 Vectorworks 2015、2016 和 2017,分别采用 20、21 和 22。 |
版本修改于 |
指定插件上一次修改时的 Vectorworks 版本号。例如:针对 Vectorworks 2015、2016 和 2017,分别采用 20、21 和 22。 |
版本废弃于 |
指定插件退役时的 Vectorworks 版本号。例如:针对 Vectorworks 2015、2016 和 2017,分别采用 20、21 和 22。 |
工具提示帮助 |
指定光标停留于面板中对象图标上方时要显示的帮助文本 |
对象 |
|
图标 |
如果需要,可用一个自定义图标替代默认图标。利用一个第三方图标编辑器,创建一个 8 位图像,于一块 26 像素宽、20 像素高的区域内居中。按 .png 格式保存图标,并单击导入 PNG 图标以将其导入。 |
投影 |
确定什么视图投影必须为活动。如果需要三维投影,则视图被更改。如果需要二维投影,则为此工具激活“屏幕平面”。组合投影并不会影响到视图投影。 |
执行脚本 |
对象被默认设置为选定后立即执行。但在某些情况下,可能需要脚本执行等待鼠标移动(比如基于用户鼠标移动互动式绘制的对象)。 |
默认类 |
指定对象插入时的默认类;如果此类在放置对象时不存在,则会自动创建 |
上下文帮助覆盖 |
输入 URL(以 http: 开始)以指定包含帮助信息的网页。要相对于 Vectorworks 程序文件夹指定一个文件,指明以 ./ (句点与右斜杠)起始的路径。 |
版本创建于 |
指定插件创建时的 Vectorworks 版本号。例如:针对 Vectorworks 2015、2016 和 2017,分别采用 20、21 和 22。 |
版本修改于 |
指定插件上一次修改时的 Vectorworks 版本号。例如:针对 Vectorworks 2015、2016 和 2017,分别采用 20、21 和 22。 |
版本废弃于 |
指定插件退役时的 Vectorworks 版本号。例如:针对 Vectorworks 2015、2016 和 2017,分别采用 20、21 和 22。 |
工具提示帮助 |
指定光标停留于面板中对象图标上方时要显示的帮助文本 |
选项 (仅限自定义参数对象类型) |
|
执行选项 |
与符号类似,亦可向对象指派预先定义的文档放置插入选项。这些选项能够让对象妥善地与墙或其他高级 Vectorworks 对象类型互动。命令和工具插件不具备插入选项设置。 默认情况下,只有编辑对象参数或控制点的时候,才会重新计算对象几何图形。重新计算对象几何图形时,字体、文本大小或线条颜色等特性的文件默认设置,都会重新应用于该对象。如果自对象被放置或上一次被编辑起,上述设置有任何修改,则对象的外观也可能发生变动。 只要对象参数有变化,就会调用该脚本。此外,对于重新计算对象很重要的实例(例如,放入墙中的窗),当对象被旋转(重置旋转)或移动(重置移动)时,该脚本就会导致几何形状被重新计算。 或者,插件脚本可变成一个事件句柄(基于事件的);之后脚本务必要对一个小的应用程序事件集做出响应。对于事件处理脚本相关的样本和文档,请访问 vectorworks.net 的“支持区域”。 |
插入墙中 |
为对象选择墙插入选项设置。请参阅 创建 符号定义。 对于不需要插入选项的对象,保留选项的默认设置。 |
定义插件参数之后,单击确定以返回“插件管理器”。
~~~~~~~~~~~~~~~~~~~~~~~~~