LEADTOOLS Medical (Leadtools.Dicom assembly)
LEAD Technologies, Inc

GetOverlayImage Method








The zero-based index of the overlay whose image is required.
Retrieves the "Overlay Data" (60xx,3000) for the specified overlay index. .NET support WinRT support Silverlight support
Syntax
public RasterImage GetOverlayImage( 
   int index
)
'Declaration
 
Public Function GetOverlayImage( _
   ByVal index As Integer _
) As RasterImage
'Usage
 
Dim instance As DicomDataSet
Dim index As Integer
Dim value As RasterImage
 
value = instance.GetOverlayImage(index)
public RasterImage GetOverlayImage( 
   int index
)
ObjectiveC Syntax
 function Leadtools.Dicom.DicomDataSet.GetOverlayImage( 
   index 
)
public:
RasterImage^ GetOverlayImage( 
   int index
) 

Parameters

index
The zero-based index of the overlay whose image is required.

Return Value

Image filled with the overlay data.
Remarks
This method will extract the "Overlay Data" (60xx,3000) for an overlay, initialize the returned image based on the "Overlay Columns" (60xx,0011) and "Overlay Rows" (60xx,0010), and then fill the image with the stream of bytes under the "Overlay Data" (60xx,3000) element.

If the method does not find the "Overlay Data" element inside the Data Set it will throw an DicomExceptionCode.OverlayDataMissing exception.

Before calling this method you must call GetOverlayAttributes to determine if the overlay pixel data is embedded in the "Image Pixel Data" (7FE0,0010) element or is under the "Overlay Data" (60xx,3000) element. If the overlay data is embedded in the "Image Pixel Data", Leadtools.RasterOverlayAttributes.UseBitPlane will be set to true in the attributes returned by GetOverlayAttributes.

If the overlay pixel data is embedded in the "Image Pixel Data" (7FE0, 0010), follow these steps to get the overlay data:

  1. Call one of the methods which can be used to extract the "Image Pixel Data", such as GetImage(DicomElement,Int32,Int32,RasterByteOrder,DicomGetImageFlags). This will return a raster image populated with the "Image Pixel Data" with the overlay data embedded. For this example, assume that the raster image returned by this method is called mainImage.
  2. Call GetOverlayAttributes to get the attributes of the overlay. For this example, assume that the overlay attributes returned by this method is called overlayAttributes.
  3. Now we need to add our overlay as one of the overlays associated with mainImage. To do that, we need to call SetOverlayAttributes:

    mainImage.Leadtools.RasterImage.UpdateOverlayAttributes(System.Int32,Leadtools.RasterOverlayAttributes,Leadtools.RasterGetSetOverlayAttributesFlags)(0, overlayAttributes, RasterGetSetOverlayAttributesFlags.Flags | RasterGetSetOverlayAttributesFlags.BitIndex | RasterGetSetOverlayAttributesFlags.Origin | RasterGetSetOverlayAttributesFlags.Dicom | RasterGetSetOverlayAttributesFlags.Color);

    We are assuming that this is the first overlay in the image; this is why we are passing 0 as the overlay index.

  4. Now we need to extract the overlay data from the main image data:

    mainImage.Leadtools.RasterImage.UpdateOverlayBits(System.Int32,Leadtools.RasterUpdateOverlayBitsFlags)(0, RasterUpdateOverlayBitsFlags.FromImage);

  5. Now call mainImage.Leadtools.RasterImage.GetOverlayImage(System.Int32,Leadtools.RasterGetSetOverlayImageMode) to get the overlay data itself as a raster image.
Example
For an example, refer to OverlayCount.
Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also

Reference

DicomDataSet Class
DicomDataSet Members
OverlayCount Property
GetOverlayAttributes Method
GetOverlayActivationLayer Method
GetOverlayImages(Int32,Int32,Int32) Method
SetOverlayAttributes Method
SetOverlayImage Method
SetOverlayImages Method
DeleteOverlay Method

 

 


Products | Support | Contact Us | Copyright Notices

© 2006-2012 All Rights Reserved. LEAD Technologies, Inc.

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