L_DicomGetOverlayBitmapList

Summary

Loads the bitmap list with frames from the "Overlay Data" (60xx, 3000) element.

Syntax

#include "ltdic.h"

L_LTDIC_API L_UINT16 L_DicomGetOverlayBitmapList(hDS, uOverlayIndex, hList, uOverlayFrameIndex, uCount, uFlags)

Parameters

HDICOMDS hDS

A DICOM handle.

L_UINT uOverlayIndex

The index of the overlay for which to get the frames. This index is zero-based.

HBITMAPLIST hList

Handle to the list of bitmaps.

L_UINT32 uOverlayFrameIndex

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.

L_UINT32 uCount

Number of frames to load into the bitmap list.

L_UINT uFlags

Reserved for future use. Pass 0.

Returns

Value Meaning
DICOM_SUCCESS The function was successful.
>0 An error occurred. Refer to Return Codes.

Comments

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.

Required DLLs and Libraries

Platforms

Win32, x64, Linux.

See Also

Functions

Topics

Example

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 Version 22.0.2022.12.7
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS DICOM C API Help

Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.