ChangeToHBitmap(RasterImage) Method

Summary

Changes a LEADTOOLS Leadtools.RasterImage object to a Windows Device-Dependent Bitmap (DDB).

Syntax

C++/CLI

Python

public static IntPtr ChangeToHBitmap( 
   RasterImage image 
)

public: 
static IntPtr ChangeToHBitmap(  
   RasterImage^ image 
)

def ChangeToHBitmap(self,image):

Parameters

image
The source image.

Return Value

A handle to the device dependent bitmap (DDB) this method creates.

Remarks

This method results in only one copy of the image, and it invalidates this Leadtools.RasterImage object. You must call RasterImage.Dispose after calling this method.

For more information on DDBs, DIBs, GDI and GDI+ refer to Using DIBs, DDBs, and the Clipboard and RasterImage and GDI/GDI+.

Example

This example loads a Leadtools.RasterImage, changes it to a DDB and then changes it back to Leadtools.RasterImage.

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.Drawing; 
using Leadtools.ImageProcessing; 
using Leadtools.ImageProcessing.Color; 
 
 
public void ChangeToHBitmapExample() 
{ 
   RasterCodecs codecs = new RasterCodecs(); 
 
   IntPtr hbitmap; 
 
   // Load an image 
   using (RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp"), 24, CodecsLoadByteOrder.BgrOrGray, 1, 1)) 
   { 
      // Change to DDB 
      hbitmap = RasterImageConverter.ChangeToHBitmap(image); 
 
      // Dispose the image since it is unusable now 
   } 
 
   // Change the DDB to a new LEAD RasterImage 
   using (RasterImage image = RasterImageConverter.ChangeFromHBitmap(hbitmap, IntPtr.Zero)) 
   { 
      // Save this image back to disk 
      codecs.Save(image, Path.Combine(LEAD_VARS.ImagesDir, "Image1_ChangeToHBitmap.bmp"), RasterImageFormat.Bmp, 24); 
   } 
 
   DeleteObject(hbitmap); 
 
   // Clean up 
   codecs.Dispose(); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS23\Resources\Images"; 
}