LDicomDS::ChangeTransferSyntax

#include "Ltdic.h"

L_UINT16 LDicomDS::ChangeTransferSyntax(pszUID, nQFactor, uFlags);

L_UINT16 LDicomDS::ChangeTransferSyntax(pszOutfile, pszUID, nQFactor, uTransferSyntaxFlags, uSaveFlags);

Changes the transfer syntax of the data set.

Returns

Comments

This function will convert the data set's transfer syntax to the transfer syntax specified in pszUID, maintaining all elements and values in the data set.

After this function is called all previous references to data elements in the data set will no longer be valid.

This function is especially useful when sending a C_STORE_REQ message using the LDicomNet::SendCStoreRequest function. The user can match the data set transfer syntax with the transfer syntax of the SCP.

If this function returns the error DICOM_ERROR_WRITE, one of the causes could be that your system is missing the LEADTOOLS file filter LFCMPU.DLL. Specifically, this error will be returned if either the original transfer syntax or the new transfer syntax is one of the following:

• UID_JPEG_BASELINE_1
• UID_JPEG_EXTENDED_2_4
• UID_JPEG_LOSSLESS_NONHIER_14
• UID_JPEG_LOSSLESS_NONHIER_14B

The overload that takes the pszOutFile parameter saves a dataset with the new transfer syntax at the location pszOutFile with save options specified by uSaveFlags. This overload should be used when trying to produce a file with the new transfer syntax (instead of the first overload followed by a call to LDicomDS::SaveDS) because it will be significantly faster and use fewer resources (memory and disk), especially for large files.

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

Note: This function 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.

Required DLLs and Libraries

Platforms

Win32, x64

#define MAKE_IMAGE_PATH(pFileName) TEXT("C:\\Users\\Public\\Documents\\LEADTOOLS Images\\")pFileName 
L_INT LDicomDS_ChangeTransferSyntaxExample() 
{ 
   L_INT       nRet; 
   LDicomDS*   pDS; 
   pDS = new LDicomDS(NULL); 
   // ******************************************************** 
   // Example 1 - change transfer syntax and save in two steps 
   // ******************************************************** 
   nRet = pDS->LoadDS(MAKE_IMAGE_PATH(TEXT("image1.dcm")), 0); 
   if(nRet != DICOM_SUCCESS) 
      return nRet; 
   // Change transfer syntax to explicit VR Big Endian 
   nRet = pDS->ChangeTransferSyntax(UID_EXPLICIT_VR_BIG_ENDIAN,0,0); 
   if(nRet != DICOM_SUCCESS) 
      return nRet; 
   // Save the new dataset 
   nRet = pDS->SaveDS(MAKE_IMAGE_PATH(TEXT("temp.dcm")), 0); 
   if(nRet != DICOM_SUCCESS) 
      return nRet; 
   // ******************************************************** 
   // Example 2 -- change transfer syntax and save in one step 
   // ******************************************************** 
   nRet = pDS->LoadDS(MAKE_IMAGE_PATH(TEXT("image1.dcm")), 0); 
   if(nRet != DICOM_SUCCESS) 
      return nRet; 
   // Change transfer syntax to explicit VR Big Endian 
   nRet = pDS->ChangeTransferSyntax(MAKE_IMAGE_PATH(TEXT("temp2.dcm")), UID_EXPLICIT_VR_BIG_ENDIAN,0,0,0); 
   if(nRet != DICOM_SUCCESS) 
      return nRet; 
   delete pDS; 
   return DICOM_SUCCESS; 
}