OpenCASCADE6.8.0 Reference Manual Serach Problem

eryar@163.com

1. Problem

有网友反映OpenCASCADE6.8.0的Reference Manual的搜索功能不好用，以前没注意，自己试了下，的确在本机上不能正确搜索出给出的关键字相关的内容。如下图所示，在搜索框中输入gp_Pnt：

Figure 1. Search class gp_Pnt

结果没有出来想要的内容，如下图所示：

Figure 2. Search Result in the Reference Manual

从上图可以看出，搜索使用了search.php来执行搜索功能，所以得出结论这个搜索功能需要放在支持php的服务器上才能正确执行搜索功能。即在OpenCASCADE的官网上是正确的，如下所示：

http://dev.opencascade.org/doc/refman/html/search.php?query=gp_Pnt

2. Solution

OpenCASCADE是使用Doxygen来根据源程序自动生成这个参考文档的，所以从源头上来分析，找出原因。若想生成些文档，需要如下图所示的第三方程序：

Figure 3. Documentation System Prerequistes

下载好这些第三方程序后，只需要运行gendoc.bat批处理，即可自动生成这个Reference Manual了。如下图所示：

Figure 4. Use gendoc.bat file to generate document automatically

其实主要还是依赖了Tcl脚本的强大功能来查找及设置那些第三方程序，从而使文档生成自动化。从中可以看出，Tcl/Tk脚本在OpenCASCADE中的又一应用，除了Draw Test Harness以外。所以，熟悉Tcl/Tk脚本不仅有利于对OpenCASCADE程序的Draw模块的理解，及其自动化测试的实现；还有利于平时为程序开发提供一些自动化的脚本，来减轻程序开发过程中的一些机械劳动。运行gendoc.bat可以看到有如下选项：

Figure 5. The options of gendoc.bat

从上面的选项可以看出，生成文档时可以指定生成的格式，如html, pdf, chm；还可以指定生成OCCT的哪些模块需要生成Reference Manual；其中导致搜索有问题的是指定搜索模式，其中有4种模式可供选择：none/local/server/external，从中可以看出 OpenCASCADE的安装包中提供的是Server模式，所以在本机上不好用了。如果要在本机使用搜索功能，可以自己来生成这些文档，但是要指定搜索模式为local。

3. Conclusion

OpenCASCADE使用Doxygen及一些第三方程序来自动生成文档，简化程序开发过程中的文档工作。尤其是Tcl/Tk脚本的使用，让重复机械的劳动由电脑来自动完成，提高工作效率及编程的乐趣。

如果想使用搜索功能，可以自己运行gendoc.bat并指定搜索模式为local即可解决问题。

4. References

1. OpenCASCADE Documentation System.

转载于:https://www.cnblogs.com/opencascade/p/4167883.html

OpenCASCADE6.8.0 Reference Manual Serach Problem相关推荐

HTML4.0 / XHTML 1.0 Reference Manual
HTML 4.01 / XHTML 1.0 参考手册转载自:www.w3school.com.cn Next Page 按字母顺序排列 DTD:指示在哪种 XHTML 1.0 DTD 中允许该标签. ...
Book: Programming with Libevent(2)--A Libevent Reference Manual(1)
A Libevent Reference Manual 参考链接 R0: Preliminaries Libevent from 10,000 feet The Libraries The Heade ...
整理在翻译与校对Spring 2.0 Reference时使用DocBook时的技巧与注意点
整理在翻译与校对Spring 2.0 Reference时使用DocBook时的技巧与注意点一.XML文件的编辑与校对翻译校对时,在XML文件头前增加: [code] <!DOCTYPE c ...
基于UAAG2.0 Reference的移动无障碍案例（四）
原文:https://www.w3.org/TR/IMPLEMENTING-UAAG20/mobile 翻译: CSDN 审校:张昆刘辉刘彪沈广荣(信息无障碍研究会) 本页列举了基于<UA ...
翻译第11章 of IEEE Std 1666-2011 IEEE Standard for Standard SystemC Language Reference Manual
11. TLM-2.0 core interfaces 11. TLM-2.0 核心接口 In addition to the core interfaces from TLM-1, TLM-2.0 ...
翻译第10章 of IEEE Std 1666-2011 IEEE Standard for Standard SystemC Language Reference Manual
10. Introduction to TLM-2.0 第10章.TLM-2.0的介绍 10.1 Background 10.1 背景 The TLM-1 standard defined a set ...
[MySQL Reference Manual] 7 备份和恢复
7. 备份和恢复本章主要会介绍: 1.备份的类型:逻辑备份,物理备份,全备和增量4种 2.创建备份的方法 3.还原方法,包括还原到时间点 4.备份计划,压缩和加密 5.表维护,恢复损坏的表 7. 备 ...
[MySQL Reference Manual] 5 MySQL 服务管理
5. MySQL 服务管理 5. MySQL 服务管理 5.1 The Mysql Server 5.2 Mysql 服务日志 5.2.1 选择General query log和slow query ...
[MySQL Reference Manual] 24 MySQL sys框架
24 MySQL sys框架 24 MySQL sys框架... 1 24.1 sys框架的前提条件... 1 24.2 使用sys框架... 2 24.3 sys框架进度报告... 3 24.4 s ...
不用于mysql权限管理的24260_[MySQL Reference Manual] 24 MySQL sys框架
24 MySQL sys框架 24.1 sys框架的前提条件在开始使用sys框架之前,有一些前提条件,sys需要mysql 5.6或者更高版本.因为sys是performance_schema的替代 ...

OpenCASCADE6.8.0 Reference Manual Serach Problem

OpenCASCADE6.8.0 Reference Manual Serach Problem

OpenCASCADE6.8.0 Reference Manual Serach Problem相关推荐

最新文章

热门文章