In This Topic ▼

LBase::LoadLibraries

Summary

Loads a specific set of the LEADTOOLS library DLLs at run-time.

Syntax

#include "ltwrappr.h"

static L_UINT32 LBase::LoadLibraries (uLibraries, uSubLibraries = LT_ALL_DLG)

Parameters

L_UINT32 uLibraries

Flag that indicates which LEADTOOLS library DLLs to load. Possible values are given below, and may be combined.

Value	Meaning
LT_KRN	load the Ltkrnu.dll (Win32), Ltkrnx.dll (x64).
LT_DIS	load the Ltdisu.dll (Win32), Ltdisx.dll (x64).
LT_FIL	load the Ltfilu.dll (Win32), Ltfilx.dll (x64).
LT_IMG	load the ltimg??u.dll for Win32 or ltimgxx?.dll for X64.
LT_EFX	load the Ltefxu.dll (Win32), Ltefxx.dll (x64).
LT_DLG	load the ltdlg??u.dll for Win32 or ltdlgxx?.dll for X64.
LT_TWN	load the Lttwnu.dll (Win32), Lttwnx.dll (x64).
LT_SCR	load the Ltscru.dll (Win32), Ltscrx.dll (x64).
LT_ANN	load the Ltannu.dll (Win32), Ltannx.dll (x64).
LT_NET	load the ltnet??u.dll for Win32 or ltnetxx?.dll for X64.
LV_KRN	load the Ltvkrnu.dll (Win32), Ltvkrnx.dll (x64).
LV_DLG	load the LtVdlgu.dll (Win32), LtVdlgx.dll (x64).
LT_TMB	load the Lttmbu.dll (Win32), Lttmbx.dll (x64).
LT_LST	load the Ltlstu.dll (Win32), Ltlstx.dll (x64).
LT_BAR	load the ltbar??u.dll for Win32 or ltbarxx?.dll for X64.
LT_ZMV	load the Ltzmvu.dll (Win32), Ltzmvx.dll (x64).
LT_IMGOPT	load the Ltimgoptu.dll (Win32), Ltimgoptx.dll (x64).
LT_ALL_LEADLIB	load all available LEADTOOLS libraries

These values can be combined using the bitwise OR operator ( | ).

L_UINT32 uSubLibraries

Flag that indicates which LEADTOOLS dialog library DLLs to load, this value is only valid if uLibraries contains LT_DLG. Possible values are given below, and may be combined.

Value	Meaning
LT_DLGIMGEFX	load the Ltdlgimgefxu.dll (Win32), Ltdlgimgefxx.dll (x64).
LT_DLGEFX	load the Ltdlgefxu.dll (Win32), Ltdlgefxx.dll (x64).
LT_DLGFILE	load the Ltdlgfileu.dll (Win32), Ltdlgfilex.dll (x64).
LT_DLGIMG	load the Ltdlgimgu.dll (Win32), Ltdlgimgx.dll (x64).
LT_DLGIMGDOC	load the Ltdlgimgdocu.dll (Win32), Ltdlgimgdocx.dll (x64).
LT_DLGCLR	load the Ltdlgclru.dll (Win32), Ltdlgclrx.dll (x64).
LT_DLGKRN	load the Ltdlgkrnu.dll (Win32), Ltdlgkrnx.dll (x64).
LT_DLGWEB	load the Ltdlgwebu.dll (Win32), Ltdlgwebx.dll (x64).
LT_ALL_DLG	load all available LEADTOOLS dialogs libraries

These values can be combined using the bitwise OR operator ( | ).

Returns

An L_UINT32 value representing the LEADTOOLS libraries that were loaded successfully. This can be any combination of the constants described above.

Comments

Call this function to load a specific set of the LEADTOOLS library DLLs at run-time. The specified constants will determine which libraries you want to load. If the library is already loaded then this function will not load it again. You can use this function to minimize the memory footprint of your program by loading and unloading the libraries you need when necessary.

Note: if you use LT_DLG in the uLibraries parameter without passing any flag in uSubLibraries, all LEAD dialogs will be loaded by default.

Call this function (LBase::LoadLibraries(LT_KRN) before calling LSettings::SetLicenseFile or LSettings::SetLicenseBuffer.

Required DLLs and Libraries

LTKRN
For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64.

Example

The following code will load the LEADTOOLS library for the TWAIN scanner
driver (assuming that ltkrnXXn.dll is already loaded), and scan an image
to a bitmap:

L_INT LBase__LoadLibrariesExample() 
{ 
 
	LTwain MyTWAIN; 
	LBitmapBase MyBitmap; 
 
	if(LBase::LoadLibraries(LT_TWN)& LT_TWN) 
	{ 
		MyTWAIN.SetBitmap(&MyBitmap); 
		MyTWAIN.Acquire  ((LBitmap*)NULL,0,0,NULL); 
		LBase::UnloadLibraries(LT_TWN); 
	} 
	return SUCCESS; 
}