OpenCascade Draw Test Harness
eryar@163.com
Abstract. Draw is a command interpreter based on Tcl/Tk and a graphical system used to test and demonstrate OpenCascade modeling libraries. It provides a flexible and easy to use means of testing and demonstrating the OCCT modeling libraries. By a given command of Tcl, you can find the implentation code for that command by OpenCascade, the code could be as a demo to use of OCC modeling libraries. So this is the most effectively way of use OpenCascade.
Key words. OpenCascade, Tcl/Tk, Testing, Scripts
1. Introduction
Draw Test Harness提供了灵活和易于使用的方式来测试、演示OpenCascade的建模算法。可用来交互的创建、显示和修改曲线、曲面及拓朴形状。你也可以自己写Tcl脚本来自定义Draw或使用脚本来实现自动化测试。也可以为Draw添加新的自定义的命令。
因为Draw是基于Tcl/Tk脚本的，所以可以根据OpenCascade自定义的命令名称来找到相关的实现，这个实现应该是使用OpenCascade最有效的方式，也是官方使用OpenCascade的方式，具有很好的参考价值。
还可在Draw 中使用Tcl脚本来实现概念建模，如果结果和预期一致，可再把Tcl命令相对应的C++代码写到程序中，提高编程效率。
本文主要介绍如何根据OpenCascade中实现的命令找到相关的实现代码，作为编程时的参考，避免了用C++代码来实现一些功能时自己来摸索，从而浪费不必要的时间。
2. Using Tcl/Tk
先给出Draw中使用脚本出来的效果的例子，再介绍找出命令实现代码的方法。如下图所示为用脚本在Draw中产生的效果：
Figure 2.1 A blend test in Draw Test Harness
其实现的脚本如下所示：
pload ALL
vinit
vgrid
vsetgradientbg 0 0 180 255 255 255 2
vzbufftrihedron
# run a test
source tests/blend/begin
source tests/blend/buildevol/a2
vsetdispmode 1
vdisplay result
vfit
Figure 2.2 Tcl script
将上述脚本代码保存到samples/tcl文件夹下，文件名为init.tcl，再启动Draw，输入命令：
Figure 2.3 Use the Tcl file
3. Find code from Draw Test
因为Draw是基于Tcl/Tk实现的解释器，所以根据Tcl中自定义命令的方法，可以找出OpenCascade中这些命令的实现代码。更方便的做法是直接输入命令名称，再在所有的源代码中搜索相关文件即可。如上述脚本中的vgrid命令，是打开、关闭栅格，可以直接搜索vgrid，得到结果如下所示：
Figure 3.1 Find command in Files
Figure 3.2 Find Result of the Command
得到相关的代码使用方法如下图所示：
Figure 3.3 The Command function code
依此类推，其他Draw中的命令都可以找到相关的实现代码，这些代码都可作为编程的依据，有助于OpenCascade的正确、高效使用。
4. Conclusion
从上可知，如果需要OpenCascade的什么功能，可以先在Draw Test Harness中试试看，如果在Draw Test Harness中可以实现，再找出其实现那个命令的代码，再参考代码实现所需要功能即可。这样编程使用OpenCascade应该是轻松和高效的，因为Tcl是解释执行，不像C++那样需要编译时间。
5. References
1. Tcl and the Tk Toolkit
2. Practical Programming in Tcl and Tk
3. Tcl/Tk A Developer’s Guide
4. OpenCascade Test Harness User’s Guide
5. http://sourceforge.net/projects/tcl/
PDF Version: OpenCascade Draw Test Harness