/* ... */
DicomImage *image = new DicomImage(\if (image != NULL) {
if (image->getStatus() == EIS_Normal) {
Uint8 *pixelData = (Uint8 *)(image->getOutputData(8 /* bits per sample */)); if (pixelData != NULL) {
/* do something useful with the pixel data */ } } else cerr << \cannot load DICOM image (\<< DicomImage::getString(image->getStatus()) << \
}
delete image;
六、dcmjpeg程序包
dcmjpeg提供了一个压缩/解压缩库以及可用工具。该模块包含一些类，可将DICOM图像对象在非压缩和JPEG压缩表示（传输协议）之间转换。无失真和有失真JPEG处理都被支持。这个模块实现了一族codec(编码解码器，由DcmCodec类派生而来)，可以将这些codec在codec list中注册，codec list是由dcmdata模块保存的。
主要接口类：
--DJEncoderRegistration: 一个singleton（孤立）类，为所有支持的JPEG处理注册编码器。在djencode.h中定义。
--DJDecoderRegistration: 一个singleton（孤立）类，为所有支持的JPEG处理注册解码器。在djdecode.h中定义。
--DJCodecEncoder: JPEG编码器的一个抽象codec类。This abstract class contains most of the application logic needed for a dcmdata codec object that implements a JPEG encoder using the DJEncoder interface to the underlying JPEG implementation. This class only supports compression, it neither implements decoding nor transcoding. 在djcodece.h中定义。
--DJCodecDecoder: JPEG解码器的一个抽象codec类。This abstract class contains most of the application logic needed for a dcmdata codec object that implements a JPEG decoder using the DJDecoder interface to the underlying JPEG implementation. This class only supports decompression, it neither implements encoding nor transcoding.
工具：
dcmcjpeg: Encode DICOM file to JPEG transfer syntax dcmdjpeg: Decode JPEG-compressed DICOM file
dcmj2pnm: Convert DICOM images to PGM, PPM, BMP, TIFF or JPEG dcmmkdir: Create a DICOMDIR file 举例：
--用无失真JPEG压缩一幅DICOM图像文件。
DJEncoderRegistration::registerCodecs(); // register JPEG codecs DcmFileFormat fileformat;
if (fileformat.loadFile(\
{
DcmDataset *dataset = fileformat.getDataset(); DcmItem *metaInfo = fileformat.getMetaInfo();
DJ_RPLossless params; // codec parameters, we use the defaults // this causes the lossless JPEG version of the dataset to be created
dataset->chooseRepresentation(EXS_JPEGProcess14SV1TransferSyntax, ¶ms); // check if everything went well
if (dataset->canWriteXfer(EXS_JPEGProcess14SV1TransferSyntax))
{ // force the meta-header UIDs to be re-generated when storing the file // since the UIDs in the data set may have changed
delete metaInfo->remove(DCM_MediaStorageSOPClassUID); delete metaInfo->remove(DCM_MediaStorageSOPInstanceUID); // store in lossless JPEG format
fileformat.saveFile(\}
} DJEncoderRegistration::cleanup(); // deregister JPEG codecs --解压缩一幅JPEG压缩的DICOM图像文件。
DJDecoderRegistration::registerCodecs(); // register JPEG codecs DcmFileFormat fileformat;
if (fileformat.loadFile(\{
DcmDataset *dataset = fileformat.getDataset(); // decompress data set if compressed
dataset->chooseRepresentation(EXS_LittleEndianExplicit, NULL); // check if everything went well
if (dataset->canWriteXfer(EXS_LittleEndianExplicit)) {
fileformat.saveFile(\}
} DJDecoderRegistration::cleanup(); // deregister JPEG codecs 七、dcmnet程序包
dcmnet是一个网络库及可用工具。该模块包含了实现DICOM网络通信的所有函数集，即：DICOM上层有限状态机(DICOM Upper Layer Finite State Machine)，关联控制服务元素（Association Control Service Element, ACSE）以及DICOM消息服务元素（DICOM Message Service Element, DIMSE）。
主要接口：该模块的主要接口包括在文件assoc.h和dimse.h中定义的大量结构和函数。 --assoc.h: 这个文件包含程序，为DICOM应用提供关联管理。它维护描述活动关联的结构，提供对关联特定信息的访问。也提供程序帮助关联协议association negotiation(presentation contexts, abstract syntaxes, transfer syntaxes, maximum PDU length, and other extended negotiation)。该包使用了DICOM上层机制接收/发送关联请求/响应。每一个活动的关联由T_ASC_Association结构表示，包含了所有相关的信息。模块前缀ASC_。
--dimse.h: 这个文件包含程序，为DICOM应用提供dimse层的服务。 工具：
--echoscu: DICOM verification (C-ECHO) SCU
--findscu: DICOM query (C-FIND) SCU
--movescu: DICOM retrieve (C-MOVE) SCU --storescp: DICOM storage (C-STORE) SCP --storescu: DICOM storage (C-STORE) SCU --termscu: DICOM termination SCU 举例：
--一个简单的Echo SCU(Verification Service Class SCU)。大多数错误处理代码省去了，在Win32上的特定代码如WinSock初始化也省去了。
T_ASC_Network *net; // network struct, contains DICOM upper layer FSM etc. ASC_initializeNetwork(NET_REQUESTOR, 0, 1000 /* timeout */, &net); T_ASC_Parameters *params; // parameters of association request
ASC_createAssociationParameters(¶ms, ASC_DEFAULTMAXPDU); // set calling and called AE titles
ASC_setAPTitles(params, \
// the DICOM server accepts connections at server.nowhere.com port 104
ASC_setPresentationAddresses(params, \// list of transfer syntaxes, only a single entry here
const char* ts[] = { UID_LittleEndianImplicitTransferSyntax }; // add presentation context to association request
ASC_addPresentationContext(params, 1, UID_VerificationSOPClass, ts, 1); // request DICOM association T_ASC_Association *assoc;
if (ASC_requestAssociation(net, params, &assoc).good()) {
if (ASC_countAcceptedPresentationContexts(params) == 1)
{ // the remote SCP has accepted the Verification Service Class DIC_US // generate next message ID
DIC_US status; // DIMSE status of C-ECHO-RSP will be stored here DcmDataset *sd = NULL; // status detail will be stored here // send C-ECHO-RQ and handle response
DIMSE_echoUser(assoc, id, DIMSE_BLOCKING, 0, &status, &sd); delete sd; // we don't care about status detail } }
ASC_releaseAssociation(assoc); // release association
ASC_destroyAssociation(&assoc); // delete assoc structure ASC_dropNetwork(&net); // delete net structure 八、dcmpstat程序包
dcmpstat: 一个描述状态(presentation state)库和可用工具。This module contains classes that implement a high-level API for the DICOM Softcopy Grayscale Presentation State Storage SOP Class. It also contains various support classes that are used by DICOMscope, a free DICOM viewer that has been developed as a demonstrator for presentation states. See http://dicom.offis.de/dscope。
主要接口：
--DVPresentationState: 一个灰度软拷贝描述状态。这个类管理着一个描述状态对象的数据结构。描述状态可以创建、读、写和更改。在dvpstat.h中定义。
--DVInterface: 这个接口类是用来帮助软拷贝描述状态浏览器工作的。这个类管理着数据库机制，允许开始和停止网络交互，并访问图像和描述状态。在dviface.h中定义。
--DVPSStoredPrint: the representation of a Stored Print object。在文件dvpssp.h中定义。 工具：
dcmmkcrv: Add 2D curve data to image dcmmklut: Create DICOM look-up tables
dcmp2pgm: Read DICOM image and presentation state and render bitmap dcmprscp: DICOM basic grayscale print management SCP dcmprscu: Print spooler for presentation state viewer dcmpschk: Checking tool for presentation states
dcmpsmk: Create DICOM grayscale softcopy presentation state
dcmpsprt: Read DICOM images and presentation states and render print job dcmpsrcv: Network receive for presentation state viewer dcmpssnd: Network send for presentation state viewer 举例：
--给一幅DICOM图像创建一个缺省的描述状态 DcmFileFormat infile; DcmFileFormat outfile;
if (infile.loadFile(\{
DVPresentationState pstate; // presentation state handler if (pstate.createFromImage(*infile.getDataset()).good()) {
// serialize presentation state into DICOM data set structure if (pstate.write(*outfile.getDataset(), OFFalse).good()) {
// and write to file
outfile.saveFile(\ } } }
--应用一个描述状态中的灰度变换管道给一幅DICOM图像 DcmFileFormat imagefile; DcmFileFormat gspsfile;
if (imagefile.loadFile(\ gspsfile.loadFile(\{
DVPresentationState pstate; // presentation state handler
if (pstate.read(*gspsfile.getDataset()).good()) // parse gsps object {
// attach presentation state to image data
if (pstate.attachImage(&imagefile, OFFalse).good())