Leadtools.Dicom Assembly Changes

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:

Member	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.

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.

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 the possible return values for LEADTOOLS Dicom methods.

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 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.

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.

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.

GetValueDelegate Holds the result after a call to Generic DicomDataSet.GetValue(DicomElement,Boolean,Int64,,GetValueDelegate)

GetValueResult Holds the result after a call to Generic DicomDataSet.GetValue(DicomElement,Boolean,Int64,,GetValueDelegate)

BeginEditSequence Overloaded. Creates a new DICOM sequence, or edits and existing one.

EndEditSequence 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.

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.
GetValueDelegate	Holds the result after a call to Generic DicomDataSet.GetValue(DicomElement,Boolean,Int64,,GetValueDelegate)
GetValueResult	Holds the result after a call to Generic DicomDataSet.GetValue(DicomElement,Boolean,Int64,,GetValueDelegate)
BeginEditSequence	Overloaded. Creates a new DICOM sequence, or edits and existing one.
EndEditSequence	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.

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.

LEADTOOLS Medical	Send comments on this topic. \| Back to Introduction - All Topics \| Help Version 17.0.3.22
Leadtools.Dicom Assembly Changes

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.