LDicomDS::SaveDS

Summary

Saves the Data Set to the specified file.

Syntax

L_UINT16 LDicomDS::SaveDS(pFile, nFlags)

Parameters

L_TCHAR * pszName

Character string that contains the name of the file.

L_UINT16 nFlags

Meta-header flags, Transfer Syntax flags and other flags that indicate file characteristics to use when saving the file. Possible values for Meta-header flags are.

Possible values and combinations for the Transfer Syntax flags are:

The following Transfer Syntax flag combinations can be used only with uncompressed images:

The following Transfer Syntax flag combination can be used with compressed or uncompressed images:

Possible values and combinations for other flags are:

Any of the available Meta-header flags options above may be combined with any of the available options for the Transfer Syntax flags and other flags given above, based on whether the images are compressed or uncompressed. For example, you may combine DS_METAHEADER_ABSENT with DS_LITTLE_ENDIAN | DS_IMPLICIT_VR and DS_GROUP_LENGTHS | DS_LENGTH_EXPLICIT when using uncompressed images, or you may combine DS_METAHEADER_PRESENT with DS_LITTLE_ENDIAN | DS_EXPLICIT_VR and DS_GROUP_LENGTHS | DS_LENGTH_EXPLICIT when using compressed images.

Returns

Comments

If the Data Set was loaded from a file, the file characteristics were included from the file. If you wish to use these same characteristics, save the Data Set with nFlags set to 0.

If you wish to specify the file characteristics for saving the file, set the characteristics using the possible values listed above for nFlags.

Required DLLs and Libraries

• LTDIC
• For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application

Platforms

Win32, x64

See Also

Functions

• LDicomDS::LoadDSMemory
• LDicomDS::LoadDS

Topics

• Working with Data Sets
• How to Disable the Automatic Loading of the default DICOM IOD Table

Example

This example initializes the Data Set and save it in a file.

L_INT LDicomDS_SaveDSExample() 
 
{ 
   L_INT       nRet; 
   LDicomDS*   pDS; 
 
   pDS = new LDicomDS(NULL); 
 
   pDS->InitDS( CLASS_CT_IMAGE_STORAGE, 0);  
 
   nRet = pDS->SaveDS(MAKE_IMAGE_PATH(TEXT("temp.dcm")), 0); 
   if(nRet != DICOM_SUCCESS) 
      return nRet; 
 
   delete pDS; 
 
   return DICOM_SUCCESS; 
}