←Select platform

Is this page helpful?

In this page

ChangeFromWmf(IntPtr,​int,​int,​RasterColor) Method

Summary
Changes a Windows Metafile (WMF) into a LEADTOOLS Leadtools.RasterImage object and, if successful, frees the Metafile.
Syntax
C#
C++/CLI
Python
public static RasterImage ChangeFromWmf( 
   IntPtr hwmf, 
   int width, 
   int height, 
   RasterColor backColor 
) 
public: 
static RasterImage^ ChangeFromWmf(  
   IntPtr hwmf, 
   int width, 
   int height, 
   RasterColor backColor 
)  
def ChangeFromWmf(self,hwmf,width,height,backColor): 

Parameters

hwmf
Handle to the WMF to be changed.

width
Amount by which to scale the metafiles original width.

height
Amount by which to scale the metafiles original height.

backColor
The color to use to fill the image area before painting the metafile objects.

Return Value

The newly created Leadtools.RasterImage object.

Remarks

Some metafiles do not have a background color, and hence, when the metafile is used to create a Leadtools.RasterImage object, the area not covered by the metafile objects will contain the default image background color (black). To create a raster image from a metafile like this with a specific background color, set the desired background color in the  backColor parameter.

Some metafiles do not have a background color, and hence, when the metafile is used to create a Leadtools.RasterImage object, the area not covered by the metafile objects will contain the default image background color (black). To create a raster image from a metafile like this with a specific background color, use ChangeFromWmf(hemf, width, height, backColor).

If this method is successful,  hwmf is freed.

The metafile can be loaded at the original dimension or scaled by using the  width and  height parameters.

If  width == 0 and  height == 0 - the metafile is loaded at the size present in the file.

If  width == 0 and  height > 0 - the metafile is stretched so that it has the height  height (preserving the aspect ratio).

If  width > 0 and  height == 0 - the metafile is stretched so that it has the width  width (preserving the aspect ratio).

If  width > 0 and  height > 0 - the metafile is stretched so that it has the width  width and height  height (the aspect ratio is ignored).

This method does not support signed images.

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

Example
C#
Copied to clipboard
using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.Drawing; 
using Leadtools.ImageProcessing; 
using Leadtools.ImageProcessing.Color; 
 
 
public void ChangeFromWmfExample() 
{ 
   RasterCodecs codecs = new RasterCodecs(); 
 
   IntPtr hwmf; 
 
   // Load an image 
   using (RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp"), 24, CodecsLoadByteOrder.BgrOrGray, 1, 1)) 
   { 
      // Change to WMF 
      hwmf = RasterImageConverter.ChangeToWmf(image); 
   } 
 
   // Convert the WMF back to a RasterImage preserving the size 
   using (RasterImage image = RasterImageConverter.ChangeFromWmf(hwmf, 0, 0)) 
   { 
      // Save it to disk 
      codecs.Save(image, Path.Combine(LEAD_VARS.ImagesDir, "Image1_ChangeFromWmf.bmp"), RasterImageFormat.Bmp, 24); 
   } 
 
   // Clean up 
   codecs.Dispose(); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS23\Resources\Images"; 
} 
Requirements

Target Platforms

Help Version 23.0.2024.2.29
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.Drawing Assembly
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.