1
Refs

You need to add a reference to ImageGlue from your Visual Studio Project. This tells Visual Studio to link the ImageGlue assembly into the build.

Typically you will do this by referencing the ImageGlue NuGet package. Right click on 'Dependencies' and then select the 'Manage NuGet Packages...' item, click on "Browse" and search for "ImageGlue - you should see ImageGlue amongst the results from NuGet.org.


If you have run the full MSI installer, ImageGlue is placed in the GAC, so under .NET 4 you can add a reference simply by looking in the 'Assemblies > Extensions' section of the Reference Manager. Just right click on 'References' in your project and 'Add Reference' - you'll see "ImageGlue .NET" near the top of the extensions list. .NET 5 does not have a GAC, so while you can add it by browsing to the DLL in the ImageGlue installation folder, it is probably easier to add a NuGet reference.


If you are using .NET 5.0 your project target is "net5.0" however since ImageGlue makes use of Windows specific features, more commonly you will target "net5.0-windows". If you are using .NET Classic then your target will be "v4.0" or later.

Under .NET 5.0 you may also need to reference the Microsoft "System.Configuration.ConfigurationManager" NuGet package as available on NuGet.org. If you cannot see ABCpdf after referencing it then check that your Build Target is .NET 5.0 and not one of the older .NET Core variants.

You can mix and match the full MSI installer with the NuGet packages. If you reference a different NuGet version in your project then that version, rather than the MSI installed version, is the one that will be used. Be careful as it can be confusing if you have multiple different versions of ImageGlue in use.

If you are not using Visual Studio, you will need to consult the documentation for your chosen development environment.

2
Names

There is one public namespace in ImageGlue 8. You can reference it using the following directives:

[C#]

                        using WebSupergoo.ImageGlue8;


3
Example

This is some simple example code which reports the ImageGlue Version.

[C#]

                        Response.Write("License: " + XSettings.Version);


4
Assemblies and DLLs

ImageGlue .NET is made up of two components.

ImageGlue8-32.DLL and ImageGlue8-64.DLL are the core engines: they contain the core graphic manipulation code.

ImageGlue.DLL and ImageGlue.NET5.DLL are the .NET tiers. The former is used by .NET 4.X and the latter by .NET 5.0. The .NET tier comprises the visible interface and less speed critical code. When the assembly is loaded it locates and loads the core engine establishing a direct high speed link between the two components.

The .NET tier is placed in the GAC and is available via NuGet so that you can reference ImageGlue .NET from any of your projects. However should you require it you can always copy the DLLs to the bin directory of your application.

5
Security

ASP.NET operates under a restricted set of security permissions. It is quite common for the ASPNET user not to be able to create or write files.

So if you want to save a file from your IIS or ASP.NET code you may need to adjust the permissions on your destination directory. Typically you will need to allow write access for the user associated with your application pool.