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