Wrapper/FreeImage.NET/cs/Samples/Sample 01 - Loading and saving/Program.cs

using System;
using System.IO;
using FreeImageAPI;
using System.Collections.Generic;
using System.Runtime.Serialization.Formatters.Binary;
using System.Drawing;
using System.Drawing.Imaging;
using System.Runtime.InteropServices;

namespace Sample01
{
	class Program
	{
		static void Main(string[] args)
		{
			// Check if FreeImage.dll is available (can be in %path%).
			if (!FreeImage.IsAvailable())
			{
				Console.WriteLine("FreeImage.dll seems to be missing. Aborting.");
				return;
			}

			Sample sample = new Sample();
			// This example shows the basic loading and saving operations offered by FreeImage.
			sample.Example01();

			// This example shows a more comfortable way offered by the .NET Wrapper.
			sample.Example02();

			// This example shows the FreeImage-Errormessage-Callback
			sample.Example03();
		}
	}

	public class Sample
	{
		const string fileName = @"Sample.jpg";
		const string outFileName = @"Sample.tif";
		FIBITMAP dib = new FIBITMAP();
		string message = null;

		public void Example01()
		{
			if (!File.Exists(fileName))
			{
				Console.WriteLine(fileName + " does not exist. Aborting.");
				return;
			}

			// Try to unload the bitmap handle (in case it is not null).
			// Always assert that a handle (like dib) is unloaded before it is reused, because
			// on unmanaged side there is no garbage collector that will clean up unreferenced
			// objects.
			// The following code will produce a memory leak (in case the bitmap is loaded
			// successfully) because the handle to the first bitmap is lost:
			//   dib = FreeImage.Load(FREE_IMAGE_FORMAT.FIF_JPEG, fileName, FREE_IMAGE_LOAD_FLAGS.JPEG_ACCURATE);
			//   dib = FreeImage.Load(FREE_IMAGE_FORMAT.FIF_JPEG, fileName, FREE_IMAGE_LOAD_FLAGS.JPEG_ACCURATE);
			if (!dib.IsNull)
				FreeImage.Unload(dib);

			// Loading a sample bitmap. In this case it's a .jpg file. 'Load' requires the file
			// format or the loading process will fail. An additional flag (the default value is
			// 'DEFAULT') can be set to enable special loading options.
			dib = FreeImage.Load(FREE_IMAGE_FORMAT.FIF_JPEG, fileName, FREE_IMAGE_LOAD_FLAGS.JPEG_ACCURATE);

			// Check if the handle is null which means the bitmap could not be loaded.
			if (dib.IsNull)
			{
				Console.WriteLine("Loading bitmap failed. Aborting.");
				// Check whether there was an error message.
				return;
			}

			// Try flipping the bitmap.
			if (!FreeImage.FlipHorizontal(dib))
			{
				Console.WriteLine("Unable to flip bitmap.");
				// Check whether there was an error message.
			}

			// Store the bitmap back to disk. Again the desired format is needed. In this case the format is 'TIFF'.
			// An output filename has to be chosen (which will be overwritten without a warning).
			// A flag can be provided to enable pluginfunctions (compression is this case).
			FreeImage.Save(FREE_IMAGE_FORMAT.FIF_TIFF, dib, outFileName, FREE_IMAGE_SAVE_FLAGS.TIFF_DEFLATE);

			// The bitmap was saved to disk but is still allocated in memory, so the handle has to be freed.
			if (!dib.IsNull)
				FreeImage.Unload(dib);

			// Make sure to set the handle to null so that it is clear that the handle is not pointing to a bitmap.
			dib.SetNull();
		}

		public void Example02()
		{
			// 'UnloadEx' is a comfortable way of unloading a bitmap. The coder can call 'UnloadEx' even
			// when the handle is pointing to null (in this case nothing will happen). In case the handle
			// is valid (valid means that it is NOT pointing to null) the bitmap will be unloaded and the
			// handle will be set to null manually.
			FreeImage.UnloadEx(ref dib);

			// 'LoadEx' is a comfortable way of loading a bitmap. 'LoadEx' tries to find out the format of
			// the file and will use this to load it. It will use DEFAULT loading values.
			dib = FreeImage.LoadEx(fileName);

			// Check if the handle is null which means the bitmap could not be loaded.
			if (dib.IsNull)
			{
				Console.WriteLine("Loading bitmap failed. Aborting.");
				return;
			}

			// 'SaveEx' (like 'LoadEx') will try to save the bitmap with default values.
			// Before saving the bitmap, 'SaveEx' checks whether the extension is valid for the file type
			// and if the plugin can use the colordepth of the bitmap. If not it will automatically convert
			// the bitmap into the next best colordepth and save it.
			if (!FreeImage.SaveEx(ref dib, @"Sample.gif", false))
			{
				Console.WriteLine("Saving bitmap failed.");
			}

			// The handle is still valid.
			if (!FreeImage.SaveEx(
				ref dib,
				@"Sample",							// No extension was selected so let 'SaveEx' decide.
				FREE_IMAGE_FORMAT.FIF_PNG,			// A format is needed this time.
				FREE_IMAGE_SAVE_FLAGS.DEFAULT,		// PNG has no options so use default.
				FREE_IMAGE_COLOR_DEPTH.FICD_04_BPP,	// 4bpp as result color depth.
				true))								// We're done so unload
			{
				// SaveEx will not unload the bitmap in case saving failed.
				// This way possible operations done to the bitmaps aren't lost.
				FreeImage.UnloadEx(ref dib);
			}
		}

		public void Example03()
		{
			// Safely unload to prevent memory leak.
			FreeImage.UnloadEx(ref dib);

			// Load the example bitmap.
			dib = FreeImage.LoadEx(fileName);

			// Check whether loading succeeded.
			if (dib.IsNull)
			{
				return;
			}

			// Add this class to the callback event.
			FreeImageEngine.Message += new OutputMessageFunction(FreeImage_Message);

			// Try to save the bitmap as a gif
			if (!FreeImage.Save(FREE_IMAGE_FORMAT.FIF_GIF, dib, @"Sample_fail.gif", FREE_IMAGE_SAVE_FLAGS.DEFAULT))
			{
				// Saving failed
				// Check whether there was an error callback
				if (message != null)
				{
					// Print the message and delete it.
					Console.WriteLine("Error message recieved: {0}", message);
					message = null;
				}
			}

			// Unload bitmap.
			FreeImage.UnloadEx(ref dib);

			// Remove this class from the callback event.
			FreeImageEngine.Message -= new OutputMessageFunction(FreeImage_Message);
		}

		void FreeImage_Message(FREE_IMAGE_FORMAT fif, string message)
		{
			this.message = message;
		}
	}
}