用脚本编写的插件

创建和编辑脚本面板与脚本中所述,文档脚本允许通过 Vectorworks 文件的资源浏览器创建、保存和执行脚本。但是,用脚本编写的插件对象则让脚本可用于任何 Vectorworks 文件。三种插件类型 — 菜单命令 (.vsm)、工具 (.vst) 及对象 (.vso) — 都允许脚本作为菜单命令、工具面板以及资源浏览器库中的对象并入工作空间。

利用脚本创建的插件对象会变成可以优化并增强设计/绘制草图过程的自定义项目。它们支持标准的 Vectorworks 程序核心技术,比如捕捉、分类和高级对象编辑等,从而为其赋予同 Vectorworks 内置对象类型在本质上相同的状态。

用脚本编写的插件还提供增强的脚本便携性和平台独立性,从而能够轻松地将它们移至 Vectorworks,安装于 Mac 或 Windows 系统中。绘图中包含可以在不同国家用户之间交换的插件对象。插件可通过转换显示的名称和字符串完成本地化,以供其他国家使用。

插件的运行方式

用脚本编写的插件作为文件保存。它们将脚本代码和一个插件“包装”(一种定义插件特性及行为的编码数据头)结合到了一起。插件的分类、定义插件激活方式的特性之类的信息,或是插件要在 Vectorworks 应用程序框架内运转所需的任何其他信息,都包含于该数据头中。

插件类型

用脚本编写的插件的一项关键功能,就是与 Vectorworks 产品接口的无障碍集成。其菜单命令、工具和对象就像 Vectorworks 中的任何内置工具、对象和菜单项一样工作。就像内置菜单命令一样,用脚本编写的菜单命令亦可设置为需要特定文件条件(比如二维/三维视图指向,或某个选定的项目集合)才能激活。选定一个菜单命令或工具项后,插件所需的脚本及任何信息都会被载入内存,且插件脚本执行。Vectorworks 程序会利用插件提供的信息提供用户互动(比如捕捉)、菜单命令或工具的文件环境,从而执行其定义的操作。用脚本编写的工具,就像它们的内置对等工具一样,都使用智能光标和其他以工具为中心的 Vectorworks 程序功能。

插件对象拥有工具和符号两者的特性。插件对象可添加到工具面板和类似的工具项,但在使用中,它们会将对象实例放入文件,与符号工具将符号放入文件很相似。对象脚本亦可通过文件中出现的事件调用。放置的对象实例可利用“对象信息”面板进行修改,从而编辑用于定义对象的参数值,而且,这些变更会导致定义对象的脚本执行对象的重绘。会强制重新生成文件的全局文件变更,亦可导致文件中放置的对象脚本执行。这些特性赋予了插件对象极大的灵活性,以各种方式在文件内显示。

插件对象亦可搭配资源浏览器使用,以创建放置后所需编辑最少的预先配置对象实例。基于单个插件对象的不同对象配置的库,可以轻松通过资源浏览器创建和检索。

插件文件位置

Vectorworks 程序启动时,它会搜索任何用脚本编写的插件文件,并注册必要的信息,以激活和管理插件。还于关联插件文件所在的同一个文件夹内搜索包含文件。

软件会按以下顺序在以下位置搜索插件:

    在用户的“插件”文件夹,或在用户“插件”文件夹中的别名或快捷方式

    在 Vectorworks “插件”文件夹及其子文件夹

    Vectorworks“插件”文件夹中指向 Vectorworks 层次结构之外位置的别名或快捷方式

用户的“插件”文件夹在因平台而异的位置中。

    Windows:C:\ Users \<用户名>\AppData\Roaming\Nemetschek\Vectorworks\2016\Plug-Ins

    Mac:/ 用户/<用户名>/资源库/Application Support/Vectorworks/2016/

如果插件文件首先被创建,则始终将其放置在用户的“插件”文件夹中。

Vectorworks 程序启动或某工作空间被激活后,只有在其位于“插件”文件夹、其子文件夹、用户的“插件”文件夹及子文件夹、或是按别名 (Mac) 或快捷方式 (Windows) 参照的文件夹中的情况下,插件才于当前会话中可用。

如果复制插件文件存在于多处,则文件夹层次结构中第一个出现的实例是被使用的那个。

从软件的某个旧版本升级时,插件文件位置的灵活性就体现出优势了。因为第三方插件可存储在独立于应用程序的文件夹内,所以在安装更新时可轻松参照。将“插件”文件夹复制到当前版本的文件夹中,或是利用别名或快捷方式参照它们,更新时只需做这些。

~~~~~~~~~~~~~~~~~~~~~~~~~

创建用脚本编写的 插件

 

vectorworks.cn