/*****************************************************************************
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("test.dcm").good())
{
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, &params);
// 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("test_jpeg.dcm", EXS_JPEGProcess14SV1TransferSyntax);
}
}  
DJEncoderRegistration::cleanup(); // deregister JPEG codecs

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using Dicom;
using Dicom.Data;
using Dicom.Codec;
using Dicom.Codec.JpegLs;
namespace JpegLossLess
{
    class Program
    {
        static void Main(string[] args)
        {
            DicomCodec.RegisterCodecs();
            //Dicom.Codec.JpegLs.DcmJpegLsCodec.Register();
            string fName = string.Format("d:\\dcm\\test.dcm");
            DicomFileFormat ff = new DicomFileFormat();
            ff.Load(fName, DicomReadOptions.Default | DicomReadOptions.DeferLoadingPixelData);
            //ff.Load(fName, DicomReadOptions.None);
            DcmPixelData pixels = new DcmPixelData(ff.Dataset);

            DcmJpegLsParameters JpegParameters = new DcmJpegLsParameters();
            ff.FileMetaInfo.TransferSyntax = DicomTransferSyntax.JPEGProcess14SV1;
            ff.Dataset.ChangeTransferSyntax(DicomTransferSyntax.JPEGProcess14SV1, JpegParameters);
            string OutFile = string.Format(@"d:\dcm\outfile.dcm");
            ff.Save(OutFile, DicomWriteOptions.Default); 
        }
    }
}

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using Dicom;
using Dicom.Data;
using Dicom.Codec;
using Dicom.Codec.JpegLs;
namespace JpegLossLess
{
    class Program
    {
        static void Main(string[] args)
        {
            /****************************************************
            * 对比C++中DCMTK对于DICOM进行JPEG无损压缩，来学习C#
            * 中Dicom库的使用
            * 2014-08-06
            * zssure
            ****************************************************/
            DicomCodec.RegisterCodecs();
            string fName = string.Format(@"d:\dcm\test.dcm");
            DicomFileFormat ff = new DicomFileFormat();
            ff.Load(fName, DicomReadOptions.Default | DicomReadOptions.DeferLoadingPixelData);
            DcmJpegLsParameters JpegParameters = new DcmJpegLsParameters();
            ff.FileMetaInfo.TransferSyntax = DicomTransferSyntax.JPEGProcess14SV1;
            ff.Dataset.ChangeTransferSyntax(DicomTransferSyntax.JPEGProcess14SV1, JpegParameters);
            string OutFile = string.Format(@"d:\dcm\outfileJpeg22.dcm");
            ff.Save(OutFile, DicomWriteOptions.Default);
        }
    }
}

mDCM

DCMTK

1） DicomFileFormat.Load，打开文件（也是通过文件流的方式一一读取DCM文件的各个信息到内存中）

2） DicomFileFormat.Dataset.ChangeTransferSyntax，该函数与DCMTK中的chooseRepresentation函数类似，在参数中都需要指出新的传输语义，函数内部会根据新的传输语义来修改数据体的存储方式。该函数主要完成的功能是：

比较新旧传输语义、根据新旧语义决定数据体是否解压缩或压缩（Dicom.Codec.Encode或者Dicom.Codec.Decode）。

3） DicomFileFormat.Save，存储文件，但是该函数中并不需要填写新的传输语义

【注】：这一点与DCMTK中的saveFile函数不同。这也就是上个周C#版本的mDCM实现对DCM数据的JPEG无损压缩后无法顺利读取的原因。因为数据体存储格式不是按照文件元信息中指定的传输语义存储的，或者说文件元信息中的传输语义没有修改为JPEG无损压缩的方式。

4） DicomFileFormat::loadFile，导入文件，主要是DcmMetaInfo和DcmDataset两部分；

5） Dataset::chooseReresentation，参数中会出现新旧传输语义TransferSyntax，函数根据新的语义对相应数据（主要是像素数据）进行处理，会调用DcmPixelData::canChooseRepresentation、DcmPixelData::chooseRepresentation

6） Dataset::canWriteXfer，参数中是新修改后的传输语义。

7） DcmFileFormat::saveFile，参数中需要指出修改后的传输语义。——》随后会调用dcfilefo.cc文件中的validateMetaInfo函数（该函数中也需要指定新的传输语义）。——》对文件元信息的各个元素分别调用DcmMetaInfo::search和chekMetaHeaderValue两个函数（在该函数内，会检测各个元信息元素是否存在，不存在会新建之并插入，其参数中就需要指出新的传输语义）——》DcmElement::putString将新的传输协议写入到MetaInfo中。（基本调用流程如下图。