TBarCode SDK

Licensing Within Program Code

The licensing procedure for developers is as follows:

Call the LicenseMe() method from within your application each time when your program is getting started. This has to be done before you draw a barcode!

For users of an ActiveX^® Control: when you call the LicenseMe() method you should take care that an instance of the control has been created (e.g. within load event of a form), otherwise you have to create an object.

Sample for licensing TBarCode OCX in VB:

Private Sub Form_Load()
TBarCode111.LicenseMe "Mem: LicenseeInfo", 
          eLicKindDeveloper, 1, "MyLicKey", TBarCode11Lib.eLicProd2D
End Sub

Sample for licensing TBarCode DLL in VC++:

BCLicenseMe ("Licensee", eLicKindDeveloper, 1,"YourKey", eLicProd2D);
// for enumerations refer to the file TECBCEnum.h

For exact functions and parameters see the TBarCode DLL/Library API reference.

Sample for licensing TBarCode .NET in C#:

Barcode myBarcode = new Barcode();
myBarcode.License ("YourLicensee", LicenseType.DeveloperOrWeb, 1,
                   "YourKey", TBarCodeProduct.Barcode2D)

For exact methods and parameters see the TBarCode .NET API reference.

More info about licensing can be found in the product documentation available in the Download Area of this site.

Licensing via INI File

For server licenses the demo version can also be unlocked afterwards using an INI file (barcode.ini) - no change to your program code is required. Please request the INI file from our support.

TFORMer SDK V9

As of TFORMer SDK V9 the license key consists of a set of license data. You receive this data from TEC-IT by email:

Licensing must be applied before the first output-generating call (e.g. Print) - ideally right after loading the SDK.

The three licensing methods

• License parameters - all seven values are passed individually to License(..). This is the default case, including redistribution within your own applications (developer license).
• Base64 string - all license data in a single string, passed to LicenseBase64(..). Convenient for compact licensing in program code, for configuration variables and for container or CI environments. The base64 value is the OASLicense field of the INI license file.
• INI file - the license data is stored in TFORMer.ini, provided by TEC-IT on request. Useful for licensing an already installed environment afterwards, in particular for server licenses where changing the program code is not an option.

Important: treat your license data as confidential. When you ship applications to customers, license via program code only (license parameters or base64 string) and protect the key inside your code. Never redistribute your INI file.

TFORMer .NET

using TECIT.TFORMer;

// Method 1 - license parameters
TFORMer.License(
    "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",  // Activation Key
    "Your Company, AT-4400",             // Licensee
    LicenseKind.Server,                  // License Kind
    2,                                   // License Count
    "noSID",                             // Options
    "20270708",                          // Expiration Date
    "BjAyLjAxOgia...");                  // Signature

// Method 2 - base64 string
TFORMer.LicenseBase64("BjAyLjAxOgia...");

// Method 3 - INI file
TFORMer.LicenseFile(@"C:\ProgramData\TEC-IT\TFORMer\9\TFORMer.ini");

For exact methods and parameters see the TFORMer .NET API reference.

TFORMer DLL / Shared Library

/* Method 1 - license parameters */
TFormer_License(
    "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",  /* Activation Key  */
    "Your Company, AT-4400",             /* Licensee        */
    LICKIND_SERVER,                      /* License Kind    */
    2,                                   /* License Count   */
    "noSID",                             /* Options         */
    "20270708",                          /* Expiration Date */
    "BjAyLjAxOgia...");                  /* Signature       */

/* Method 2 - base64 string */
TFormer_LicenseBase64("BjAyLjAxOgia...");

/* Method 3 - INI file */
TFormer_LicenseFile("/usr/local/share/TFORMer9/TFORMer.ini");

For exact functions and parameters see the TFORMer DLL/Library API reference.

TFORMer COM components

Dim objTFormer As New TFORMer

objTFormer.License "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA", _
                   "Your Company, AT-4400", _
                   LicenseKind_Server, 2, "noSID", _
                   "20270708", "BjAyLjAxOgia..."

TFPrint (command line)

The parameter -L accepts all three methods:

tfprint -L ActivationKey Licensee LicenseKind LicenseCount Options ExpirationDate Signature
tfprint -L b64:BASE64DATA
tfprint -L file:PATH-TO-INI-FILE

When passing the parameters, keep them in the correct order and quote values containing spaces - typically the licensee name. For the license kind, use one of the following keywords: Single, Workgroup, Office, Site, Developer, Server.

tfprint -L AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA "Your Company, AT-4400" Server 2 noSID 20270708 BjAyLjAxOgia... -f Label.tfr -o Label.pdf

If the installation is already licensed via an INI file, you can omit -L entirely.

Licensing via the INI file (TFORMer.ini)

Copy the file TFORMer.ini into one of the following directories. They are searched in this order:

• Directory of the application module
• TFORMer runtime directory - on Windows C:\Program Files\TEC-IT\TFORMer9 SDK\Bin, on Linux/UNIX /usr/local/share/TFORMer9
• ProgramData directory C:\ProgramData\TEC-IT\TFORMer\9

Do not redistribute: the INI file contains your complete license data. Never ship it with applications delivered to customers - license via program code there.

License data no longer available?

If you no longer have your license data, or if you need it as an INI file, please contact support@tec-it.com.