SolidWorks Composer API应用小窥

作者：暂无

来源：《智能制造》 2015年第11期

撰文/Dassault Systemes 马跃

一、引言

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 变成互动的交流工具，使得对于产品的展示更加生动和全面。

我们首先要准备一个已经制作完毕的SolidWorksComposer 数据文件，即SMG 文件，将这个文件发布到Word 中。然后打开一个Word 文档，当然也可以是固定的模板，我们这里新建一个新Word 文件。然后在Word中取得SolidWorks Composer 开发控件，基于MicrosoftOffice Word 2003 版和2007 版本的操作会略有不同。

2003 版本的操作流程为：视图→工具栏→控件工具箱→其他控件；2007 版本的操作流程为：单击PowerPoint 选项，单击常规→在功能区显示“开发工具”选项卡。在功能区开发工具下，单击其他控件。

以上两个版本， 都单击选择3DVIA ComposerPlayer ActiveX；点击后，在Word 中的合适位置，拖动放置一个窗口。这个窗口就是在Word 中展示SolidWorksComposer 文件的视区。

鼠标右键单击对象，并选择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 是所有作用在3DVIAComposer 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 的产品展示能力，让企业的产品展示、说明文档内容更加丰富。