VIRTOOLS SDK

### 使用Virtools SDK与VC++6.0编写BuildingBlocks #### 一、引言 Virtools是一款用于创建交互式3D应用的软件平台，而BuildingBlocks（简称BB）则是Virtools中的基本构建单元，用于定义特定功能的行为。通过Virtools SDK（Software Development Kit），开发者可以扩展Virtools的功能，创造自定义的BuildingBlocks。本文将详细介绍如何使用Virtools SDK和VC++6.0来开发BuildingBlocks，并通过一个具体实例来展示整个过程。 #### 二、准备工作 在正式开始之前，需要完成以下准备工作： 1. **安装必要的开发工具**： - Microsoft Visual C++ 6.0 - Virtools SDK 2. **配置开发环境**： - 将Virtools SDK中提供的BuildingBlocks向导文件`VirtoolsBehaviorsAppWizard.awx`复制到`Microsoft Visual Studio\Common\MSDev98\Templates`目录下。 - 启动VC++6.0并执行`File -> New`，在弹出的对话框中选择`Project`分类下的`Virtools BB`选项。 #### 三、创建BuildingBlocks项目 1. **项目命名**： - 在`Project Name`栏中输入项目的名称，例如`MyBuildingBlocks`。 - 设置项目保存路径。 2. **项目配置**： - 勾选`Behavior`和`Manager`两个选项。`Behavior`是必须勾选的，因为它代表了BuildingBlock的核心行为；`Manager`则用于管理BuildingBlock中可能用到的枚举类型等自定义数据类型。 - 输入BuildingBlock的类别名称，例如`MyBBs`。 - 描述中可以填写简短的说明，例如`"Showtime Set Windows Always Top Exit Your Proceeding"`。 - 在`Behavior Flags`中可以不勾选任何选项，以便简化代码实现。 - 完成上述步骤后点击`Next`继续。 3. **设置SDK与Virtools目录**： - 配置SDK目录和VT程序目录等信息。 - 单击`Finish`完成设置。 #### 四、编写BuildingBlocks 1. **添加枚举类型**： - 在`MyBB.h`文件顶部添加枚举类型定义，例如： ```cpp typedef enum SHOWTIME_TYPENUM { OSTYPE = 0x00000000, // 24小时显示时间 OSDATE = 0x00000001, // 显示当前日期 UNIX_TIME_AND_DATE = 0x00000002, // 完整显示日期，时间 HOUR_TIME_12 = 0x00000003, // 以12小时方式显示 } Enumeration; ``` - 使用`#define`宏来设置枚举变量的GUID，例如： ```cpp #define GUID_SHOWTIMETYPENUM MyBBGUID ``` 2. **实现功能**： - 实现BuildingBlocks的三个功能： 1. **显示当前系统时间**：根据不同的格式显示时间。 2. **保持窗口始终在最前端**：确保BuildingBlocks对应的窗口始终保持在其他窗口之上。 3. **关闭指定程序或进程**：通过关闭进程的方式关闭特定的应用程序或进程。 #### 五、编译与测试 1. **编译项目**： - 执行`Build -> Rebuild All`以生成BuildingBlocks。 2. **测试BuildingBlocks**： - 在Virtools中启动项目，可以在BuildingBlocks列表中找到新创建的`MyBBs`类别，其中包含了自定义的BuildingBlock `Time_Top_ExitBB`。 #### 六、总结 通过上述步骤，我们成功地使用Virtools SDK和VC++6.0创建了一个自定义的BuildingBlock。本实例不仅展示了如何创建BuildingBlock的基本框架，还涉及到了如何定义枚举类型以及实现特定功能的方法。这对于希望进一步扩展Virtools功能的开发者来说是非常有价值的参考。 通过这种方式开发的BuildingBlocks，不仅可以提高Virtools的灵活性，还可以帮助开发者更高效地创建复杂的交互式3D应用程序。