Leadtools.Dicom Assembly Changes

Leadtools.Dicom Assembly Changes from Version 17.5 to Version 18

Android and .NET WinForms support - LEADTOOLS V18 adds Android support for DICOM with the new LEADTOOLS Android SDK. In addition, .NET WinForms support has been added through the new LEADTOOLS .NET WinForms through the new LEADTOOLS .NET WinForms SDK. These toolkits provide everything a developer needs to create imaging-enabled Android applications. Support is implemented with the following components:

Packages or DLLs / Shared Object Libraries	Comments
Leadtools.Dicom.JAR / LibLeadtools.Dicom.SO	Android support for working with DICOM data sets (creating, initializing, loading and saving, etc).
Leadtools.Dicom.DLL	.NET WinForms support for working with DICOM data sets (creating, initializing, loading and saving, etc).

For more information, refer to http://www.leadtools.com/corporate/new-in-v18.htm.

Leadtools.Dicom Assembly Changes from Version 17 to Version 17.5

WinRT support - LEADTOOLS V17.5 adds WinRT support for DICOM through the new LEADTOOLS WinRT SDK. The LEADTOOLS WinRT SDK contains everything a developer needs to create imaging-enabled Windows Store applications. It is available as an add-on to any of the Document or Medical products. Support is implemented with the following components:

Assembly	Metadata	Comments
Leadtools.Dicom.dll	Leadtools.Dicom.winmd	Provides basic support for DICOM: dealing with data sets.
Leadtools.Dicom.dll - Leadtools.Dicom.DicomNet	Leadtools.Dicom.Networking.winmd	Along with the Leadtools.Dicom.DicomPrintScu namespace, provides the main functionality for dealing with DICOM Network connections.
Leadtools.Dicom.dll - Leadtools.Dicom.DicomPrintScu	Leadtools.Dicom.winmd	Implements a Print Management Service Class User (SCU).
Leadtools.Dicom.dll - Leadtools.Dicom.DicomDataSet	Leadtools.Dicom.winmd	Provides the main functionality inserting and extracting DICOM annotations.
Leadtools.Dicom.dll - Leadtools.Dicom.DicomNet	Leadtools.Dicom.winmd	Provides support for the Secure Transport Connection Profiles as specified in part 15 of the DICOM 3 standard

DICOM Standard - Leadtools.Dicom has been updated to provide support for the latest DICOM Standard, including:

All IODs (classes), DICOM Groups and DICOM Elements in the latest DICOM (2011) specification and Final Text Supplements additional to the 2011 DICOM Base Standard.
Full support for Final Text DICOM Supplement 152 - Ophthalmic Thickness Map Storage SOP Class.

New Members

The following members have been added to existing types in v17.5:

