AddDICOMStructure Method

Description:

Adds one of the following DICOM data structures: DataSet, FileMetaInfo or Preamble to the image, if that structure is not already present.

If the image in the IGPage Object has been loaded from a valid, Part10 compliant DICOM image, all three structures will be present. If the image has been loaded from a raw DICOM file, not containing a File Meta Information header, only the DataSet structure will be present in the IGMedPage Object. And finally, if the image has been loaded from a non-DICOM file, such as TIFF or BMP, none of the structures will be present.

If you would like to save an image to a DICOM file, you need to ensure that the DataSet structure is present in the IGMedPage Object. Otherwise, the saving function will return an error.

If you are saving a Part10 compliant file, but the IGMedPage Object does not have a FileMetaInfo or Preamble structures, they will be written to the file using default values.

Once DataSet, FileMetaInfo or Preamble has been added to IGMedPage Object (or if they were created by the toolkit when loading a DICOM image), you can access them through the corresponding properties of the IGMedPage Object.

One image can have only one instance of either of these structures. Thus, if a structure is already present in the IGMedPage Object, calling the AddDICOMStructure method with Type set to this structure type, will return an error.

Set Type to MED_STRUCTURE_TYPE_ALL to add all of the structures.

Syntax:

      AddDICOMStructure(Type As enumIGMedDICOMStructureType)

Parameters:

Name	Description
Type	Specifies the type of the structure to add to the IGMedPage Object: MED_STRUCTURE_TYPE_DATASET MED_STRUCTURE_TYPE_FILEMETAINFO MED_STRUCTURE_TYPE_PREAMBLE MED_STRUCTURE_TYPE_ALL

Return Value:

N/A

Bits Per Pixel:

N/A

Sample:

Med