L_DicomGetElementOffset

#include "Ltdic.h"

L_LTDIC_API L_INT64 L_DicomGetElementOffset(hDS, pElement)

Returns the offset of the DICOM element pElement in the DICOM file.

Parameters

HDICOMDS hDS

A DICOM handle.

pDICOMELEMENT pElement

Pointer to a DICOMELEMENT structure within the Data Set.

Returns

Value Meaning
DICOM_SUCCESS The offset of the element is unknown.
>0 The offset of the element in the DICOM file.

Comments

You must load a DICOM file using the flag DS_LOAD_STORE_OFFSETS to use this function.  Otherwise, L_DicomGetElementOffset will always return 0.

This method is used to return the offset (or physical location) in a DICOM file of any DICOM element.

Required DLLs and Libraries

Platforms

Win32, x64, Linux.

See Also

Functions

Topics

Example

This example loads a DICOM file, and finds the physical offset of the TAG_PATIENT_ID in the file.

L_VOID DicomGetElementOffsetExample()  
{ 
   HDICOMDS hDS = L_DicomCreateDS(NULL); 
   if (hDS == NULL) 
      return; 
   L_TCHAR *pszFile = MAKE_IMAGE_PATH(TEXT("image2.dcm")); 
 
   L_DicomLoadDS(hDS, pszFile, DS_LOAD_STORE_OFFSETS); 
   pDICOMELEMENT pElement = L_DicomFindFirstElement(hDS, NULL, TAG_PATIENT_ID, TRUE); 
   if (pElement == NULL) 
      return; 
 
   // uOffset will contain the file offset of the TAG_PATIENT_ID element 
   L_INT64 uOffset = L_DicomGetElementOffset(hDS, pElement); 
   L_TCHAR szMsg[200]={0}; 
   wsprintf(szMsg, TEXT("The offset of the TAG_PATIENT_ID in file '%s' is: 0x%x"), pszFile, uOffset); 
   OutputDebugString(szMsg); 
 
   // Clean up 
   L_DicomFreeDS(hDS); 
} 

This example loads a DICOM file, and finds the physical offset of the TAG_PATIENT_ID in the file.

#define MAKE_IMAGE_PATH(pFileName) TEXT("C:\\Users\\Public\\Documents\\LEADTOOLS Images\\")pFileName 
L_VOID DicomGetElementOffsetExample() 
{ 
   HDICOMDS hDS = L_DicomCreateDS(NULL); 
   if (hDS == NULL) 
      return; 
   L_TCHAR *pszFile = MAKE_IMAGE_PATH(TEXT("image2.dcm")); 
   L_DicomLoadDS(hDS, pszFile, DS_LOAD_STORE_OFFSETS); 
   pDICOMELEMENT pElement = L_DicomFindFirstElement(hDS, NULL, TAG_PATIENT_ID, TRUE); 
   if (pElement == NULL) 
      return; 
   // uOffset will contain the file offset of the TAG_PATIENT_ID element 
   L_INT64 uOffset = L_DicomGetElementOffset(hDS, pElement); 
   L_TCHAR szMsg[200]={0}; 
   wsprintf(szMsg, TEXT("The offset of the TAG_PATIENT_ID in file '%s' is: 0x%x"), pszFile, uOffset); 
   OutputDebugString(szMsg); 
   // Clean up 
   L_DicomFreeDS(hDS); 
} 

Help Version 20.0.2020.4.2
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS DICOM C API Help