Member	Description
Leadtools.Dicom.DicomAnnotationPoint.DicomAnnotationPoint(Double,Double)	Initializes a new instance of the DicomAnnotationPoint structure using the specified coordinates.
Leadtools.Dicom.DicomDataSet.GetImages(Leadtools.Dicom.DicomElement,System.Int32,System.Int32,System.Int32,Leadtools.RasterByteOrder,Leadtools.Dicom.DicomGetImageFlags,Leadtools.Dicom.DicomGetImageCallback)	Gets the images of a Pixel Data element.
Leadtools.Dicom.DicomGetImageCallback	Called for each image that is loaded using GetImages(DicomElement element, int index, int count, int bitsPerPixel, RasterByteOrder order, DicomGetImageFlags flags, DicomGetImageCallback callback).
Leadtools.Dicom.DicomNet.ServerClose	Closes a client DicomNet in a multi-threaded environment.
Leadtools.Dicom.DicomClassType.Unknown	Unknown Class Information Object Definition
Leadtools.Dicom.DicomGetImageFlags.AutoDetectInvalidRleCompression	Only used with RLE compressed image data. Automatically detects if the MSB and LSB segments of RLE compressed image data are written in the incorrect order.
Leadtools.Dicom.DicomExceptionCode.ElementAlreadyExists	The DICOM Element already exists.
Leadtools.Dicom.DicomExceptionCode.TransferSyntaxNotSupported	DICOM Transfer Syntax is not supported
Leadtools.Dicom.DicomUidType.Mpeg4AvcH264HighProfileLevel4_1	MPEG-4 AVC/H.264 High Profile / Level 4.1 of the ITU-T H.264 Video standard
Leadtools.Dicom.DicomUidType.Mpeg4AvcH264BdCompatibleHighProfileLevel_4_1	MPEG-4 AVC/H.264 BD-compatible High Profile / Level 4.1 of the ITU-T H.264 Video standard
Leadtools.Dicom.DicomTagTable.Default(System.Boolean)	Resets the Data Element Tag Table to the default values.
Leadtools.Dicom.DicomTagTable.LoadXml(System.String)	Loads the Element Tags contained in file into the internal DICOM Element Tag Table.
Leadtools.Dicom.DicomIodTable.LoadXml(System.String)	Loads the IODs and modules contained in file into the internal DICOM IOD Table.
Leadtools.Dicom.DicomContextGroupTable.LoadXml(System.String)	Loads the context groups contained in file into the internal DICOM context group table
Leadtools.Dicom.DicomUidTable.LoadXml(System.String)	Loads the UIDs contained in file into the internal DICOM UID Table.
Leadtools.Dicom.DicomUIDCategory.FrameOfReference	Frame of Reference
Leadtools.Dicom.DicomUIDCategory.LdapOid	Directory Server (LDAP) Object Identifier (OID)
Leadtools.Dicom.DicomDataSet.GetImages(DicomElement,Int32,Int32,Int32,RasterByteOrder,DicomGetImageFlags,DicomGetImageCallback)	Gets the images of a Pixel Data element. New overload method includes a callback.

New Enumeration Members

The following enumeration members have been added to existing enumerations in v17.5:

Enumeration	Description
Leadtools.Dicom.DicomUIDCategory.FrameOfReference	Frame of Reference
Leadtools.Dicom.DicomUIDCategory.LdapOid	Directory Server (LDAP) Object Identifier (OID)
Leadtools.Dicom.DicomExceptionCode.JlsFilterMissing	Leadtools.Codecs.Jls.dll is missing
Leadtools.Dicom.DicomExceptionCode.XmlInvalidFormat	LeadDicomTables XML file contains invalid XML
Leadtools.Dicom.DicomExceptionCode.XmlModuleListMissing	LeadDicomTables XML file missing the moduleList section
Leadtools.Dicom.DicomExceptionCode.XmlInvalidIodList	LeadDicomTables XML iodList section is invalid
Leadtools.Dicom.DicomExceptionCode.XmlInvalidIodModuleItem	LeadDicomTables XML file IOD entry contains an invalid module
Leadtools.Dicom.DicomExceptionCode.XmlModuleNotFound	LeadDicomTables XML file IOD entry references an module that is not defined in the moduleList
Leadtools.Dicom.DicomExceptionCode.XmlInvalidModuleElement	LeadDicomTables XML file moduleList contains an invalid element
Leadtools.Dicom.DicomExceptionCode.XmlInvalidModuleList	LeadDicomTables XML moduleList section is invalid
Leadtools.Dicom.DicomExceptionCode.XmlInvalidModulelistModuleAttribute	LeadDicomTables XML moduleList <Module> contains an invalid attribute
Leadtools.Dicom.DicomExceptionCode.XmlInvalidIodListModuleAttribute	LeadDicomTables XML iodList contains an invalid module
Leadtools.Dicom.DicomExceptionCode.XmlInvalidIodListIodAttribute	LeadDicomTables XML iodList contains an invalid attribute
Leadtools.Dicom.DicomExceptionCode.XmlInvalidElementList	LeadDicomTables XML elementList is invalid
Leadtools.Dicom.DicomExceptionCode.XmlInvalidElementListItemAttribute	LeadDicomTables XML elementList contains an invalid attribute
Leadtools.Dicom.DicomExceptionCode.XmlInvalidUidListItemAttribute	LeadDicomTables XML uidList contains an invalid attribute
Leadtools.Dicom.DicomExceptionCode.XmlInvalidConceptGroupList	LeadDicomTables XML contextgroup section is invalid
Leadtools.Dicom.DicomExceptionCode.XmlInvalidContextGroupAttribute	LeadDicomTables XML contextgroup section contains an invalid group attribute
Leadtools.Dicom.DicomExceptionCode.XmlInvalidCodedConceptAttribute	LeadDicomTables XML contextgroup section contains an invalid coded concept attribute
Leadtools.Dicom.ChangeTransferSyntaxFlags.RescaleModalityLutWhenLossyCompressed	If set, and the new transfer syntax uses JPEG lossy compression, any modality LUT present will be rescaled to account for changes in minimum and maximum grayscale values due to lossy compression.
Leadtools.Dicom.ChangeTransferSyntaxFlags.YbrFull	This flag is valid only for color images, and for the following transfer syntaxes: ImplicitVRLittleEndian ExplicitVRLittleEndian ExplicitVRBigEndian RLELossless It is ignored for all other transfer syntax values. If set, this converts the RGB image data to YCbCr, which is one luminance (Y) and two chrominance planes (CB and CR).

