Integrate into the .NET Framework
System Requirements
GdPicture.NET assemblies are available for the following frameworks and operating systems:
| Framework | Supported Operating Systems |
|---|---|
| .NET 6.0 or newer | Linux x64 * Linux arm64 * Microsoft Windows 7 SP1 (x64/x86) or newer Microsoft Windows Server Core 2012 (x64) or newer macOS 13 |
| .NET 4.5 | Microsoft Windows Vista (x64/x86) or newer Microsoft Windows Server 2008 (x64/x86) or newer |
| .NET Core 3.1 | Microsoft Windows Vista (x64/x86) or newer Microsoft Windows Server 2008 (x64/x86) or newer |
| COM/ActiveX | Microsoft Windows Vista (x64/x86) or newer Microsoft Windows Server 2008 (x64/x86) or newer |
* The .NET 6.0 assembly on Linux requires GLIBC 2.29 or newer.
All GdPicture.NET versions are compiled using the AnyCPU platform target.
Installing
Once downloaded, follow the installation wizard, which will guide you through the installation process.
It’s recommended to install the toolkit in a destination such as D:\GdPicture.NET\ or C:\GdPicture.NET\.
Trial Version
The trial license lets you try the GdPicture.NET software package for free for 60 days. This includes full access and technical support.
How to Obtain a Trial License Key
To obtain your key, follow these steps:
-
Go to the folder where you installed GdPicture.NET.
-
Run
licenseManager.exe. -
Click Request a trial key.
-
Fill in the required fields, and then press Send Request.
You’ll receive a trial key by email.
If you don’t immediately receive a key via email, or if the application can’t be run on a system that allows web requests, contact our Sales team.
-
Back in the License Manager, click the Register a key button and enter the trial key you received in your email.
Activating a Commercial License
To get a commercial license, contact our Sales team. They’ll guide you in determining what type of license to get based on your requirements. The commercial license will then be available in the Customer Portal.
A standard commercial license allows you to upgrade the GdPicture license for one year. After that, you won’t have access to any future GdPicture features. To get them, contact our Sales team to renew your license. The renewed license will also be available in the Customer Portal.
If you don’t activate your license key properly, you’ll see an error message like the one below.
Activation is mandatory for several reasons: It binds the license key to the developer, automatically creates their account for technical support, assigns the relevant service-level agreement (SLA), and allows development.
Activation requires access to ORPALIS servers. If your company has a mandatory proxy to access the internet, please configure it in the Proxy Settings menu before trying to activate your license key.
The licenseManager.exe Application
You’ll find the activation application (licenseManager.exe) in the installation folder of the SDK.
-
You need to launch it using administrator privileges.
-
When starting, the license key and license type will be
#undefined#, so you’ll need to register a key. Click the Register a key button to access the registration form.
-
Enter your personal information in the fields. Be sure to enter a valid email address you have access to, because you’ll use it for technical support.
-
Once you’ve entered your information, click Register.
When your license key is successfully activated, instead of #undefined#, you’ll see the key, along with its type, in the licenseManager.exe application main window.
Unlocking GdPicture.NET
Unlocking the GdPicture.NET toolkit is done via code in your application.
First, create a LicenseManager object. Then, call the RegisterKEY() method with the license key you own.
Do this when loading your application, before you use any of the functions or features of the GdPicture.NET toolkit.
If your key is a trial license key, all the features of GdPicture will be activated.
Here’s how to use your license key:
// Creating a `LicenseManager` object. LicenseManager oLicenseManager = new LicenseManager(); oLicenseManager.RegisterKEY("LICENSE_KEY");
'Creating a `LicenseManager` object. Dim oLicenseManager As New LicenseManager oLicenseManager.RegisterKEY("LICENSE_KEY")
CLicenseManager oLicenseManager; oLicenseManager.CreateDispatch(L"GdPicture14.LicenseManager"); oLicenseManager.RegisterKEY(L"LICENSE_KEY");
BSTR bstrLicense = ::SysAllocString(L"LICENSE_KEY"); if (bstrLicense != NULL) { _LicenseManagerPtr oLicenseManager(__uuidof(LicenseManager)); VARIANT_BOOL result = oLicenseManager->RegisterKEY(bstrLicense); ::SysFreeString(bstrLicense); }
BSTR bstrLicense = ::SysAllocString(L"LICENSE_KEY"); if (bstrLicense != NULL) { _LicenseManagerPtr oLicenseManager; oLicenseManager = (_LicenseManagerPtr)CreateComObject(CLSID_LicenseManager); oLicenseManager->RegisterKEY(bstrLicense); ::SysFreeString(bstrLicense); bstrLicense = NULL; }
var LicenseManager1: Variant; begin LicenseManager1 := CreateOleObject('GdPicture14.LicenseManager'); LicenseManager1.RegisterKey('LICENSE_KEY');
var oLicenseManager; oLicenseManager = new ActiveXObject("GdPicture14.LicenseManager"); oLicenseManager.RegisterKey("LICENSE_KEY");
long ll_result OLEObject oLicenseManager oLicenseManager = CREATE OLEObject ll_result = oLicenseManager.ConnectToNewObject("GdPicture14.LicenseManager") oLicenseManager.RegisterKey("LICENSE_KEY")
Dim oLicenseManager As New LicenseManager Call oLicenseManager.RegisterKEY("LICENSE_KEY")
Dim oLicenseManager As New GdPicture_NET_14.LicenseManager oLicenseManager.RegisterKey ("LICENSE_KEY")
Your First Application Using .NET
After installation, look at the code samples to see some examples of how GdPicture.NET is used.
Adding GdPicture.NET to Your Application
To use GdPicture.NET in your application, choose one of the following methods:
-
Install GdPicture.NET using the NuGet Package Manager.
-
Add a reference to the DLL library.
Installing GdPicture.NET with NuGet
-
In Visual Studio, create a new project using your preferred programming language.
-
Select Project > Manage NuGet Packages….
-
Choose nuget.org in the Package source field.
-
Click Browse, and then search for GdPicture (without any suffixes).
-
Select it, and then click Install.
Adding a Reference to the GdPicture.NET Library
-
In Visual Studio, create a new project using your preferred programming language.
-
Select Project > Add Project Reference….
-
Click Browse…, and then select the
GdPicture.NET.14.dllfile within the[INSTALLATION FOLDER]\Redist\GdPicture.NET (.NET Framework 4.5)\GdPicture.NET.14.dllfolder. -
Add a link to the GdPicture namespace where you use the DLL:
-
In C#, add the appropriate
usingdirective to the code files where you use the DLL (using GdPicture14). -
In VB.NET, add the appropriate
Importsdirective to the code files where you use the DLL (Imports GdPicture14).
-
