←Select platform

ToDib Method


Gets an unmanaged pointer containing a Windows device independent bitmap (DIB) version of this image.


WinRT C#
public IBuffer ToDib(  
   Leadtools.RasterConvertToDibType type 
Public Function ToDib( _ 
   ByVal type As Leadtools.RasterConvertToDibType _ 
) As IBuffer 
public IBuffer ToDib(  
   Leadtools.RasterConvertToDibType type 
 function Leadtools.RasterImage.ToDib(  
IBuffer^ ToDib(  
   Leadtools.RasterConvertToDibType type 


Type of DIB to create.

Return Value

A handle to the Windows DIB.


When this method is completed, there are two copies of the image in memory: the DIB and the original RasterImage. Freeing one will not affect the other.

This methods allocates a DIB bitmap and copies the RasterImage to the DIB.

NOTE: This method returns the data in an unmanaged buffer. The caller is responsible for freeing the DIB's IntPtr when it is no longer needed. You can use Marshal.FreeHGlobal.

A DIB consists of one of the following:

  • a BITMAPV4HEADER(introduced in Windows 95 and Windows NT 4.0)
  • or a BITMAPV5HEADER (introduced in Windows 2000 and Windows 98)

followed by a color table and then the bitmap data. The resulting DIB type is determined by the value of the type parameter.

The orientation of the image and color order will depend on how the image was loaded into the RasterImage.

When you no longer need the DIB, you must free it.

For more information on DDBs and DIBs, refer to Introduction: DIBs, DDBs, and the Clipboard.

This function does not support signed images.


Target Platforms

Help Version 19.0.2017.10.27
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.

Leadtools Assembly