Leadtools.Dicom Assembly Changes from Version 16.5 to Version 17

Note on LEADTOOLS for .NET v17

In LEADTOOLS for .NET v16.5, some assemblies had a dependency on System.Drawing. System.Drawing is the .NET 2.0 assembly used with the Windows Forms and GDI+ platforms. Since LEADTOOLS v17 treats Windows Forms, Windows Presentation Foundation (WPF) and Silverlight as equal citizens, certain types in this LEADTOOLS assembly has been changed to reflect that. For example, properties with System.Drawing.Point type have been changed to use the new Leadtools.LeadPoint type, methods with a parameter of System.Drawing.Rectangle type have been changed to use the new Leadtools.LeadRect type. The following table shows the old 16.5 and corresponding new v17 types:

Old v16.5 Type	New v17 Type
System.Drawing.Point	Leadtools.LeadPoint
System.Drawing.Size	Leadtools.LeadSize
System.Drawing.Rectangle	Leadtools.LeadRect
System.Drawing.Color	Leadtools.RasterColor
System.Drawing.Drawing2.FillMode	Leadtools.LeadFillMode

New Types

The following Types have been added in v17:

Type	Description
DicomNetIpTypeFlags	Specifies which Internet Protocol Version will be supported with DICOM Communication.

New Members

The following members have been added to existing types in v17:

Member	Description
DicomDataSet.Load(Stream stream, DicomDataSetLoadFlags flags)	Loads a Data Set from a stream.
DicomDataSet.Save(Stream stream, DicomDataSetSaveFlags flags)	Saves the Data Set to a stream.
DicomDataSet.GetEncapsulatedDocument(DicomElement element, bool child, Stream stream, DicomEncapsulatedDocument encapsulatedDocument, DicomCodeSequenceItem conceptNameCodeSequence)	Retrieves an encapsulated document and corresponding DICOM elements from a DICOM data set and output the stream in a stream.
DicomDataSet.SetEncapsulatedDocument(DicomElement element, bool child, Stream stream, DicomEncapsulatedDocument encapsulatedDocument, DicomCodeSequenceItem conceptNameCodeSequence)	Inserts an encapsulated document in a stream and corresponding DICOM elements into a DICOM data set.
DicomDataSet.AddPresentationStateImageReference(Stream stream, int[] frameNumbers, int framesCount)	Adds a new item to the "Referenced Image Sequence" under the "Presentation State Module" from a stream
DicomDataSet.SetFloatValue(DicomElement element, float value)	Sets the float value of a Data Element.
DicomDataSet.SetDateValue(DicomElement element, DicomDateValue value)	Sets the Date value of a Data Element.
DicomDataSet.GetPreamble(out Byte[] preamble, int offset, int length)	Replaces void DicomDataSet.GetPreamble(byte[] preamble, int offset, int length)
DicomTag.ToHexString	Returns a hexadecimal representation of the DicomTag.
DicomIodTable.GetModuleCount	Returns the number of modules in the specified IOD class.
GetDoubleValueExt(Leadtools.Dicom.DicomElement,System.Int32,System.Int32)	Returns an array of numeric values, stored in the Value Field, of the specified element.
SetLongValue(Leadtools.Dicom.DicomElement,System.Int64[],System.Int32)	Sets the integer value or short value of a Data Element.>
SetDoubleValueExt(Leadtools.Dicom.DicomElement,System.Double[],System.Int32)	Sets the double value, or any other numeric value representation of a Data Element.
Connect(System.String,System.Int32,System.String,System.Int32,Leadtools.Dicom.DicomNetIpTypeFlags)	Connects an SCU to an SCP.
Listen(System.String,System.Int32,System.Int32,Leadtools.Dicom.DicomNetIpTypeFlags)	Establishes a connection to listen for incoming connection requests.
DicomExceptionCode.IncompatibleListOfImages	The list of images in the dataset must all have the same width, height, and bits per pixel.
DicomExceptionCode.Ipv4Ipv6Conflict	Both IPv4 and IPv6 addresses have been passed to the same method.

