←Select platform

Offset Property

Summary
Gets the byte offset of the element from the beginning of the file
Syntax
C#
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

C#
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

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

Leadtools.Dicom Assembly