Loads the bitmap list with frames from the "Overlay Data" (60xx, 3000) element.
#include "ltdic.h"
L_LTDIC_API L_UINT16 L_DicomGetOverlayBitmapList(hDS, uOverlayIndex, hList, uOverlayFrameIndex, uCount, uFlags)
A DICOM handle.
The index of the overlay for which to get the frames. This index is zero-based.
Handle to the list of bitmaps.
Position of the first frame to load. Use zero-based indexing. For example, if there are 5 bitmaps in a list, the index of the last one is 4.
Number of frames to load into the bitmap list.
Reserved for future use. Pass 0.
Value | Meaning |
---|---|
DICOM_SUCCESS | The function was successful. |
>0 | An error occurred. Refer to Return Codes. |
Before calling this function you must call L_DicomGetOverlayAttributes. The nNumFramesInOverlay member of the OVERLAYATTRIBUTES structure will be filled with the number of frames under an overlay.
As an example, if you wish to load 5 frames starting with the 1st frame in the "Overlay Data", call this function with uOverlayFrameIndex set to 0 and uCount set to 5.
Win32, x64, Linux.
This function will load frames of an overlay into a bitmap list
L_INT DicomGetOverlayBitmapListExample(
HDICOMDS hDicomDS, // handle to Dicom DS
HBITMAPLIST hList, //Bitmap list to be populated
L_TCHAR* pActivationLayer, //Retrieve activation layer if needed
L_UINT uLength) //Length of input buffer
{
L_UINT16 uRet;
OVERLAYATTRIBUTES OverlayAttributes = {0};
L_INT GroupNumber=0;
L_BOOL IsOverlayInDataset = FALSE;
//(1)Sanity Check !
if((hList == NULL )|| (hDicomDS == NULL))
return DICOM_ERROR_NULL_PTR;
// Get activation layer
if(pActivationLayer && uLength)
{
uRet = L_DicomGetOverlayActivationLayer(hDicomDS,0,pActivationLayer,uLength);
if (uRet != DICOM_SUCCESS)
return uRet;
}
uRet = L_DicomGetOverlayAttributes(hDicomDS, 0, &OverlayAttributes, sizeof(OverlayAttributes), &GroupNumber, &IsOverlayInDataset, 0);
if(DICOM_SUCCESS !=uRet)
return uRet;
return L_DicomGetOverlayBitmapList(hDicomDS, 0, hList, 0, OverlayAttributes.nNumFramesInOverlay, 0);
}
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
Your email has been sent to support! Someone should be in touch! If your matter is urgent please come back into chat.
Chat Hours:
Monday - Friday, 8:30am to 6pm ET
Thank you for your feedback!
Please fill out the form again to start a new chat.
All agents are currently offline.
Chat Hours:
Monday - Friday
8:30AM - 6PM EST
To contact us please fill out this form and we will contact you via email.