Removed Members

The following members have been removed from existing types in v17:

Member	Description
DicomModuleType.PaletteColorLoockupTable	Item was misspelled

These changes are not listed in the topics below.

Leadtools.Dicom Assembly Changes from Version 16 to Version 16.5

Leadtools.Dicom has been updated to provide support for the latest DICOM Standard, including:

All IODs (classes) in the latest DICOM specification 2008 and Final Text Supplements additional to 2008 Base Standard
Full support for Final Text DICOM Supplement 137 - MPEG2 MP@HL Transfer Syntax

New Classes

The following classes have been added to LEADTOOLS for .NET v16.5

Class	Description
Leadtools.Dicom.DicomUidType	DICOM UID Values (Transfer Syntax and Abstract Syntax Values).
Leadtools.Dicom.DicomTag	The DicomTag structure contains information about supported tags.

New Members

The following members have been added to existing types

Member	Description
Leadtools.Dicom.DicomDataSet.Copy	Copies the data elements from one Data Set to another.
Leadtools.Dicom.DicomAssociate.FindNextAbstract	Find the next Presentation Context that contains the specified Abstract Syntax.
Leadtools.Dicom.DicomAssociate.FindAbstract	Finds the Presentation Context with the specified Abstract Syntax.
Leadtools.Dicom.DicomAssociate.ToString	This member overrides ToString and returns a descriptive string for the DicomAssociate.

New Enumerations

The following enumerations have been added to LEADTOOLS for .NET v16.5

Enumeration	Description
Leadtools.Dicom.DicomCopyFlags	Flags that give additional information associated with the Leadtools.Dicom.DicomElement.
Leadtools.Dicom.DicomClassType	Represents the constants that are used to indicate the Class Information Object Definitions.
Leadtools.Dicom.DicomModuleType	Represents the constants that are used to indicate the Module Information Object Definitions.
Leadtools.Dicom.DicomExceptionCode	Represents the possible return values for LEADTOOLS DICOM methods.

New Structures

The following structures have been added to LEADTOOLS for .NET v16.5

Structure	Description
Leadtools.Dicom.DicomDateValue	Specifies the information about date values stored in the Value Field of a Data Element.

New Delegates

The following delegates have been added to LEADTOOLS for .NET v16.5

Delegate	Description
Leadtools.Dicom.DicomCopyCallback	Called for each Data Element of the Data Set.

Leadtools.Dicom Assembly Changes from Version 15 to Version 16

Leadtools.Dicom has been updated to provide support for the latest DICOM Standard, including:

All IODs (classes) in the latest DICOM specification 2008
Multi-frame Functional Groups
All modules through 2008
Capability to add mandatory modules, or mandatory elements when creating a new DICOM data set
Creating or working with DICOM Encapsulated documents
Private tags
- Getting/setting raw data
- Getting/setting PDF data
Reading or writing DICOM datasets with 1-bit image data
When creating a DICOMDIR with icon image or image preview for multi-frame DICOM, the Representative Frame Number (0028, 6010) tag can be used for the image frame.

Over 30 functions have been added to the .NET DICOM toolkit to allow users a simpler, more straightforward, .NET-like way of working with DICOM data sets and DICOM sequences.

DICOM IOD tables and context mapping tables are now loaded on demand instead of at startup. The tables can optionally be not loaded at all, or loaded partially.

