dcmtk程序包简介

dcmtk程序包简介

***该文简单列出了dcmtk程序包的简介，包括主要接口类的简单说明，可用工具以及一些例子。下一步工作准备详细分析每个程序包中的接口类功能，并结合源码和dicom文档分析其实现过程。 Dcmtk程序包简介 一、Config程序包 -config目录下的文档： --config.txt:

指出你编辑的任何.h .c .cc文件首先必须包含该目录下的头文件#include \--dirstruc.txt:

给出了dcmtk项目的项目目录结构，这个用cmake会自动生成 --envvars.txt:

这个文件比较重要，它指出了一些运行时环境变量，这些变量可能会影响dcmtk的工具和库的使用，这些变量包括：

---DCMDICTPATH:影响dcmdata

On Win32 platforms, a built-in dictionary is used by default. If the DCMDICTPATH environment variable is set, the applications will attempt to load _additional_ DICOM data dictionaries specified in the DCMDICTPATH environment variable instead. The DCMDICTPATH environment variable has the same format as the shell PATH variable in that a semicolon (\ code will attempt to load each file specified in the DCMDICTPATH environment variable.

See also: documentation in dcmdata/docs/datadict.txt ---TCP_BUFFER_LENGTH:影响dcmnet

By default, DCMTK uses a TCP send and receive buffer

length of 32K. If the environment variable TCP_BUFFER_LENGTH is set, it specified an override for the TCP buffer length. The value is specified in bytes, not in Kbytes. ---TCP_NODELAY:影响dcmnet

If this environment variable contains a non-zero number, the Nagle algorithm will not be disabled for TCP transport connections. Also see documentation for macro

DONT_DISABLE_NAGLE_ALGORITHM in config/docs/macros.txt ---TMPDIR:影响dcmnet

Affects the implementation of the tempnam() emulation on

platforms where tempnam() is not defined. See tempnam(3S) main page for a description. --macros.txt:

这个文件也特别重要，它给出了很多编译时的宏，这些宏可能会影响dcmtk的工具和库的使用。大部分的宏可以用来激活一些实验性的或很少需要的特性，另外有一些是用来取消某些功能。要尽量谨慎使用。详细见文档。 --modules.txt:

这个文件讲述如何自己配置各个模块，不需要掌握。 -config的include目录下的文件

--osconfig.h：这个文件是必须包含在所有.h .c文件中的 其中指出在win32环境下包含\文件

--cfwin32.h:包含了大量的宏定义。***如果需要查找某个宏的定义，可到这个文件中查找*** 二、ofstd程序包

-ofstd:作为一般目的的类库。

这个模块包含了一般目的的类库，这些类所描述的对象概念并非在Dicom标准中特有。它们广泛的在toolkit中使用。主要包含下面的类

--OFCommandLine：处理命令行参数，头文件在ofcmdln.h。***详情需要结合具体的代码来理解*** --OFCondition：描述条件码的一般类。头文件在ofcond.h。***详情需要结合具体的代码来理解***

--OFConsole:是一个singleton(孤立)类***不明白***。提供线程安全的对标准输出流和错误流的访问。允许以多线程的方式同时创建输出。***多线程的东西不太明白，它的作用应该是在多线程中实现指定线程的输出流进行输出操作***

--OFList:是一个双向链表模板类，接口是STL list类中的一个子集。头文件在oflist.h。***不明白为什么不直接用标准库中的list，兼容性应该更好啊***

--OFStack：是一个堆栈模板类，接口是STL stack类中的一个子集。头文件在ofstack.h。***不明白为什么不直接用标准库中的stack，兼容性应该更好啊***

--OFStandard：包含大量帮助函数组成的类，用来包含大量“全局”帮助函数。注意全部都是静态函数。其中的一些函数实现调用了windows API函数，如fileexists()。头文件在ofstd.h。***如果需要一些全局函数，可以到这里了找一找。***

--OFString:一个简单的string类，实现了std::string的一个子集，没有iterator或trait，在速度上也没有优化。头文件在ofstring.h。***不明白为什么不直接用标准库中的string，兼容性应该更好啊*** --除了上述的主要类以外，还包含了大量辅助类，用来支撑上述类的功能。***详情需要结合具体的代码来理解***

三、dcmdata程序包

-dcmdata:一个数据编码/解码库和可用的工具

这个模块包含了一些类来管理Dicom数据结构和文件。同时它也提供了对DICOMDIR文件的支持以满足Dicom storage media（存储介质）的需要。 ---------------------------------------------------- 主要的接口类有：

--DcmFileFormat：a class handling the DICOM file format (with meta header) 。头文件在dcfilefo.h。***详情在单独的文档中分析***

--DcmDataset：a class handling the DICOM dataset format (files without meta header) 。头文件在dcdatset.h。***详情在单独的文档中分析***

--DcmItem：a class representing a collection of DICOM elements。头文件在dcitem.h。***详情在单独的文档中分析***

--DcmElement：abstract base class for all DICOM elements。头文件在dcelem.h。***详情在单独的文档中分析***。它的派生类包括：

DcmAttributeTag\\DcmByteString\\DcmFloatingPointDouble\\DcmFloatingPointSingle\\DcmOtherByteOtherWord\\DcmSequenceOfItems\\DcmSignedLong\\DcmSignedShort\\DcmUnsignedLong\\DcmUnsignedShort

---------------------------------------------------- ---------------------------------------------------- 工具：这个模块包含了下面的命令行工具： dcm2xml: Convert DICOM file and data set to XML dcmconv: Convert DICOM file encoding

dcmcrle: Encode DICOM file to RLE transfer syntax dcmdrle: Decode RLE-compressed DICOM file dcmdump: Dump DICOM file and data set dcmftest: Test if file uses DICOM part 10 format dcmgpdir: Create a general purpose DICOMDIR dcmodify: Modify DICOM files

dump2dcm: Convert ASCII dump to DICOM file

xml2dcm: Convert XML document to DICOM file or data set ***暂时不对命令行工具进行详细的分析*** ---------------------------------------------------- --------------------------------------------------- 举例:

--调入一个DICOM文件，输出病人姓名 DcmFileFormat fileformat;