ImageGear for Java
DICOM
| ImageGear for Java User Guide > ImageGear Imaging Formats Reference > ImageGear Supported File Formats Reference > DICOM |
| Full Name | DICOM (Digital Imaging & Communication in Medicine) |
| Format ID | ImGearFormats.DICOM |
| File Extension(s) | *.dicm, *.dcm |
| Data Type | Raster or vector image |
| Data Encoding | Binary |
| IG Multipage Support | Yes |
| IG Alpha Channel Support | No |
| IG Platforms Support | WIN32, WIN64, Linux32, Linux64, MAC32, MAC64 |
 |
To support DICOM format, import the com.accusoft.imagegear.formats.dicom package along with com.accusoft.imagegear.core. |
| Filter Control Parameter | Type | Default Value | Available Values | Description |
| DetectContinuousRLE | boolean | true | false, true | Set to true for ImageGear to detect and load images where RLE runs across row boundaries. This parameter specifies what to do with RLE compressed images where RLE runs across row boundaries. If it is set to true , ImageGear tries to detect and load images where RLE runs across row boundaries. Otherwise, ImageGear truncates any row overruns and decodes each row separately. This parameter does not affect the loading of properly encoded images, where each row is encoded separately. |
| LoadConcatenateRepeatedDE | boolean | false | false, true | Set to true to concatenate repeated data elements into one data element during loading. ** |
| LoadDetectSkipDIMSE | boolean | false | false, true | Set to false if files may contain DIMSE commands - that could throw off the format detection |
| LoadSavePixdataTag | boolean | false | false, true | Set to true to allow loading and saving pixel data to/from the metadata tree rather than to/from ImageGear DIB.*** |
| LoadSyntax | ImGearDICOMTransferSyntaxes Enumeration | ImGearDICOMTransferSyntaxes.AUTODETECT | ImGearDICOMTransferSyntaxes Enumeration | Transfer Syntax to load DCM image with. |
| LoadWithoutDetection | boolean | false |
true, false |
Set to true to skip detection phase before loading a DICOM image.* |
| SaveAsPart10 | boolean | true |
true, false |
true will cause the Header to be saved |
| SaveGroupLengths | boolean | true | true, false | true =include; false =exclude |
| SavePlanarConfig | ImGearDICOMPlanarConfigurations Enumeration | ImGearDICOMPlanarConfigurations.PIXEL_BY_PIXEL | ImGearDICOMPlanarConfigurations Enumeration | Planar configuration for image saving. |
| SaveSyntax | ImGearDICOMTransferSyntaxes Enumeration | ImGearDICOMTransferSyntaxes.DEFAULT | Some ImGearDICOMTransferSyntaxes Enumeration values. **** | Transfer Syntax to save DCM image with. |
*) LoadWithoutDetection parameter effects loading of DICOM images that do not have File Meta Info (Part10) header. If false (default), the DICOM filter checks that the first several Data Elements are well formed, and if they are not, stops the reading. If true, the filter skips checking the first tags, and attempts to read the image, using the Transfer Syntax specified in the LoadSyntax parameter. LoadSyntax parameter should be set to a specific syntax, rather than AUTODETECT, PART10 or UNKNOWN. When loading the file, set the format to ImGearFormats.DICOM using the ImGearLoadOptions.setFormat method. Use this mode if you know for sure the file is a DICOM, and you know its transfer syntax.
**) Parameter LoadConcatenateRepeatedDE allows you to load incompliant DICOM images where some data elements are cut into several repeated data elements. Instead of one data element containing an array of values, the data set contains several data elements, with the same group/element numbers pair, containing portions of the array. Specifically, there are images with look up tables and palettes stored in this way. Set LoadConcatenateRepeatedDE parameter to true to concatenate repeated data elements into one data element during loading. Otherwise by default, ImageGear loads all of the repeated elements in the same way as they are located in the file. Note that ImageGear does not allow saving of repeated data elements. If a data set contains repeated data elements, ImageGear will only write the first repeated element to the file.
***) When LoadSavePixdataTag is true during image loading, ImageGear does not read pixel data into a DIB, but instead creates an empty DIB and loads pixel data into Metadata Tree, so the image will not be displayed. ImageGear represents the PixelData tag in the metadata tree as either byte array or short array, according to Value Representation of PixelData Tag (OB or OW).
In uncompressed images this array contains uncompressed pixel data. If the image has multiple pages (frames), pixel data of all frames is concatenated in this array.
In compressed images pixel data always has value representation of OB, so ImageGear represents it as a byte array. Content of this array has rich internal structure, similar to DICOM Sequence of Items. The first item is the Basic Offset Table, which is either empty, or contains offsets to image frames within the array. The rest of items contain compressed frames. At the end of the pixel data there is the sequence delimitation item. ImageGear does not expose this structure to the application. If the application needs to access individual frames, it shall parse this byte array. See DICOM PS 3.5 - 2008, Annex A.4 "TRANSFER SYNTAXES FOR ENCAPSULATION OF ENCODED PIXEL DATA" for additional details.
If LoadSavePixdataTag parameter is true during image saving, ImageGear uses pixel data from the PixelData tag of the DICOM metadata tree, instead of the ImGearPage DIB. When saving an image in this mode, make sure that saving Transfer Syntax exactly matches the Transfer Syntax of PixelData element. If it is not so, saved image will be incompatible with the standard and most probably unreadable, because transfer syntax of the pixel data will not match transfer syntax specified in file header.
****) Currently, the following values of ImGearDICOMTransferSyntaxes Enumeration values are supported:
ImGearDICOMTransferSyntaxes.DEFAULT
ImGearDICOMTransferSyntaxes.IMPLICIT_VR_LE
ImGearDICOMTransferSyntaxes.EXPLICIT_VR_LE
ImGearDICOMTransferSyntaxes.EXPLICIT_VR_BE
ImGearDICOMTransferSyntaxes.JPEG_BASELINE_PR_1
ImGearDICOMTransferSyntaxes.JPEG_EXTENDED_PR_2_4
ImGearDICOMTransferSyntaxes.JPEG_EXTENDED_PR_3_5
ImGearDICOMTransferSyntaxes.JPEG_SPECTRAL_NONH_PR_6_8
ImGearDICOMTransferSyntaxes.JPEG_SPECTRAL_NONH_PR_7_9
ImGearDICOMTransferSyntaxes.JPEG_FULL_PROG_NONH_PR_10_12
ImGearDICOMTransferSyntaxes.JPEG_FULL_PROG_NONH_PR_11_13
ImGearDICOMTransferSyntaxes.JPEG_LOSSLESS_NONH_PR_14
ImGearDICOMTransferSyntaxes.JPEG_LOSSLESS_NONH_PR_15
ImGearDICOMTransferSyntaxes.JPEG_EXTENDED_HIER_PR_16_18
ImGearDICOMTransferSyntaxes.JPEG_EXTENDED_HIER_PR_17_19
ImGearDICOMTransferSyntaxes.JPEG_SPECTRAL_HIER_PR_20_22
ImGearDICOMTransferSyntaxes.JPEG_SPECTRAL_HIER_PR_21_23
ImGearDICOMTransferSyntaxes.JPEG_FULL_PROG_HIER_PR_24_26
ImGearDICOMTransferSyntaxes.JPEG_FULL_PROG_HIER_PR_25_27
ImGearDICOMTransferSyntaxes.JPEG_LOSSLESS_HIER_PR_28
ImGearDICOMTransferSyntaxes.JPEG_LOSSLESS_HIER_PR_29
ImGearDICOMTransferSyntaxes.JPEG_LOSSLESS_NONH_FIRSTORDER_PR_14
ImGearDICOMTransferSyntaxes.JPEG_LOSSY
ImGearDICOMTransferSyntaxes.JPEG_LOSSLESS
ImGearDICOMTransferSyntaxes.JPEG_2K_LOSSLESS_ONLY
ImGearDICOMTransferSyntaxes.JPEG_2K
ImGearDICOMTransferSyntaxes.RLE
DICOM is a public standard created to provide a flexible and expandable means for storing, sharing, and transporting digital medical images. Today DICOM is the standard for medical imaging throughout the world.
DICOM image (alternately called Data Set) contains an ordered collection of attributes referred to as "Data Elements" that are related to one or more images. Each Data Element (DE) describes a single attribute of the image, patient, or study. The images themselves are also stored in DEs.
Each DICOM Data Set is transported through the Network, and consequently, stored in a file, using one of the defined Transfer Syntaxes. The Transfer Syntax of the DICOM file indicates whether the file uses Big Endian or Little Endian byte order, whether the image data is compressed or uncompressed, and if the DICOM Data Set uses Explicit or Implicit Value Representation (VR).
The Data Element (DE) is made up of the following parts:
Tag field identifies the type of information that is contained in the Value field (where the actual data is stored). The DICOM Data Dictionary (Part 6 of the specification) defines all possible public Data Element Tags that may be used. DICOM also allows applications to define and use private Tags and thus define their own Data Elements. Value Representation (VR) specifies the format of the Data Element Value, such as UL (unsigned long), ST (Short Text) or PN (Person Name). If Implicit Transfer Syntax is used, the VR field is omitted. It can be obtained from the standard or private Data Dictionary. Value Length is the length of the Data field, measured in bytes.
DICOM also allows embedding (nesting) Data Sets within Data Sets. Nested Data Sets are implemented using a "Sequence of Items" (SQ), which is a special type of Data Element.
A special group of tags at the beginning of the file allows application to recognize the file as a DICOM image file, and includes information needed to decode the file (Transfer Syntax), and serial numbers to help locate and keep track of each field. This header is referred to as "File Meta Information Header", or "Part 10 Header" (since it is defined in Part 10 of the DICOM standard). While the standard clearly states that all DICOM image files must include a Part 10 Header, in reality one finds that many do not. Instead, the average DICOM image file is a simple data stream capture of the data into a file. This is called a "Raw Data" DICOM image file. In order to read a Raw DICOM the Transfer Syntax must be guessed at using a Transfer Syntax detection algorithm.
The actual pixel data for a DICOM image is stored in a Data Element, just like any other DICOM information. Image parameters, such as dimensions, bit depth, photometric interpretation etc., are also stored in Data Elements. The Tag for Pixel Data is called "Pixel Data" and has the Tag Number 7FE0, 0010. The Data Field in this Data Element contains all pixels for the image. Depending on the image's Transfer Syntax, the Pixel Data can be compressed or uncompressed.
Digital Imaging and Communication in Medicine (DICOM). Published by: National Electrical Manufacturers Association: http://medical.nema.org/dicom.html.