LEADTOOLS Medical (Leadtools.Dicom assembly) Send comments on this topic. | Back to Introduction - All Topics | Help Version 17.0.3.29
ChangeTransferSyntax Method
See Also 
Leadtools.Dicom Namespace > DicomDataSet Class : ChangeTransferSyntax Method



uid
Character string that contains the UID of the new Transfer Syntax. For possible values, refer to Transfer Syntax Values.
qualityFactor
The quality factor (Q factor) is a number that determines the degree of loss in the compression process. You can set a value from 2 to 255, where 2 is the highest quality and 255 is the most compression. This parameter only applies when the new Transfer Syntax will involve compressing pixel data using a lossy compression.
flags
Indicates how the compression will be performed.
uid
Character string that contains the UID of the new Transfer Syntax. For possible values, refer to Transfer Syntax Values.
qualityFactor
The quality factor (Q factor) is a number that determines the degree of loss in the compression process. You can set a value from 2 to 255, where 2 is the highest quality and 255 is the most compression. This parameter only applies when the new Transfer Syntax will involve compressing pixel data using a lossy compression.
flags
Indicates how the compression will be performed.
Changes the Transfer Syntax of the Data Set. Supported in Silverlight, Windows Phone 7.

Syntax

Visual Basic (Declaration) 
Public Sub ChangeTransferSyntax( _
   ByVal uid As String, _
   ByVal qualityFactor As Integer, _
   ByVal flags As ChangeTransferSyntaxFlags _
) 
Visual Basic (Usage)Copy Code
Dim instance As DicomDataSet
Dim uid As String
Dim qualityFactor As Integer
Dim flags As ChangeTransferSyntaxFlags
 
instance.ChangeTransferSyntax(uid, qualityFactor, flags)
C# 
public void ChangeTransferSyntax( 
   string uid,
   int qualityFactor,
   ChangeTransferSyntaxFlags flags
)
C++/CLI 
public:
void ChangeTransferSyntax( 
   String^ uid,
   int qualityFactor,
   ChangeTransferSyntaxFlags flags
) 

Parameters

uid
Character string that contains the UID of the new Transfer Syntax. For possible values, refer to Transfer Syntax Values.
qualityFactor
The quality factor (Q factor) is a number that determines the degree of loss in the compression process. You can set a value from 2 to 255, where 2 is the highest quality and 255 is the most compression. This parameter only applies when the new Transfer Syntax will involve compressing pixel data using a lossy compression.
flags
Indicates how the compression will be performed.

Example

For an example, refer to DicomDataSet.Jpeg2000Options.

Remarks

This method will convert the Data Set's Transfer Syntax to the Transfer Syntax specified in uid, maintaining all elements and values in the Data Set.

After this method is called all previous references to data elements in the Data Set will no longer be valid.

This method is especially useful when sending a C-Store Request message using the DicomNet.SendCStoreRequest method. The user can match the Data Set Transfer Syntax with the Transfer Syntax of the SCP.

If this function throws an "Error writing to a file" exception one of the causes could be that your system is missing the LEADTOOLS file filter Leadtools.Codecs.Cmp.dll. Specifically, this error will be returned if either the original transfer syntax or the new transfer syntax is one of the following:

Make sure that the Leadtools.Codecs.Cmp.dll is in the same folder as the other LEAD DLLS. For more information see Files To Be Included With Your Application

Requirements

Target Platforms: Silverlight 3.0, Windows XP, Windows Server 2003 family, Windows Server 2008 family, Windows Vista, Windows 7, MAC OS/X (Intel Only)

See Also

Leadtools.Dicom requires a Medical toolkit server license and unlock key. For more information, refer to: Imaging Pro/Document/Medical Features