ChangeToImage Method

Visual Basic
C#
WinRT C#
WinRT JavaScript
C++

public static Image ChangeToImage( 
   RasterImage image,
   ChangeToImageOptions options
)

'Declaration
 
Public Shared Function ChangeToImage( _
   ByVal image As RasterImage, _
   ByVal options As ChangeToImageOptions _
) As Image

'Usage
 
Dim image As RasterImage
Dim options As ChangeToImageOptions
Dim value As Image
 
value = RasterImageConverter.ChangeToImage(image, options)

public static Image ChangeToImage( 
   RasterImage image,
   ChangeToImageOptions options
)

 function Leadtools.Drawing.RasterImageConverter.ChangeToImage( 
   image ,
   options 
)

public:
static Image^ ChangeToImage( 
   RasterImage^ image,
   ChangeToImageOptions options
)

Parameters

image: The source image.
options: The conversion options.

Return Value

The GDI+ image that this method creates.

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

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

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

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

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

To convert a GDI+ image to a LEADTOOLS Leadtools.RasterImage, use ConvertFromImage.

For more information, refer to Using The PaintEngine Property.

For more information refer to RasterImage and GDI/GDI+.

Visual Basic
C#
WinRT C#
WinRT JavaScript
Silverlight C#
Silverlight VB

Public Sub ChangeToImageExample()
      Dim codecs As New RasterCodecs()

      Dim srcFileName As String = Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp")
      Dim destFileName As String = Path.Combine(LEAD_VARS.ImagesDir, "GdiPlusImage1.bmp")

      ' Load the image
      Using srcImage As RasterImage = codecs.Load(srcFileName)
         ' Convert to GDI+ image
         Dim reason As ImageIncompatibleReason = RasterImageConverter.TestCompatible(srcImage, True)
         Dim pf As PixelFormat = RasterImageConverter.GetNearestPixelFormat(srcImage)
         Console.WriteLine("TestCompatible: {0}", reason)
         Console.WriteLine("GetNearestPixelFormat:{0}", pf)

         If reason <> ImageIncompatibleReason.Compatible Then
            RasterImageConverter.MakeCompatible(srcImage, pf, True)
         End If

         Using destImage As Image = RasterImageConverter.ChangeToImage(srcImage, ChangeToImageOptions.ForceChange)
            ' Save this image to disk
            destImage.Save(destFileName, ImageFormat.Bmp)
         End Using
      End Using

      ' Clean up
      codecs.Dispose()
   End Sub

Public NotInheritable Class LEAD_VARS
   Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images"
End Class

public void ChangeToImageExample()
   {
      RasterCodecs codecs = new RasterCodecs();

      string srcFileName = Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp");
      string destFileName = Path.Combine(LEAD_VARS.ImagesDir, "GdiPlusImage1.bmp");

      // Load the image
      using(RasterImage srcImage = codecs.Load(srcFileName))
      {
         // Convert to GDI+ image
         ImageIncompatibleReason reason = RasterImageConverter.TestCompatible(srcImage, true);
         PixelFormat pf = RasterImageConverter.GetNearestPixelFormat(srcImage);
         Console.WriteLine("TestCompatible: {0}", reason);
         Console.WriteLine("GetNearestPixelFormat:{0}", pf);

         if(reason != ImageIncompatibleReason.Compatible)
         {
            RasterImageConverter.MakeCompatible(srcImage, pf, true);
         }

         using(Image destImage = RasterImageConverter.ChangeToImage(srcImage, ChangeToImageOptions.ForceChange))
         {
            // Save this image to disk
            destImage.Save(destFileName, ImageFormat.Bmp);
         }
      }

      // Clean up
      codecs.Dispose();
   }

static class LEAD_VARS
{
   public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images";
}

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

Reference

RasterImageConverter Class
RasterImageConverter Members