Virtools Building Block的开发如何用sdk扩展.doc

Virtools Building Block的开发Building Blocks 作为Virtools的重要组成部分，在Virtools的开发中起了举足轻重的作用。Virtools软件本身自带了许多的BuildingBlocks，使用这些BB可以很轻松的开发出出色的作品。但是，由于用户开发的某些特殊用途，需要另外用到一些特殊功能的BB，这就需要使用Virtools 的SDK来开发Building Blocks。 准备工作：在SDK中提供给我们了一个开发Building Blocks的向导文件Virtools Behaviors AppWizard.awx，位于\SDK\Utils\目录下。把它拷贝到\Microsoft Visual Studio\Common\MSDev98\Template目录下。这样，在VC++的IDE环境中，就可以使用MFC Appwinzard来生成一个基本的Virtools Building Blocks架构了。 在Project中选择Virtools项，并填入工程名称，下一步进入定制窗口。 step 1，选择是behavior和manager step 2，在“ Enter Behavior Name ”填入behavior的名字，这一项不可空缺，因为这一名字将作为与该BB对应的C++文件的文件名，并将显示于Virtools应用程序中。输入框下方的按钮用于随机产生 GUID 。上下左右的按钮上点击选择输入、输出和输入输出变量的数量。（注意，这里，输入输出和输入输出变量是两个不同的概念，英文为Input、Output、Inputparameter、Outparameter。）并可点击相应项更改名称，比如点击In0，则In0变为蓝色，并在窗口左上方显示Name的输入框。下方的下拉列表框中选择BB的Virtools类。 step 3，一系列的复选框，用于定义BB的flag。下方则是callback回调函数。 step 4，若是在第一步钩选了manager项，则这一步为关于manager的选项。填入manager名，并选择ID等等。 step 5，依次填入插件介绍，作者信息、ID。并选择Virtools SDK的安装路径和Virtools Dev 的路径。 大功初成，这样便通过VC++ 的AppWinzard生成了一个BB的源代码。 打开文件浏览器，可发现几个主要的C文件和头文件。如My_Manager.h，这一个头文件的名字以setp 4中manager的名为名，另有与此头文件对应的一C++文件。My_BB_Name.cpp，这一文件以step 2中填入的BB的名字命名。还有一个以工程名命名的文件，如Project_Name.cpp。这几个文件各有所用，所有代码相互作用。以下皆用上述文件名一一介绍。 Project_Name.cpp，这一文件: 其中CKPluginInfo* CKGetPluginInfo(int Index)这一函数最为重要，主要负责插件的信息的注册。 CKPluginInfo* CKGetPluginInfo(int Index) { ????? int Plugin = 0; ????? g_PluginInfo[Plugin].m_Author??????????? = Virtools; ????? g_PluginInfo[Plugin].m_Description??????? = Some information about Plugin; ????? g_PluginInfo[Plugin].m_Extension????????? = ; ????? g_PluginInfo[Plugin].m_Type????????????????? = CKPLUGIN_BEHAVIOR_DLL; ????? g_PluginInfo[Plugin].m_Version?????????? = 0 ????? g_PluginInfo[Plugin].m_InitInstanceFct = NULL; ????? g_PluginInfo[Plugin].m_GUID????????????????? = CKGUID(0x1BF1A1B2,0x9CB71500); ????? g_PluginInfo[Plugin].m_Summary?????????? = Enter your summary; ????? Plugin++; ????? g_PluginInfo[Plugin].m_Author??????????? = Virtools; ????