概念:脚本插件
如创建并编辑脚本面板和脚本中所述,文档脚本允许使用“资源管理器”通过特定文件创建、保存和执行脚本。但是,用脚本编写的插件对象则让脚本可用于任何 Vectorworks 文件。三种插件类型 — 菜单命令 (.vsm)、工具 (.vst) 及对象 (.vso) — 都允许脚本作为菜单命令、工具面板以及资源库中的对象并入工作空间。
利用脚本创建的插件对象会变成可以优化并增强设计/绘制草图过程的自定义项目。它们支持标准的 Vectorworks 程序核心技术,如吸附、分类和高级对象编辑,使它们与 Vectorworks 内置对象类型的状态基本相同。
用脚本编写的插件还提供增强的脚本便携性和平台独立性,从而能够轻松地将它们移至 Vectorworks,安装于 Mac 或 Windows 系统中。绘图中包含可以在不同国家用户之间交换的插件对象。通过翻译显示的名称和字符串,插件可以本地化以便在其他国家使用。
插件如何工作
脚本插件保存为文件。它们将脚本代码与插件“包装器”结合在一起,包装器是一个编码标题,它定义插件的特性和行为。如插件的类别、定义如何激活插件的特性或插件在 Vectorworks 应用程序框架中运行所需的任何其他信息等信息都被包含在标题中。
插件类型
脚本插件的一个关键特性是它们能够顺利地集成到 Vectorworks 产品界面中。其菜单命令、工具和对象就像 Vectorworks 中的任何内置工具、对象和菜单项一样工作。就像内置菜单命令一样,用脚本编写的菜单命令亦可设置为需要特定文件条件(比如二维/三维视图指向,或某个选定的项目集合)才能激活。选定一个菜单命令或工具项后,插件所需的脚本及任何信息都会被载入内存,且插件脚本执行。Vectorworks 程序使用插件提供的信息提供用户交互(如吸附)和文件环境,以便菜单命令或工具执行其定义的操作。脚本工具和它们的内置工具一样,利用 SmartCursor 和其他以工具为中心的 Vectorworks 程序特性。
插件对象拥有工具和符号两者的特性。插件对象可以添加到工具面板并类似于工具项,但在使用中,它们将对象的实例放置在文件中,就像符号工具将符号放置在文件中一样。对象脚本亦可通过文件中出现的事件调用。放置的对象实例可利用“对象信息”面板进行修改,从而编辑用于定义对象的参数值,而且,这些变更会导致定义对象的脚本执行对象的重绘。会强制重新生成文件的全局文件变更,亦可导致文件中放置的对象脚本执行。这些特性使插件对象能够非常灵活地在文件中显示。
插件对象亦可搭配“资源管理器”使用,以创建放置后所需编辑最少的预先配置对象实例。基于单个插件对象的不同对象配置的库,可以轻松通过“资源管理器”创建和检索。
插件对象有以下四种不同类型:点、线性、矩形和路径。每个类型的编辑方式和在绘图中的放置方式各不相同。
点对象:通过在绘图中单击一次以指定位置,然后单击第二次以设置旋转角度来放置点插件对象。点插件对象无法使用光标编辑(调整大小或旋转);它们可使用“对象信息”面板进行编辑。
线性对象:线性插件对象通过两次单击按特定方向放置。对象可通过在线的任意一端单击形状重调图柄来调整大小或旋转。也可以使用“对象信息”面板进行编辑。
矩形对象:矩形插件对象通过中心线放置(单击以指定位置,单击以设置长度,单击以设置宽度)模式或边缘放置(单击以设置角度,单击以设置长度,单击以设置宽度)模式进行放置。可通过拖动其选择图柄来调整对象大小,或通过“对象信息”面板进行编辑。
路径对象:路径插件对象通过沿路径定义顶点的一连串单击创建。根据所使用的路径类型,有两种不同类型的路径插件对象。二维路径插件对象使用多段线路径,三维路径插件对象使用三维 NURBS 曲线作为其路径。路径插件对象可直接使用重调形状工具进行编辑。还可通过修改 > 编辑组,或通过“对象信息”面板来编辑它们。
插件文件位置
当 Vectorworks 程序启动时,它会搜索任何脚本插件文件,然后注册激活和管理插件所需的信息。在关联插件文件所在的同一文件夹中搜索包含文件。
软件会按以下顺序在以下位置搜索插件:
在用户的“插件”文件夹,或在用户“插件”文件夹中的别名或快捷方式
在 Vectorworks “插件”文件夹及其子文件夹
Vectorworks“插件”文件夹中指向 Vectorworks 层次结构之外位置的别名或快捷方式
用户的插件文件夹存在于平台特定的位置。
Windows:C:\Users\<Username>\AppData\Roaming\Nemetschek\Vectorworks\2023\Plug-Ins
Mac:/Users/<Username>/Library/Application Support/Vectorworks/2023/Plug-Ins
第一次创建插件文件时,它们总是被放置在用户的插件文件夹中。
Vectorworks 程序启动或某工作空间被激活后,只有在其位于“插件”文件夹、其子文件夹、用户的“插件”文件夹及子文件夹、或是按别名 (Mac) 或快捷方式 (Windows) 参照的文件夹中的情况下,插件才于当前会话中可用。
如果复制插件文件存在于多处,则文件夹层次结构中第一个出现的实例是被使用的那个。
从软件的某个旧版本升级时,插件文件位置的灵活性就体现出优势了。因为第三方插件可存储在独立于应用程序的文件夹内,所以在安装更新时可轻松参照。升级时,只需将插件文件夹复制到当前版本的文件夹,或使用别名或快捷方式参照它们。