Changes from Version 17 to Version 17.5

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

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 RASTERIZEDOCOPTIONS.uXResolution
FILEPDFOPTIONS.nYResolution RASTERIZEDOCOPTIONS.uYResolution
FILEXPSOPTIONS.nXResolution RASTERIZEDOCOPTIONS.uXResolution
FILEXPSOPTIONS.nYResolution RASTERIZEDOCOPTIONS.uYResolution
FILETXTOPTIONS.dLeftMarg RASTERIZEDOCOPTIONS.dLeftMargin
FILETXTOPTIONS.dTopMarg RASTERIZEDOCOPTIONS.dTopMargin
FILETXTOPTIONS.dRightMarg RASTERIZEDOCOPTIONS.dRightMargin
FILETXTOPTIONS.dBottomMarg RASTERIZEDOCOPTIONS.dBottomMargin
FILETXTOPTIONS.dPaperWidth RASTERIZEDOCOPTIONS.dPageWidth
FILETXTOPTIONS.dPaperHeight RASTERIZEDOCOPTIONS.dPageHeight
FILERTFOPTIONS.dLeftMarg RASTERIZEDOCOPTIONS.dLeftMargin
FILERTFOPTIONS.dTopMarg RASTERIZEDOCOPTIONS.dTopMargin
FILERTFOPTIONS.dRightMarg RASTERIZEDOCOPTIONS.dRightMargin
FILERTFOPTIONS.dBottomMarg RASTERIZEDOCOPTIONS.dBottomMargin
FILERTFOPTIONS.dPaperWidth RASTERIZEDOCOPTIONS.dPageWidth
FILERTFOPTIONS.dPaperHeight RASTERIZEDOCOPTIONS.dPageHeight
FILERTFOPTIONS.nXResolution RASTERIZEDOCOPTIONS.uXResolution
FILERTFOPTIONS.nYResolution 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
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

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 if it is 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

For more information, refer to:

What's New in Version 17.5

Help Version 23.0.2024.2.29
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Raster Imaging C API Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.