dcmtk程序包简介

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

Dcmtk程序包简介

一、Config程序包

-config目录下的文档：

--config.txt:

指出你编辑的任何.h .c .cc文件首先必须包含该目录下的头文件#include "osconfig.h"

--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 (";") separates entries. The data dictionary

    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环境下包含"dcmtk/config/cfwin32.h"文件

--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;

OFCondition status = fileformat.loadFile("test.dcm");

if (status.good())

{

OFString patientsName;

if (fileformat.getDataset()->findAndGetOFString(DCM_PatientsName, patientsName).good())

{

    cout << "Patient's Name: " << patientsName << endl;

} else

    cerr << "Error: cannot access Patient's Name!" << endl;

} else

cerr << "Error: cannot read DICOM file (" << status.text() << ")" << endl;

--创建一个DICOM dataset数据集，并保存为文件

char uid[100];

DcmFileFormat fileformat;

DcmDataset *dataset = fileformat.getDataset();

dataset->putAndInsertString(DCM_SOPClassUID, UID_SecondaryCaptureImageStorage);