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/

5. http://www.tcl.tk/

OpenCascade Draw Test Harness