In This Topic ▼

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

LTDIC
For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64, Linux.

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); 
}

Download our FREE evaluation

Help Version 20.0.2020.4.2

LEADTOOLS DICOM C API Help

Introduction

Version History

Getting Started

Features of LEADTOOLS DICOM

Redistributables/Files To Be Included With Your Application

Quick Reference

Function References

Appendix