Offset Property

Summary

Gets the byte offset of the element from the beginning of the file

Syntax

Objective-C

C++/CLI

public long Offset { get; }

@property (nonatomic, assign, readonly) NSUInteger offset;

public: 
property int64 Offset { 
   int64 get(); 
}

Property Value

The byte offset of the element from the beginning of the file

Remarks

Depending on the transfer syntax and value representation, a DICOM Element is stored in a file as one of the following

Tag(4 bytes), VR(4 bytes), Value Length (4 bytes), Value
Tag(4 bytes), VR(2 bytes), Value Length (2 bytes), Value
Tag(4 bytes), Value Length (4 bytes), Value

The Offset property returns the byte offset for the DicomElement in the file. If you seek to this offset in the DICOM file, the next 4 bytes will be the Tag (group, element) of the DICOM element.

Example

This example displays information about each element in a DicomDataSet including: * Tag * Name * Offset * Value offset * Value length

using Leadtools; 
using Leadtools.Dicom; 
 
 
/// 
private void DicomDataSetOffsetTest(DicomDataSet ds) 
{ 
   DicomElement element = ds.GetFirstElement(null, false, true); 
   while (element != null) 
   { 
      DumpElementValue(element); 
      element = ds.GetNextElement(element, false, true); 
   } 
} 
 
private string GetElementString(DicomElement p) 
{ 
   if (p == null) 
      return string.Empty; 
   return string.Format("({0:X4},{1:X4})", p.Tag >> 0x10, p.Tag & 0xFFFF); 
} 
 
private string Truncate(string s, int length) 
{ 
   if (s.Length > length) 
      return s.Substring(0, length); 
   return s; 
} 
 
private void DumpElementValue(DicomElement element) 
{ 
   DicomTag tag = DicomTagTable.Instance.Find(element.Tag); 
   string name = string.Empty; 
   if (tag != null) 
   { 
      name = tag.Name; 
   } 
   Console.WriteLine(@"{0} {1,-30} 0x{2:X8} 0x{3:X8} {4}", 
      GetElementString(element), 
      Truncate(name, 30), 
      element.Offset, 
      element.ValueOffset, 
      element.ValueLength); 
}

Requirements

Target Platforms

Reference

DicomElement Class

DicomElement Members

Download our FREE evaluation

Help Version 23.0.2024.2.29

Leadtools.Dicom Assembly

Introduction

Getting Started

Namespaces

Leadtools.Dicom Namespace

Assemblies