#include "ltdic.h"
L_LTDIC_API L_UINT16 L_DicomDirLoadDS(hDicomDir, pszName, nFlags)
Loads the DICOM Directory Data Set from the specified file.
A DICOMDIR handle
Character string that contains the name of the DICOMDIR File.
Meta-header flags and Transfer Syntax flags that indicate the file characteristics to use when loading the file. Possible values are:
Value | Meaning |
---|---|
Meta-header flags | |
0 | [0x0000] LEADTOOLS will automatically determine the presence or absence of the Meta-header. |
DS_METAHEADER_PRESENT | [0x0001] The header is present. |
DS_METAHEADER_ABSENT | [0x0002] The header is absent. |
Transfer Syntax flags | |
0 | [0x0000] LEADTOOLS will automatically determine the Transfer Syntax. |
DS_LITTLE_ENDIAN | [0x0004] Byte order is Little Endian. |
DS_BIG_ENDIAN | [0x0008] Byte order is Big Endian. |
DS_IMPLICIT_VR | [0x0010] The Value Representation is implicit. |
DS_EXPLICIT_VR | [0x0020] The Value Representation is explicit. |
DS_LITTLE_ENDIAN | DS_IMPLICIT_VR | |
DS_LITTLE_ENDIAN | DS_EXPLICIT_VR | |
DS_BIG_ENDIAN | DS_EXPLICIT_VR | |
DS_LOAD_CLOSE | [0x0200] The complete dataset will be loaded into memory and the file handle closed. |
Any of the available Meta-header flags given above may be combined with any of the available values or combinations of values for the Transfer Syntax flags given above. For example, you may combine DS_METAHEADER_ABSENT with DS_EXPLICIT_VR, or you may combine DS_METAHEADER_PRESENT with DS_LITTLE_ENDIAN | DS_EXPLICIT_VR, etc. |
Value | Meaning |
---|---|
0 | The function was successful. |
> 0 | An error occurred. Refer to Return Codes. |
In addition to loading the DICOM Directory Data Set, the function also sets the destination folder to the folder in which the specified DICOMDIR File resides. Additional DICOM files in this folder (and subfolders) can be added to the loaded Directory.
If DS_LOAD_CLOSE is used, for large images, this may slow performance, however, the file handle will be released. If set to None, large images will load quickly, and image traverse can begin immediately. However, until the file handle is released, nothing can be done to the image.
If DS_LOAD_CLOSE is not specified, the file will remain open until one of the following functions is called: L_DicomDirReset, L_DicomDirLoadDS (again), L_DicomResetDS, L_DicomInitDS, or L_DicomLoadDS.
For more information, refer to the overridden function L_DicomLoadDS.
Required DLLs and Libraries
Help Collections
Raster .NET | C API | C++ Class Library | HTML5 JavaScript
Document .NET | C API | C++ Class Library | HTML5 JavaScript
Medical .NET | C API | C++ Class Library | HTML5 JavaScript
Medical Web Viewer .NET
Multimedia
Direct Show .NET | C API | Filters
Media Foundation .NET | C API | Transforms
Supported Platforms
.NET, Java, Android, and iOS/macOS Assemblies
Imaging, Medical, and Document
C API/C++ Class Libraries
Imaging, Medical, and Document
HTML5 JavaScript Libraries
Imaging, Medical, and Document