*******************************************************************************
MARBLECORE IMAGING CLASS LIBRARY FOR .NET
*******************************************************************************

The Marblecore Imaging Class Library is a .NET wrapper for the Marblecore
Imaging component. Using the Class Library you can implement Marblecore Imaging
in your .NET enabled applications. You can use any .NET programming language
you want, like C#, Visual Basic and J#. The library is very easy to use and
well documented.

-------------------------------------------------------------------------------
HOW TO USE
-------------------------------------------------------------------------------

To implement the Marblecore Imaging Class Library follow these easy steps. It
will add the Marblecore Class Library to your project (if you want to add the
library to your GAC, scroll down for more information).

1. Add the Class Library to your .NET project. In Visual Studio this is done by
selecting the 'References' node in the document tree at the left. Right click
'References' and choose 'Add reference'. Go to the 'Browse' tab and select the
file MarblecoreImagingCL.dll. The library is now added to your project.

2. Include the Marblecore namespace in the appropriate source code files (where
you want to use Marblecore Imaging) by adding the following code at the top
section:
 
using Marblecore;

For more information on programming with the library go to:
http://www.marblecore.com/documentation/imaging/gettingstarted/classlibrary/

-------------------------------------------------------------------------------
ADDING MARBLECORE IMAGING TO YOUR GLOBAL ASSEMBLY CACHE
-------------------------------------------------------------------------------

If you want to install the Class Library to your Global Assembly Cache (GAC)
you can do that by executing the following command:
  
gacutil /i MarblecoreImagingCL.dll

-------------------------------------------------------------------------------
CHOOSE THE RIGHT VERSION
-------------------------------------------------------------------------------
 
The installation package includes 3 versions of the Class Library. A standard
32-bit version (MarblecoreImagingCL.dll) which can be used on all systems. A
64-bit version (MarblecoreImagingCL.x64.dll) which is optimized for x64 based
systems. And an IA-64-bit version (MarblecoreImagingCL.ia64.dll) which is
optimized for Itanium based systems.

-------------------------------------------------------------------------------
OPTIMIZED FOR 64-BIT SYSTEMS
-------------------------------------------------------------------------------

The Marblecore Imaging Library uses native code for the actual image processing
to maximize the speed of the library and utilize the system resources as
optimal as possible. If you are targeting your application for 64-bit
deployment, you can use the 64-bit versions of the Class Library. These
libraries maximize the performance on 64-bit based systems. There are two
versions available. A normal 64-bit version (MarblecoreImagingCL.x64.dll) and
an Itanium 64-bit version (MarblecoreImagingCL.ia64.dll). They work identical as
the normal Class Library and are fully interchangeable.

-------------------------------------------------------------------------------
REQUIREMENTS
-------------------------------------------------------------------------------

The latest version of the Microsoft Visual C++ Redistributable Package needs to
be installed. If the Class Library does not work, please download the following
update from the Microsoft download website:
http://www.microsoft.com/download/en/details.aspx?id=26347.

Install the following update:
- For the standard 32-bit version: vcredist_x86.exe
- For the 64-bit optimized version: vcredist_x64.exe
- For the Itanium 64-bit optimized: vcredist_IA64.exe

-------------------------------------------------------------------------------
KNOWN ISSUES
-------------------------------------------------------------------------------
 
In some cases the Class Library will not work, because some files on your
computer are outdated or unpatched. The library depends on these files and you
need to install an update of the Microsoft Visual C++ Redistributable Package.
This package can be downloaded from:
http://www.microsoft.com/download/en/details.aspx?id=26347

For your convenience this update is already included in the Marblecore Imaging
Class Library download package (vcredist_x86.exe, vcredist_x64.exe and
vcredist_IA64.exe). Please install the right version for the system
architecture you use (32-bit, 64-bit or Itanium 64-bit). If you use the normal
32-bit version of the Class Library on a 64-bit system, you need to install
the 32-bit x86 package (vcredist_x86.exe). You can install different
architecture versions of the redistributable package on the same system without
any problems.