LoadDSArray method (ILEADDicomDS)

Visual Basic example

Visual C++ 6.0 example

 

Syntax

short LoadDSArray(VARIANT vMem, short nFlags);

Overview

Refer to Working with Data Sets.

Remarks

Loads the Data Set from a byte array.

This method DOES NOT make a copy of the byte array stored in vMem. Therefore, DO NOT destroy this memory as long as you are using the dataset referenced by this instance of the COM object, or until you have reset the dataset by calling ResetDS method.

Once you have called the ResetDS method, you can repopulate the data set by calling InitDS method, LoadDS method, or LoadDSArray method.

If you know certain characteristics of the DICOM file stored in vMem, you can set those in nFlags. Any characteristic that you don’t set will be automatically determined. For example, if you know that the metaheader is present, but you do not know the byte order, or whether the Value Representation is implicit or explicit, you can set only DS_METAHEADER_PRESENT in nFlags. During loading LEADTOOLS will determine the byte order and whether the byte order is implicit or explicit.

If you do not know any of the characteristics of the DICOM file, set nFlags to 0 and LEADTOOLS will automatically determine all the file characteristics and load the file accordingly.

Any of the available Meta-header flags listed under nFlags may be combined with any of the available values or combinations of values for the Transfer Syntax flags. For example, you may combine DS_METAHEADER_ABSENT with DS_EXPLICIT_VR, or you may combine DS_METAHEADER_PRESENT with DS_BIG_ENDIAN | DS_EXPLICIT_VR, etc.

See Also

Elements:

ResetDS method, InitDS method, LoadDS method, SaveDS method

Topics:

Data Sets: Creating, Initializing, Loading, and Saving Data Sets