In This Topic ▼

L_DicomGetElementOffset

#include "Ltdic.h"

L_LTDIC_APIL_INT64L_DicomGetElementOffset(hDS, pElement)

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

Parameters

HDICOMDShDS

A DICOM handle.

pDICOMELEMENTpElement

Pointer to aDICOMELEMENTstructure 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 toFiles 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 elementL_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 upL_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:\\LEADTOOLS21\\Resources\\Images\\")pFileNameL_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 elementL_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 upL_DicomFreeDS(hDS);}

Download our FREE evaluation

Help Version 21.0.2021.7.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