论文部分内容阅读
一、引言
SolidWorks Composer是 SolidWorks整体解决方案中一款基于 3D CAD数据来创建清晰、有效的产品说明文档的软件，可以极大地丰富企业产品展示、说明的形式。 SolidWorks Composer具有优秀的交互式动画制作能力，可以呈现复杂的产品动态图形内容。
除此之外，SolidWorks Composer还可以将自身的文档数据与主流的静态文档格式相结合，比如 PPT、Word、PDF和 HTML页面等格式。在与这些文档结合后，使用者还可以依照自己的想法定制一些创新功能来实现更多精彩的产品说明形式，让传统文档焕发活力，这就需要依靠SolidWorks Composer的 API，本文即是对此展开介绍。
下面将以在Word中嵌入SolidWorks Composer的SMG数据为例进行说明。
二、将 SolidWorks Composer数据发布到文档中
Microsoft Office Word是日常工作中主流的文档处理工具，也常用来制作企业的产品说明书和应用说明手册。借由 SolidWorks Composer我们可以让 Word变成互动的交流工具，使得对于产品的展示更加生动和全面。
我们首先要准备一个已经制作完毕的 SolidWorks Composer数据文件，即 SMG文件，将这个文件发布到Word中。然后打开一个 Word文档，当然也可以是固定的模板，我们这里新建一个新 Word文件。然后在 Word中取得 SolidWorks Composer开发控件，基于 MicrosoftOffice Word 2003版和2007版本的操作会略有不同。2003版本的操作流程为：视图→工具栏→控件工具箱→其他控件；2007版本的操作流程为：单击PowerPoint选项，单击常规→在功能区显示“开发工具”选项卡。在功能区开发工具下，单击其他控件。
以上两个版本，都单击选择3DVIA ComposerPlayer ActiveX；点击后，在 Word中的合适位置，拖动放置一个窗口。这个窗口就是在 Word中展示 SolidWorks Composer文件的视区。
鼠标右键单击对象，并选择3DVIA Composer PlayerActiveX/Properties，如图 1所示。
在 General标签中，File name是浏览要展示的 SMG文件，将我们需要引入的文件添加进来。
勾选 Pack 3DVIA Composer document选项，我们的方法其实是引入 SolidWorks Composer的文件到 Word中，选择该选项，可以将文件完全嵌入 Word中，以后使用的时候只需要单独保存 Word就可以，不需要将 SMG文件和 Word一起保存。如果没有勾选这个选项，保存 Word的时候，要连同 SMG一同保存，而且要处于同一个文件路径下，虽然看起来很复杂，但是这种设置可以让打开 Word的时候读取动画的速度加快了，针对这个选项还需要用户亲自体验一下，选择是否应用。如图 2所示。
在 Layout标签中（图 3），可选择哪些工具要开放在操作窗口中，在这里我们选择全部关闭，这样视图中的SMG文件只能移动和选择，没有其他工具条。去除 Layout的选项界面后，如图 4所示。
注意：以上操作一定是在控件设计模式下完成，退出设计模式后（图 5），可以浏览到视图。
当然，我们也可以实现在 Word中，还原基本的 SMG文件操作环境，比如一些光源、环境的设置，技术渲染的模式设置等，这些都可以在 Layout的中选择相应的选项，然后生成。如图 6所示。
三、通过 API增加按钮
回到设计模式，在开发工具中，添加一个 Active控件的命令按钮（图 7）。这是在 Word中添加一个可以点击的按钮，来完成我们想要实现的动作。这个方法同样适用于PPT、Excel等工具。
添加一个按钮后，在按钮上右键单机属性，可以填写按钮的显示名称（Caption中填写），比如我们想更换部件的颜色，可以设定三个按钮，以本案例中的虎式坦克模型的不同颜色炮管为例，分别命名成“红色炮管”、“绿色炮管”和“蓝色炮管”；在属性中，可以设置按钮的其他文字显示细节，比如字体、大小和颜色，大家可以按照喜好进行按钮的设置。双击按钮“红色炮管”打开 Microsoftvisual basic，在 private sub和 end sub之间输入：DS3DVIAPlayerActiveX1.GoToConfiguration "c"。
四、解析 API格式
DS3DVIAPlayerActiveX1是所有作用在 3DVIA Composer Active控件下的 API明了的前缀，意味着每次添加的 API接口如果是调用 3DVIA Composer Active控件，则必须都要使用这个前缀。GoToConfiguration是提供的负责转换配置的 API，在这里可以理解成转换视图。所以 GoToConfiguration"c"可以理解成转换到视图 C。
这里应用了一个在 SMG文件中，名称是 C的视图。如图 8所示。
与“红色炮管”同理，我可以依次为“绿色炮管”、“蓝色炮管”添加 API，但是需要注意的是，同一个按钮里，添加不同的 API需要将 DS3DVIAPlayerActiveX1按照添加的控件顺序，变成 DS3DVIAPlayerActiveX2、DS3DVIAPlayerActiveX3。注意：不同按钮之间不用变换顺序。
设置完成后，我们就可以在 Word中，通过点击按钮来给虎式坦克更换炮管的颜色了，如图 9所示。当然这只是一个简单的示范，利用 API的接口，我们可以处理更多的动作，比如视图的切换，固定配置的展示等。
五、调用其他 API
SolidWorks Composer提供了诸多可方便添加的 API接口，调用和查询 API的方法也很简单，在 SolidWorksComposer软件中，找到帮助，找到编程向导，如图10所示。
找到 SolidWorks Composer player active API的方法如图 11所示。
SolidWorks Composer player active API提供了很多不同功能的API 接口，如图12 所示。
这里面的接口示意可以根据英文直接理解其含义，比如ChangMarker 是完成SMG 中的标记变化， 通常我们在SMG 建立不同的标记来记录一段产品动画不同时期的状态，如果选择了ChangMarker 实际上就是在Word 或者PPT 中增加了“下一步”的操作。这里不详细解释每种API 的作用了，感兴趣大家可以自己试试。
六、结语
以上仅是对SolidWorks Composer 的API 应用的小窥，SolidWorks Composer 功能强大，通过其API 可以进一步增强SolidWorks Composer 的产品展示能力，让企业的产品展示、说明文档内容更加丰富。
SolidWorks Composer是 SolidWorks整体解决方案中一款基于 3D CAD数据来创建清晰、有效的产品说明文档的软件，可以极大地丰富企业产品展示、说明的形式。 SolidWorks Composer具有优秀的交互式动画制作能力，可以呈现复杂的产品动态图形内容。
除此之外，SolidWorks Composer还可以将自身的文档数据与主流的静态文档格式相结合，比如 PPT、Word、PDF和 HTML页面等格式。在与这些文档结合后，使用者还可以依照自己的想法定制一些创新功能来实现更多精彩的产品说明形式，让传统文档焕发活力，这就需要依靠SolidWorks Composer的 API，本文即是对此展开介绍。
下面将以在Word中嵌入SolidWorks Composer的SMG数据为例进行说明。
二、将 SolidWorks Composer数据发布到文档中
Microsoft Office Word是日常工作中主流的文档处理工具，也常用来制作企业的产品说明书和应用说明手册。借由 SolidWorks Composer我们可以让 Word变成互动的交流工具，使得对于产品的展示更加生动和全面。
我们首先要准备一个已经制作完毕的 SolidWorks Composer数据文件，即 SMG文件，将这个文件发布到Word中。然后打开一个 Word文档，当然也可以是固定的模板，我们这里新建一个新 Word文件。然后在 Word中取得 SolidWorks Composer开发控件，基于 MicrosoftOffice Word 2003版和2007版本的操作会略有不同。2003版本的操作流程为：视图→工具栏→控件工具箱→其他控件；2007版本的操作流程为：单击PowerPoint选项，单击常规→在功能区显示“开发工具”选项卡。在功能区开发工具下，单击其他控件。
以上两个版本，都单击选择3DVIA ComposerPlayer ActiveX；点击后，在 Word中的合适位置，拖动放置一个窗口。这个窗口就是在 Word中展示 SolidWorks Composer文件的视区。
鼠标右键单击对象，并选择3DVIA Composer PlayerActiveX/Properties，如图 1所示。
在 General标签中，File name是浏览要展示的 SMG文件，将我们需要引入的文件添加进来。
勾选 Pack 3DVIA Composer document选项，我们的方法其实是引入 SolidWorks Composer的文件到 Word中，选择该选项，可以将文件完全嵌入 Word中，以后使用的时候只需要单独保存 Word就可以，不需要将 SMG文件和 Word一起保存。如果没有勾选这个选项，保存 Word的时候，要连同 SMG一同保存，而且要处于同一个文件路径下，虽然看起来很复杂，但是这种设置可以让打开 Word的时候读取动画的速度加快了，针对这个选项还需要用户亲自体验一下，选择是否应用。如图 2所示。
在 Layout标签中（图 3），可选择哪些工具要开放在操作窗口中，在这里我们选择全部关闭，这样视图中的SMG文件只能移动和选择，没有其他工具条。去除 Layout的选项界面后，如图 4所示。
注意：以上操作一定是在控件设计模式下完成，退出设计模式后（图 5），可以浏览到视图。
当然，我们也可以实现在 Word中，还原基本的 SMG文件操作环境，比如一些光源、环境的设置，技术渲染的模式设置等，这些都可以在 Layout的中选择相应的选项，然后生成。如图 6所示。
三、通过 API增加按钮
回到设计模式，在开发工具中，添加一个 Active控件的命令按钮（图 7）。这是在 Word中添加一个可以点击的按钮，来完成我们想要实现的动作。这个方法同样适用于PPT、Excel等工具。
添加一个按钮后，在按钮上右键单机属性，可以填写按钮的显示名称（Caption中填写），比如我们想更换部件的颜色，可以设定三个按钮，以本案例中的虎式坦克模型的不同颜色炮管为例，分别命名成“红色炮管”、“绿色炮管”和“蓝色炮管”；在属性中，可以设置按钮的其他文字显示细节，比如字体、大小和颜色，大家可以按照喜好进行按钮的设置。双击按钮“红色炮管”打开 Microsoftvisual basic，在 private sub和 end sub之间输入：DS3DVIAPlayerActiveX1.GoToConfiguration "c"。
四、解析 API格式
DS3DVIAPlayerActiveX1是所有作用在 3DVIA Composer Active控件下的 API明了的前缀，意味着每次添加的 API接口如果是调用 3DVIA Composer Active控件，则必须都要使用这个前缀。GoToConfiguration是提供的负责转换配置的 API，在这里可以理解成转换视图。所以 GoToConfiguration"c"可以理解成转换到视图 C。
这里应用了一个在 SMG文件中，名称是 C的视图。如图 8所示。
与“红色炮管”同理，我可以依次为“绿色炮管”、“蓝色炮管”添加 API，但是需要注意的是，同一个按钮里，添加不同的 API需要将 DS3DVIAPlayerActiveX1按照添加的控件顺序，变成 DS3DVIAPlayerActiveX2、DS3DVIAPlayerActiveX3。注意：不同按钮之间不用变换顺序。
设置完成后，我们就可以在 Word中，通过点击按钮来给虎式坦克更换炮管的颜色了，如图 9所示。当然这只是一个简单的示范，利用 API的接口，我们可以处理更多的动作，比如视图的切换，固定配置的展示等。
五、调用其他 API
SolidWorks Composer提供了诸多可方便添加的 API接口，调用和查询 API的方法也很简单，在 SolidWorksComposer软件中，找到帮助，找到编程向导，如图10所示。
找到 SolidWorks Composer player active API的方法如图 11所示。
SolidWorks Composer player active API提供了很多不同功能的API 接口，如图12 所示。
这里面的接口示意可以根据英文直接理解其含义，比如ChangMarker 是完成SMG 中的标记变化， 通常我们在SMG 建立不同的标记来记录一段产品动画不同时期的状态，如果选择了ChangMarker 实际上就是在Word 或者PPT 中增加了“下一步”的操作。这里不详细解释每种API 的作用了，感兴趣大家可以自己试试。
六、结语
以上仅是对SolidWorks Composer 的API 应用的小窥，SolidWorks Composer 功能强大，通过其API 可以进一步增强SolidWorks Composer 的产品展示能力，让企业的产品展示、说明文档内容更加丰富。