DICOM Communications support has been enhanced by new functions to customize socket creation options.

Both ANSI and UNICODE DICOM DLLs are now provided.

Two new demos have been added, one for DICOM MWL and another for DICOM Waveforms.

In addition, the medical viewer control has been enhanced.

New Members

The following members have been added in version 16:

Member	Description
CreatePrivateCreatorDataElement	Creates a Private Creator Data Element.
GetNextUnusedPrivateTag	Returns the next available unused tag reserved by the Private Creator Data Element.
FindFirstPrivateCreatorDataElement	Returns the Private Creator Data Element that matches the search constraints.
FindNextPrivateCreatorDataElement	Returns the next Private Creator Data Element that matches the search constraints.
FindFirstPrivateElement	Returns the first existing private element that is reserved by privateCreatorDataElement.
FindNextPrivateElement	Returns the next existing private element that is reserved by privateCreatorDataElement.
GetEncapsulatedDocument	Retrieves an encapsulated document and corresponding DICOM elements from a DICOM data set.
SetEncapsulatedDocument	Inserts an encapsulated document and corresponding DICOM elements into a DICOM data set.
Initialize(DicomClassType,DicomDataSetInitializeFlags)	Creates the Data Set object, inserting the appropriate elements for the specified class.
SetDateValue(DicomElement,DateTime[])	Sets the Date value(s) of a Data Element.
SetTimeValue(DicomElement,DateTime[])	Sets the Time value(s) of a Data Element.
SetDateTimeValue(DicomElement,DateTime[])	Sets the Date-Time value(s) of a Data Element.
GetImage	Gets the image of a Pixel Data element.
GetModalityLutAttributes(Int32)	New version of GetModalityLut, supporting multi-frames, that retrieves the attributes that describe the Modality LUT.
SetModalityLut(Int32,DicomModalityLutAttributes,Int32[],DicomSetImageFlags)	New version of SetModalityLut, supporting multi-frames, that sets the attributes that describe the Modality LUT.
DeleteModalityLut(Int32,DicomSetImageFlags)	New version of DeleteModalityLut supporting multi-frames that deletes all the elements that describe the Modality LUT.
GetWindow(Int32,Int32)	New version of GetWindow that supports multi-frames.
SetWindow(Int32,Int32,DicomWindowAttributes,DicomSetImageFlags)	New version of SetWindow that supports multi-frames.
DeleteWindow(Int32,DicomSetImageFlags)	New version of DeleteWindow that supports multi-frames.
TestConformanace	Verifies the conformance of the Data Set.
DicomTestConformanceCallback	Processes each Data Element of the Data Set to determine conformance.
SetValue	Sets the value(s) of a Data Element.
InsertElementAndSetValue	Overloaded. Finds or inserts (if not found) an element in the data set and sets the value of the element.
GetValue	Overloaded. Returns the value of a DICOM element.
GetValueResult	Finalizes the changes when creating or editing a DICOM sequence.
BeginEditItem	Overloaded. Edits an existing item, or creates a new item in a DICOM sequence.
EndEditItem	Finalizes the changes when creating or editing an item in a DICOM sequence.
BeginReadSequence	Overloaded. Reads values from an existing DICOM sequence.
EndReadSequence	Finalizes the read when reading a DICOM sequence.
BeginReadItem	Overloaded. Reads an existing item from a DICOM sequence.
EndReadItem	Finalizes the read when reading an item from a DICOM sequence.

Renamed Members

The following members have been renamed in version 16:

Version 15	Version 16
DicomTagType enumeration	The different values have been added as fields to the Dicom.DicomTag class.

New Enumeration Values

The following enumerations are new or have had values added to them in version 16:

Enumeration	Description
DicomDataSetInitializeFlags	Specifies the Value Representation, byte order, and other options used when initializing a Data Set.
DicomDirKeyType	Specifies different types of key elements, like spectroscopy, raw data, fiducial, encapsulated document, etc.
DicomInsertElementAndSetValueResult	New enumeration that specifies the possible result of DicomDatSet.InsertElementAndSetValue
DicomGetValueResult	New enumeration that specifies the possible result of GetValue
DicomTestConformanceFlags	New enumeration that indicates errors associated with the DicomElement.