3D Slicer 编译、调试、规范化的开发

1.编译

Step1:CMake生成Slicer工程文件

使用Cmake生成Slicer的解决方案(Solution)包括两小点:
  • 指定源代码目录:C:/myProjects/Slicer4;目标目录:C:/myProjects/Slicer4-SuperBuild-Debug
  • Configure后,添加qmake路径:QT_QMAKE_EXECUTABLE=C:/myProject/Qt-4.6.3/bin/qmake.exe(要根据实际情况进行修改)。Generate后完成工程的创建。

Step2:编译Slicer

 
打开Slicer.sln,整个工程有28个项目组成,包括我们熟悉的VTK、ITK、DCMTK、CTK等库。鼠标右键点击ALL_BUILD编译所有项目。等待编译完成,大概3~4小时~~~
Notice1:每个项目在工程中所起到的作用不同,其编译过程也遵循一定的顺序,如果其中一个项目处想问题,那么在这个项目编译之后的所有项目都会出错。
Notice2:如果真的很不幸,在编译的过程中出现了错误。考虑到重新编译一次时间太长,可以按照输出窗口的提示进行纠错,然后从此处为起点进行编译。
Notice3:工程中的VTK、ITK等项目的源代码并没有包含在Slicer的源码中,他们是在编译的过程中,利用Git或SVN向远程服务器请求下载。因此编译速度的快慢很大程度上取决于网络环境。

2.调试

编译之后还无法对Slicer的程序进行调试,需要以下几个步骤:
1) cd slicer-superbuild-debugslicer-build
2) cmake.exe –VV --debug-output .    (注意这里还有一个 . )
3) slicer.exe --VisualStudio slicer.sln /out buildlog.txt /build  然后相关文件生成在切片机构建/ bin /调试目录
4) slicerQt-real.exe 就是调试文件.
5) slicer.exe –VisualStudio slicer.sln  
打开VisualStudio后,浏览左边的项目,将qSlicerQT设置为启动项目,否则会被要求指定调试的项目。

3.Slicer的缺陷跟踪系统

目前,Slicer已经有超过120万代码,并变得越来越庞大。尽管3DSlicer管理人员在各种操作系统、各种硬件设备情况下调试,但由于功能复杂、代码庞大,也会出现管理人员无法发现的问题。
为了保证Slicer软件的质量,以及对功能的完成度进行控制,保证软件开发的顺利进行,3Dslicer项目采用缺陷跟踪系统Mantis对Slicer继续管理。
缺陷管理平台Mantis ,也做MantisBT,全称Mantis Bug Tracker。Mantis是一个基于PHP技术的轻量级的开源缺陷跟踪系统,以Web操作的形式提供项目管理及缺陷跟踪服务。个人可定制的Email通知功能,每个用户可根据自身的工作特点只订阅相关缺陷状态邮件。
报告3DSlicer应用程序相关问题流程:
1.https://issues.slicer.org/view_all_bug_page.php在View Issues中创建一个话题;
2.详细填写问题缘由;
3.箱Slicer开发者邮箱发送一份邮件,邮件中必须包含创建的话题,邮件格式名称如下:[Bug<IssueNumber>]bug名称。如下所示:

4.规范化的3DSlicer开发

单词缩写的大小写应该保持一致,保持大写或小写。例如
  • RASToSlice   √   RasToSlice  ×
  • vtkMRML      √    vtkMrml    ×
  • vtkSlicer        √    vTKSlicer   ×
单词应该拼写完整。例如
  • GetWindow not GetWin
文件名称必须遵循驼峰式大小写约定,例如
  • TestMyFeature.cxx not Test-My_Feature.cxx
注释规则
  • 大部分注释应该写在头文件中。
  • 代码做出修改后及时更新注释。
  • 使用关键字“ odo”(待办事项)来标记点需要重新审视的代码。
  • 源文件中注释掉的代码块也需要进行注释,如果需要,可以插入svn的版本链接作为注释。
其他规则
  • 3D视图中使用RAS坐标。
  • 所有单位为毫米表示。
  • 每行代码不超过80个字符。
原文地址:https://www.cnblogs.com/ybqjymy/p/14235278.html