Click here to Skip to main content
Click here to Skip to main content

C# Wrapper to the FreeImage DLL for graphical image format conversion

By , 30 Sep 2003
Rate this:
Please Sign up or sign in to vote.

Introduction

FreeImage is an extremely useful Open Source project for reading, manipulating and converting a large amount of graphical formats. However at present the library exists as Win32 Dynamic Link Library. As my latest fascination is C#, I decided to create a simple Interop wrapper for it.

Using the code

The code is very straightforward to use, which is a reflection on the FreeImage implementation itself. For my needs I wanted to be able to take a picture file in Portable Bitmap (PBM) format and convert it to a standard Bitmap (BMP). For this I needed 3 methods exposed via the FreeImage DLL, FreeImage_Load, FreeImage_Save and FreeImage_Unload, the signature for which are:

DLL_API FIBITMAP *DLL_CALLCONV FreeImage_Load(FREE_IMAGE_FORMAT fif, 
       const char *filename, int flags FI_DEFAULT(0));
 
DLL_API BOOL DLL_CALLCONV FreeImage_Save(FREE_IMAGE_FORMAT fif, 
   FIBITMAP *dib, const char *filename, int flags FI_DEFAULT(0)); 
 
DLL_API void DLL_CALLCONV FreeImage_Unload(FIBITMAP* dib);

Now the C# Interop signatures for these are:

    public class FreeImage
    {
         [DllImport("FreeImage.dll")]
         public static extern int FreeImage_Load(FIF format, 
                        string filename, int flags);
         
         [DllImport("FreeImage.dll")]
         public static extern void FreeImage_Unload(int handle);
         
         [DllImport("FreeImage.dll")]
         public static extern bool FreeImage_Save(FIF format, 
            int handle, string filename, int flags);
    }

As an example, to convert a graphical image from PBM to BMP, all you need to do is the following (note the enum FIF is not documented here, but can be found in the source code).

namespace Test
{
    class MainClass
    {
        public static void Main(string[] args)
        {
            int handle = FreeImageAPI.FreeImage.FreeImage_Load(
                FreeImageAPI.FIF.FIF_PBM,
                @"c:\image.pbm", 
                0);
                          
            FreeImageAPI.FreeImage.FreeImage_Save(
                FreeImageAPI.FIF.FIF_BMP,   
                handle, 
                @"c:\image.bmp", 
                0);
 
            FreeImageAPI.FreeImage.FreeImage_Unload(handle);          
        }
    }
}

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here

About the Author

David Boland
Web Developer
United States United States
No Biography provided

Comments and Discussions

 
GeneralRe: Displaying in .NET Pinmemberfurkinfedup23-Jan-04 23:26 
GeneralRe: Displaying in .NET Pinmemberpersée23-Aug-05 4:41 
GeneralMemory or File... PinmemberDrew Stainton1-Oct-03 7:46 
GeneralRe: Memory or File... PinsussAnonymous1-Oct-03 22:38 
QuestionHow to draw FIBITMAP to form. PinmemberSkyer1-Oct-03 4:30 
AnswerRe: How to draw FIBITMAP to form. PinmemberDavid Boland1-Oct-03 5:09 
GeneralAccessing the image PinmemberRay Hayes1-Oct-03 1:36 
GeneralRe: Accessing the image PinmemberDavid Boland1-Oct-03 5:20 
Hi Ray,
 
Once you've converted the image to your required format you could then use the .NET Bitmap or Image classes to read it. Note that the FreeImage API should only be used to load->convert->save and image, if the image is already in a format compatable with the Image or Bitmap classes then theres no need of the FreeImage API.
 
David
GeneralSystem::Drawing::Image PinmemberJonathan de Halleux1-Oct-03 1:36 
GeneralRe: System::Drawing::Image PinmemberDavid Boland1-Oct-03 5:15 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Mobile
Web01 | 2.8.140415.2 | Last Updated 1 Oct 2003
Article Copyright 2003 by David Boland
Everything else Copyright © CodeProject, 1999-2014
Terms of Use
Layout: fixed | fluid