Changes from Version 17 to Version 17.5

Version 17.5 of this C API has changed from version 17 as follows:

Removed functions:

L_UnlockSupport has been removed and replaced with L_SetLicenseFile and L_SetLicenseBuffer .

L_SetDJVOptions

L_GetDJVOptions

Changed functions:

L_GetBitmapHistogram: The type of pHisto parameter has been changed from L_UINT32 to L_UINT64.

L_AutoZoneBitmap A flag has been added to uFlags (AUTOZONE_TEXT_DETECTION) that causes the function to modify the original bitmap so that all it contains is text. For this reason, if you set the flag be sure to make a copy of the original bitmap if you want to keep it.

Changed structures:

RASTERIZEDOCOPTIONS bEnabled member was removed, see Changes to options for rasterizing document format below.

FILEPDFOPTIONS nXResolution and nYResolution members were removed, see Changes to options for rasterizing document format below.

FILEXPSOPTIONS nXResolution and nYResolution members were removed, see Changes to options for rasterizing document format below.

FILETXTOPTIONS dLeftMarg, dTopMarg, dRightMarg, dBottomMarg, dPaperWidth and dPaperHeight members were removed, see Changes to options for rasterizing document format below.

FILERTFOPTIONS dLeftMarg, dTopMarg, dRightMarg, dBottomMarg, dPaperWidth, dPaperHeight, nXResolution and nYResolution members were removed, see Changes to options for rasterizing document format below.

STATISTICSINFO: The types of uPixelCnt and uTotalPixelCnt members have been changed from L_UINT to L_UINT64.

PAINTCALLBACKDATA pFillRect member added.

New structures

PRNJOBDATA

VEC2DOPTIONS

VECTOROPTIONS

VECTORVIEWMODE

VECTORPARALLELOGRAM

New functions:

L_DeleteComment

L_GetBitmapColorType - used to obtain the type of the image and whether it's black and white, colored or grayscale, along with the confidence level.

L_KernelHasExpired

L_SetLicenseFile - used to set a runtime license for LEADTOOLS.

L_SetLicenseBuffer - used to set a runtime license for LEADTOOLS.

L_PrnClntSetPrinterConnectionDll

L_PrnIsNetworkPrintingEnabled

L_PrnClntPrintJob

L_PrnClntShutdown

L_PrnClntStartup

L_PrnGetNetworkInitialData

L_PrnGetRemoteData

L_PrnSetEnableNetworkPrinting

L_PrnSetNetworkInitialData

L_PrnGetEmbeddedFonts

L_PrnSetPrinterSpecifications

L_PrnGetPrinterSpecifications

L_PrnSetUserDefaultPrinterSpecifications

L_PrnGetUserDefaultPrinterSpecifications

L_AnnLoadMulti

L_AnnLoadMultiOffset

L_AnnSaveMulti

L_AnnSaveMultiOffset

L_GetVectorOptions

L_SetVectorOptions

l_Setlocale

L_ConvertFromEMF2

Changes to options for rasterizing document formats:

In LEADTOOLS 17.5, the RASTERIZEDOCOPTIONS structure is used exclusively to determine and calculate the page size, resolution and margins (rasterization) when loading document file formats that do not have physical size as a raster image. These file formats are listed in the table below:

LEADTOOLS Format Identifier

Description

FILE_RAS_PDF

Portable Document Format (PDF)

FILE_POSTSCRIPT

Postscript Document Format

FILE_EPS and FILE_EPSPOSTSCRIPT

Encapsulated PostScript

FILE_XPS

XML Paper Specification

FILE_TXT

ASCII Text Files

FILE_RTF_RASTER

Rich Text Format

FILE_DOC

Microsoft Word 97-2013 Document Format

FILE_DOCX

Microsoft Word Document Format

FILE_XLS

Microsoft Excel 97-2003 Spreadsheet Format

FILE_XLSX

Microsoft Excel Spreadsheet Format

FILE_PPT

Microsoft PowerPoint 97-2003 Presentation Format

FILE_PPTX

Microsoft PowerPoint Presentation Format

In previous versions of LEADTOOLS, the options to control the rasterization process have been consolidated into the RASTERIZEDOCOPTIONS structure and old structure members were deprecated. In 17.5, these deprecated members are removed from the toolkit. The following table lists the removed members and their replacements:

Removed Member

Replacement

RASTERIZEDOCOPTIONS.bEnabled

None.

This has been removed and RASTERIZEDOCOPTIONS is always used when rasterizing document files (the equivalent RASTERIZEDOCOPTIONS.Enabled = true in previous versions of LEADTOOLS)

FILEPDFOPTIONS.nXResolution and FILEPDFOPTIONS.nYResolution

RASTERIZEDOCOPTIONS.uXResolution and RASTERIZEDOCOPTIONS.uYResolution

FILEXPSOPTIONS.nXResolution and FILEXPSOPTIONS.nYResolution

RASTERIZEDOCOPTIONS.uXResolution and RASTERIZEDOCOPTIONS.uYResolution

FILETXTOPTIONS.dLeftMarg, FILETXTOPTIONS.dTopMarg, FILETXTOPTIONS.dRightMarg, FILETXTOPTIONS.dBottomMarg,
FILETXTOPTIONS.dPaperWidth and FILETXTOPTIONS.dPaperHeight

RASTERIZEDOCOPTIONS.dLeftMargin, RASTERIZEDOCOPTIONS.dTopMargin, RASTERIZEDOCOPTIONS.dRightMargin, RASTERIZEDOCOPTIONS.dBottomMargin,
RASTERIZEDOCOPTIONS.dPageWidth and RASTERIZEDOCOPTIONS.dPageHeight

FILERTFOPTIONS.dLeftMarg, FILERTFOPTIONS.dTopMarg, FILERTFOPTIONS.dRightMarg, FILERTFOPTIONS.dBottomMarg,
FILERTFOPTIONS.dPaperWidth and FILERTFOPTIONS.dPaperHeight FILERTFOPTIONS.nXResolution and FILERTFOPTIONS.nYResolution

RASTERIZEDOCOPTIONS.dLeftMargin, RASTERIZEDOCOPTIONS.dTopMargin, RASTERIZEDOCOPTIONS.dRightMargin, RASTERIZEDOCOPTIONS.dBottomMargin,
RASTERIZEDOCOPTIONS.dPageWidth,
RASTERIZEDOCOPTIONS.dPageHeight,
RASTERIZEDOCOPTIONS.uXResolution and RASTERIZEDOCOPTIONS.uYResolution

As well as the changes listed above, note that the following members contain updated default values:

Member

Old Value

New Value

Notes

RASTERIZEDOCOPTIONS.uXResolution and RASTERIZEDOCOPTIONS.uYResolution

0, 0

150, 150

In previous versions of LEADTOOLS, a value of 0 was used for these members to instruct the toolkit to load the documents using the current screen resolution. This proved to be not an optimal solution since the result document will almost always be loaded using a small resolution (such as 96 DPI) that is unsuitable for detailed viewing or OCRing.

The new default of 150 by 150 DPI results in documents loaded at a higher detailed resolution.

FILEPDFOPTIONS.nDisplayDepth

24

0

In previous versions of LEADTOOLS, PDF documents were rasterized at 24 BPP by default regardless of the number of colors in the original document. The new default value of 0 instructs LEADTOOLS to auto-detect the best bits/pixel value to use when loading a PDF file, hence, a black/white PDF file will be loaded at 1BPP by default resulting in a much less memory being used.

New and enhanced file format support:

What's New in Version 17.5

Help Version 19.0.2017.10.27
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS Raster Imaging C API Help