Leadtools.Dicom Requires Medical product license | Send comments on this topic. | Back to Introduction - All Topics | Help Version 16.5.9.25
GetWindow(Int32,Int32) Method
See Also 
Leadtools.Dicom Namespace > DicomDataSet Class > GetWindow Method : GetWindow(Int32,Int32) Method



frameIndex
A zero-based index that identifies the frame number in the dataset. If the dataset does not support Multi-frames, this parameter is ignored.
index
The zero-based index of the window center, window width value, to retrieve. According to the DICOM standard, if multiple values are present for the window center and window width, both attributes shall have the same number of values and shall be considered as pairs.
frameIndex
A zero-based index that identifies the frame number in the dataset. If the dataset does not support Multi-frames, this parameter is ignored.
index
The zero-based index of the window center, window width value, to retrieve. According to the DICOM standard, if multiple values are present for the window center and window width, both attributes shall have the same number of values and shall be considered as pairs.
Retrieves the attributes that describe the "Window Center" and "Window Width".

Syntax

Visual Basic (Declaration) 
Overloads Public Function GetWindow( _
   ByVal frameIndex As Integer, _
   ByVal index As Integer _
) As DicomWindowAttributes
Visual Basic (Usage)Copy Code
Dim instance As DicomDataSet
Dim frameIndex As Integer
Dim index As Integer
Dim value As DicomWindowAttributes
 
value = instance.GetWindow(frameIndex, index)
C# 
public DicomWindowAttributes GetWindow( 
   int frameIndex,
   int index
)
C++/CLI 
public:
DicomWindowAttributes^ GetWindow( 
   int frameIndex,
   int index
) 

Parameters

frameIndex
A zero-based index that identifies the frame number in the dataset. If the dataset does not support Multi-frames, this parameter is ignored.
index
The zero-based index of the window center, window width value, to retrieve. According to the DICOM standard, if multiple values are present for the window center and window width, both attributes shall have the same number of values and shall be considered as pairs.

Return Value

The window-related attributes.

Example

Remarks

This method will retrieve the attributes that describe window center and window width.

Window Center" (0028,1050) and "Window Width" (0028,1051) specify a linear conversion from stored pixel values (after any modality LUT or rescale slope and intercept specified in the IOD have been applied) to values to be displayed. Please see "VOI LUT Module Attributes" in the DICOM standard for more details.

This method will fail and throw a DicomExceptionCode.Parameter exception if the window count (number of values under the window center element) equals 0 or if windowIndex is greater or equal to the window count.

index is zero-based; if you pass 0 for example, this method will populate DicomWindowAttributes.WindowCenter with the first value under the "Window Center" (0028,1050) element, DicomWindowAttributes.WindowWidth with the first value under the "Window Width" (0028,1051) element, and DicomWindowAttributes.Explanation with "Window Center and Width Explanation" (0028,1055) element if it exists.

The Multi-frame Functional Groups module may have a Shared Functional Groups Sequence item, and/or a Per-frame Functional Groups Sequence item. Either of these items may have a Frame VOI LUT Sequence (0028,9132) item. If the following elements are not found at the top level in the dataset, this method looks in the Shared Functional Groups Sequence item and the Per-frame Functional Groups Sequence items.
Tag Name
(0028,1050) Window Center
(0028,1051) Window Width
(0028,1055) Window Center & Width Explanation


For a detailed discussion on Multi-frame Functional Groups see the topic Multi-frame Functional Groups.

Requirements

Target Platforms: Microsoft .NET Framework 3.0, Windows XP, Windows Server 2003 family, Windows Server 2008 family

See Also

Leadtools.Dicom requires a Medical toolkit server license and unlock key. For more information, refer to: Imaging Pro/Document/Medical Features