ChangeTransferSyntax(string,int,ChangeTransferSyntaxFlags) Method

Summary

Changes the Transfer Syntax of the Data Set.

Syntax

C++

Java

public void ChangeTransferSyntax( 
   string uid, 
   int qualityFactor, 
   ChangeTransferSyntaxFlags flags 
)

Public Overloads Sub ChangeTransferSyntax( _ 
   ByVal uid As String, _ 
   ByVal qualityFactor As Integer, _ 
   ByVal flags As ChangeTransferSyntaxFlags _ 
)

public void changeTransferSyntax(String uid, int qualityFactor, int changeTransferSyntaxFlags)

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.

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

JPEGBaseline1
JPEGExtended2_4
JPEGLosslessNonhier14
JPEGLosslessNonhier14B

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 Note: This method cannot be used to encode DICOM transfer syntaxes (e.g. video compression support) that are not part of the main medical SDK and it is supported only via the LEADTOOLS Medical Multimedia Module.

Example

For an example, refer to Jpeg2000Options.

Requirements

Target Platforms