Public Function ChangeToGdiPlusImage( _
   ByVal flags As ChangeToGdiPlusImageFlags _
) As Image

Visual Basic (Usage)	Copy Code
Dim instance As RasterImage Dim flags As ChangeToGdiPlusImageFlags Dim value As Image   value = instance.ChangeToGdiPlusImage(flags)

public Image ChangeToGdiPlusImage( 
   ChangeToGdiPlusImageFlags flags
)

public:
Image ChangeToGdiPlusImage( 
   ChangeToGdiPlusImageFlags flags
) 

Parameters

flags

Options for the conversion.

Return Value

This example changes between a RasterImage and a GDI+ image

Visual Basic

Copy Code

Public Sub ChangeToGdiPlusImageExample()    RasterCodecs.Startup()    Dim codecs As RasterCodecs = New RasterCodecs()    Dim srcFileName As String = LeadtoolsExamples.Common.ImagesPath.Path + "Image1.cmp"    Dim destFileName As String = LeadtoolsExamples.Common.ImagesPath.Path + "GdiPlusImage1.bmp"    ' Load the image    Dim srcImage As RasterImage = codecs.Load(srcFileName)    ' Convert to GDI+ image    Console.WriteLine("TestGdiPlusCompatible: {0}", (srcImage.TestGdiPlusCompatible(True)).ToString())    Console.WriteLine("NearestGdiPlusPixelFormat:{0}", (srcImage.NearestGdiPlusPixelFormat).ToString())    If srcImage.TestGdiPlusCompatible(True) <> RasterGdiPlusIncompatibleReason.Compatible Then       srcImage.MakeGdiPlusCompatible(srcImage.NearestGdiPlusPixelFormat, True)    End If    Dim destImage As Image = srcImage.ChangeToGdiPlusImage(ChangeToGdiPlusImageFlags.ForceChange)    ' Save this image to disk    destImage.Save(destFileName, ImageFormat.Bmp)    ' Clean up    destImage.Dispose()    srcImage.Dispose()    codecs.Dispose()    RasterCodecs.Shutdown() End Sub

C#

Copy Code

public void ChangeToGdiPlusImageExample()  {     RasterCodecs.Startup();     RasterCodecs codecs = new RasterCodecs();       string srcFileName = LeadtoolsExamples.Common.ImagesPath.Path + "Image1.cmp";     string destFileName = LeadtoolsExamples.Common.ImagesPath.Path + "GdiPlusImage1.bmp";       // Load the image     RasterImage srcImage = codecs.Load(srcFileName);       // Convert to GDI+ image     Console.WriteLine("TestGdiPlusCompatible: {0}", (srcImage.TestGdiPlusCompatible(true)).ToString());     Console.WriteLine("NearestGdiPlusPixelFormat:{0}", (srcImage.NearestGdiPlusPixelFormat).ToString());       if(srcImage.TestGdiPlusCompatible(true) != RasterGdiPlusIncompatibleReason.Compatible)        srcImage.MakeGdiPlusCompatible(srcImage.NearestGdiPlusPixelFormat, true);       Image destImage = srcImage.ChangeToGdiPlusImage(ChangeToGdiPlusImageFlags.ForceChange);       // Save this image to disk     destImage.Save(destFileName, ImageFormat.Bmp);       // Clean up     destImage.Dispose();     srcImage.Dispose();     codecs.Dispose();     RasterCodecs.Shutdown();  }

This result GDI+ image and this RasterImage object will share the same image data. You can use this method to pass a LEAD RasterImage object to other class library methods that expect a GDI+ Image object. Use the ConvertToGdiPlusImage method to obtain a GDI+ Image object that is a copy of this RasterImage object.

Calling this method may change the internal format of this RasterImage object.

Use TestGdiPlusCompatible to determine if the image is compatible for conversion to a GDI+ image.

For a RasterImage to be compatible with a GDI+ image it needs the following:

• IsConventionalMemory to be true (Tiled, compressed and disk-based images are not supported)
• BitsPerPixel value of 1, 4, 8, 16, 24 or 32
• Order value of RasterByteOrder.Rgb or RasterByteOrder.Bgr
• Not a gray scale image.
• ViewPerspective value of RasterViewPerspective.TopLeft

For more information, refer to The RasterPaintEngine Property and 16bpp Grayscale Images and Using The PaintEngine Property.

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

Reference