Changes from Version 17 to Version 17.5

Version 17.5 of this C++ Class Library 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 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, 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

Removed Functions

LSettings::UnlockSupport has been removed and replaced with LSettings::SetLicenseFile and LSettings::SetLicenseBuffer.

Changed Functions

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

LBitmap::AutoZone 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.

New Functions

LBase::KernelHasExpired

LSettings::SetLicenseFile - used to set a runtime license for LEADTOOLS.

LSettings::SetLicenseBuffer - used to set a runtime license for LEADTOOLS.

LAnimationWindow::PlayProcessing (hWnd, bLoop)

LAnnLine::GetPointCount

LAnnLine::GetPoints

LAnnLine::SetPoints

LBitmap::CountLUTColorsExt

LBitmap::WindowLevelBitmapExt

LBitmap::WindowLevelExt

LBitmap::WindowLevelFillLUTExt

LBuffer::ConvertBufferExt

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++ Class Library Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.