dcmimage: adds support for color images to dcmimgle

This module contains classes to access and render DICOM color images. Support for monochrome images is provided by the module dcmimgle. Support for JPEG compressed images is provide by the module dcmjpeg.

The main interface class is:

• DicomImage (from module dcmimgle)

Tools

This module contains the following command line tools:

• dcm2pnm: Convert DICOM images to PGM/PPM, PNG, TIFF or BMP
• dcmquant: Convert DICOM color images to palette color
• dcmscale: Scale DICOM images

Examples

The following example shows how to load a DICOM single-frame image (monochrome or color) and render its pixel data:

#include "dcmtk/dcmimage/diregist.h"   /* required to support color images */
/* ... */
DicomImage *image = new DicomImage("test.dcm");
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 << "Error: cannot load DICOM image (" << DicomImage::getString(image->getStatus()) << ")" << endl;
}
delete image;