Public Function GetOverlayImage( _
   ByVal index As Integer _
) As RasterImage

Visual Basic (Usage)	Copy Code
Dim instance As DicomDataSet Dim index As Integer Dim value As RasterImage   value = instance.GetOverlayImage(index)

public RasterImage GetOverlayImage( 
   int index
)

public:
RasterImage^ GetOverlayImage( 
   int index
) 

Parameters

index

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

Return Value

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 Leadtools.Dicom.DicomDataSet.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 Leadtools.Dicom.DicomDataSet.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 DicomDataSet.GetImage. 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 Leadtools.Dicom.DicomDataSet.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 DicomDataSet.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.

Target Platforms: Silverlight 3.0, Windows XP, Windows Server 2003 family, Windows Server 2008 family, Windows Vista, Windows 7, MAC OS/X (Intel Only)

Reference