Foxit PDF SDK Changelog

Windows/Mac/Linux

April 3, 2026

Breaking Changes

The following changes require code updates when upgrading from v11.0. Existing projects that use these APIs will not compile or may behave differently without modification.

ActionCallback — Parameter change and new pure virtual methods

The ActionCallback class has 1 parameter change and 7 new pure virtual methods. Any subclass must be updated.

Parameter change — GetPageWindowRect now requires document and page_index parameters:

// v11.0
virtual RectF GetPageWindowRect() = 0;

// v11.1
virtual RectF GetPageWindowRect(const foxit::pdf::PDFDoc& document, int page_index) = 0;

New pure virtual methods — implement with empty bodies if the functionality is not needed:

virtual void NotifyBeginDoJob(const pdf::PDFDoc& document,
    JavascriptModifyItemInfo::JavascriptEventType event_type) = 0;
virtual void NotifyAfterDataChange(const pdf::PDFDoc& document,
    JavascriptModifyItemInfo modify_item_info) = 0;
virtual void NotifyEndDoJob(const pdf::PDFDoc& document,
    JavascriptModifyItemInfo::JavascriptEventType event_type) = 0;
virtual bool InitModifyItem(const pdf::PDFDoc& document,
    ModifyItemType item_type, int page_index, const WString& dict_name) = 0;
virtual void ResetModifyItem(const pdf::PDFDoc& document) = 0;
virtual int GetVisiblePageCount(const pdf::PDFDoc& document) = 0;
virtual int GetVisiblePage(const pdf::PDFDoc& document, int index) = 0;

DocProviderCallback — New pure virtual method (XFA)

A new pure virtual method is added. Subclasses of DocProviderCallback must implement it:

virtual void NotifyWidgetChangeInfo(const XFADoc& doc, XFAWidgetModifyInfo change_info) = 0;

This only affects projects that use the XFA module. Implement with an empty body if not needed.

IconProviderCallback::GetIcon — Parameter change (silent)

The GetIcon method has changed. This is not a pure virtual, so compilation will succeed, but existing overrides will silently stop being called:

// v11.0
virtual PDFPage GetIcon(Annot::Type annot_type, const char* icon_name, ARGB color);

// v11.1
virtual PDFPage GetIcon(Annot::Type annot_type, const char* icon_name, ARGB color,
                        foxit::pdf::objects::PDFDictionary* annot_dict);

Action required: Update the override to include the new annot_dict parameter. Enable -Woverloaded-virtual (GCC/Clang) or /W4 (MSVC) to detect this at compile time.

OCRCallback — New pure virtual method

A new pure virtual method IsImageIgnored is added to the existing OCRCallback class:

// v11.0
class OCRCallback {
  virtual bool NeedToCancelNow(const wchar_t* info) = 0;
};

// v11.1
class OCRCallback {
  virtual bool NeedToCancelNow(const wchar_t* info) = 0;
  virtual bool IsImageIgnored(foxit::pdf::graphics::ImageObject* image_object) = 0; // NEW
};

Action required: All subclasses of OCRCallback must implement IsImageIgnored. Return false to preserve previous behavior (no images ignored).

OCRConfig constructor and Set() — Parameter change

The parameterized constructor and Set() method gained 3 new required parameters:

// v11.0 (5 parameters)
OCRConfig(bool is_detect_pictures, bool is_remove_noise, bool is_correct_skew,
          bool is_enable_text_extraction_mode, bool is_sequentially_process);

// v11.1 (8 parameters)
OCRConfig(bool is_detect_pictures, bool is_remove_noise, bool is_correct_skew,
          bool is_enable_text_extraction_mode, bool is_sequentially_process,
          bool is_auto_overwrite_resolution, int resolution_to_overwrite, int confidence);

Action required: Add the 3 new parameters. Use true, 300, 0 for default-equivalent behavior. Alternatively, use the default constructor which initializes all fields with defaults.

OCR::OCRPDFPage / OCRPDFDocument / OCRConvertTo / OCRPDFDocuments — New parameter

All OCR processing methods add an OCRProgressCallback* parameter:

// v11.0
void OCRPDFPage(PDFPage pdf_page, bool is_editable);
void OCRPDFPage(PDFPage pdf_page, bool is_editable, const OCRConfig& config);
// ... same pattern for OCRPDFDocument, OCRConvertTo, OCRPDFDocuments

// v11.1
void OCRPDFPage(PDFPage pdf_page, bool is_editable, OCRProgressCallback* callback = NULL);
void OCRPDFPage(PDFPage pdf_page, bool is_editable, const OCRConfig& config, OCRProgressCallback* callback = NULL);
  • C++: Has default value NULL — existing calls compile without changes.
  • C# / Python / Java / Node.js / Go: Bindings do not inherit the C++ default value. Existing calls must add the new parameter explicitly (pass null / None / nil to preserve previous behavior).

PDF to Office — API parameter changes

The following conversion APIs have breaking changes in this release. For detailed migration guidance with code examples, see the Breaking Changes section in the Conversion SDK v3.1.0 Release Note (included in the Conversion SDK package).

  • PDF2WordSettingData — Add required parameter max_blank_paragraphs_per_page_bottom; default value of enable_generate_headers_and_footers changed from false to true
  • PDF2PowerPointSettingData — Add required parameter enable_adapt_to_largest_page
  • PDF2ExcelSettingData — Add required parameters enable_aggressive_table_repair and include_watermarks
  • PDF2OfficeSettingData — Add required parameter enable_matching_system_fonts
  • PDF-to-Word now preserves internal document navigation links by default

New Features and Enhancements

Platform

  • Add Node.js v21 and v22 support (extends previous v18-20 range)
  • Add Node.js macOS platform support

Conversion

  • Add WPS-powered Office-to-PDF conversion on Windows via Convert::FromWord/Excel/PowerPoint(..., e_Office2PdfEngineWps)
  • Add system font precise matching toggle for PDF-to-Word: PDF2OfficeSettingData::enable_matching_system_fonts
  • Update PDF-to-Word to preserve internal document navigation links by default
  • Add page size adaptation for PDF-to-PPT: PDF2PowerPointSettingData::enable_adapt_to_largest_page
  • Add PDF-to-Excel table repair and watermark output controls: PDF2ExcelSettingData::enable_aggressive_table_repair / include_watermarks
  • Add font embedding toggle for Linux Office2PDF: Office2PDFSettingData::is_embed_font
  • Add version query APIs: Office2PDF::GetVersion() / PDF2Office::GetVersion()
  • Update Office2PDF::ConvertFromWord to support DOC (Word 97-2003) format

OCR

  • Add progress callback via OCRProgressCallback class with ProgressNotify(int current_rate)
  • Add Arabic language support: OCREngine::SetLanguages("Arabic")
  • Add configuration parameters: OCRConfig::confidence (confidence threshold) and OCRConfig::resolution_to_overwrite (resolution override)
  • Add standalone command-line tool for multi-process parallel OCR: ocr_win64.exe / ocr_linux64
  • Add image filtering callback: OCRCallback::IsImageIgnored(ImageObject*)

Rendering

  • Add overprint rendering support: Renderer::SetOverprint(bool is_to_enable_overprint)

Security and Signature

  • Add pre-sign self-modification tracking callbacks in ActionCallback: InitModifyItem(), ResetModifyItem(), NotifyBeginDoJob(), NotifyAfterDataChange(), NotifyEndDoJob(); add DocProviderCallback::NotifyWidgetChangeInfo() for XFA widget change tracking
  • Add CertChainResolverCallback and TrustedCertStoreCallback for cross-CA LTV enablement in LTVVerifier
  • Add Redaction::EnableFileStream() to reduce memory peaks in high-redaction-volume scenarios via file stream

Forms and Annotation

  • Add 29 XFA event types to XFADoc::EventType for granular event handling (Click, Change, Enter, Exit, PreSign, PostSign, PreSave, PostSave, etc.)
  • Update IconProviderCallback::GetIcon with annot_dict parameter for annotation dictionary access

Document and Page

  • Update ActionCallback::GetPageWindowRect with document and page_index parameters for multi-page JS layer (OCG) control
  • Add ActionCallback::GetVisiblePageCount() and ActionCallback::GetVisiblePage() for querying visible pages in multi-page view
  • Add methods to remove PDF logical structure tags: PDFDoc::RemoveStructTree(), PDFStructTree::RemoveChild(), StructElement::RemoveChild()
  • Add Font::IsCharSupported(uint32 unicode, const PDFDoc& document) for character support detection
  • Add Library::AddExternalFontPath() and Library::MatchExternalFontsOnly() for external font path management

3D

  • Add PDF3DContext::Add3DAnnot() to insert 3D annotation on a specified page (file path and ReaderCallback modes)
  • Add 3D preset view and model tree interaction: PDF3DAnnotInstance::ApplyPresetView(), GetPresetViewList(), ModelNode class with visibility control

Optimization

  • Add transparency optimization with configurable resolution modes (Low/Medium/High): OptimizerSettings::SetTransparencyMode()

Bug Fixes

Conversion

  • Fix PDF-to-Word crop marks at page corners causing translation software failures
  • Improve PDF-to-Word cross-application rendering consistency between MS Office and WPS Office
  • Fix PDF-to-Excel cell text placed inside shapes instead of cells
  • Fix PDF-to-Excel table borders rendered as bitmaps overlaid on the table
  • Fix PDF-to-Excel excessive conversion time with cells appearing as images
  • Fix PDF-to-PPT page dimension changes with content shrunk to upper-left
  • Fix Office2PDF::ConvertFromWord crash on specific DOCX files
  • Fix incorrect character spacing in Word-to-PDF causing wrong line breaks
  • Fix bold text appearing excessively bold in Word-to-PDF output
  • Fix missing text (last sentence lost) in Word-to-PDF output
  • Fix shape rendering deviations and incorrect text line breaks in Word-to-PDF

OCR

  • [Linux] Fix OCRConvertTo failure (ERR_FREN_NO_PAGES) due to missing Chinese fonts
  • Fix OCRConvertTo error (ERR_IMAGE_LIBJPEG_LIBRARY_RAISED_ERROR) on specific files
  • Fix OCRConvertTo only outputting first page of a 44-page document

Rendering

  • Fix incorrect CMYK-to-ARGB color conversion in Bitmap DIBFormat
  • [Performance] Fix progressive rendering slowdown (17s->24s->30s->40s) with multiple open documents
  • Fix OutputPreview::SetSimulationProfile() not reflecting different ICC profiles
  • Fix missing text in OutputPreview rendering of specific PDFs
  • Fix rendering inconsistencies with Adobe on specific PDF pages
  • Fix crash when saving Bitmap created with e_DIBRgb via Image::SaveAs
  • Fix abnormal rendering when adding PathObject to specific document pages
  • Fix memory leak in Bitmap constructed from buffer where delete() did not free memory

Printing

  • Fix color discrepancies and uneven dot patterns in PrintManager output
  • Fix intermittent crash in multi-threaded PrintManager usage
  • Fix FXPM_AddPDFFromFileToJob and FXPM_SetJobDocumentName not supporting CJK paths
  • Fix FXPM_SetJobDuplex(1) not enabling duplex printing
  • Fix mixed-orientation page content not rotating with page direction
  • Fix SetRotation() causing landscape PDFs to print with portrait text orientation
  • Fix PrintJob only printing first file when multiple files added via AddPDFFromFile

Forms

  • Fix XFA ExportData/ImportData cycle corrupting table headers and digital signatures
  • Fix XFA TextField Widget proliferation causing progressive load time increase and crash
  • Fix C# ViewDemo rendering blank pages for specific XFA documents
  • Fix JavaScript layer (OCG) visibility control having no effect
  • [Regression] Fix ActionCallback trigger regression in v11 where some callbacks did not fire after field modification
  • Fix “Inherit Zoom” bookmark destination only working for the first bookmark

Document and Page

  • Fix crash when calling SaveAs with e_SaveFlagLinearized after StartEmbedAllFonts
  • Fix fxhtml2pdf zombie process after Html2PDF timeout
  • [Performance] Fix StartSplitByFileSize taking over 1 hour for 25,000-page PDFs
  • Fix excessive Redaction memory peaks in high-redaction-volume continuous-processing scenarios
  • [Windows] Fix ComplianceEngine::SetTempFolderPath() writing to executable directory instead of system temp
  • Fix C# TextPage.GetTextInRect returning question marks for certain characters
  • Fix GetEditingTextCaretPosition returning incorrect positions causing misplaced IME candidate window

Other

  • Fix visual artifacts from parallel multi-process Optimizer image compression
  • Fix specific 3D PDF showing blank after clicking 3D annotation area
  • Improve AutoTagging recognition of Figure-type images vs. Adobe Auto-Tag
  • Fix incorrect content matching in Comparison for OCR documents

PDF Conversion SDK 3.1.0

April 3, 2026

Breaking Changes

PDF2WordSettingData — Parameter change and default value change

Constructor and Set() method add a required max_blank_paragraphs_per_page_bottom parameter:

// v3.0 (4 parameters)
PDF2WordSettingData(bool enable_retain_page_layout,
    bool enable_generate_headers_and_footers,
    bool enable_generate_footnotes_and_endnotes,
    bool enable_generate_page_rendered_break);

// v3.1 (5 parameters)
PDF2WordSettingData(bool enable_retain_page_layout,
    bool enable_generate_headers_and_footers,
    bool enable_generate_footnotes_and_endnotes,
    bool enable_generate_page_rendered_break,
    int max_blank_paragraphs_per_page_bottom);  // new

Action required: Add the new parameter when using the parameterized constructor or Set(). Pass -1 for unlimited (matching previous behavior). Alternatively, use the default constructor with field assignment.

Default value change — enable_generate_headers_and_footers changed from false to true. Code using the default constructor will now generate headers and footers. Set enable_generate_headers_and_footers = false explicitly to preserve previous behavior.

PDF2PowerPointSettingData — Parameter change

Constructor and Set() method add a required enable_adapt_to_largest_page parameter:

// v3.0 (1 parameter)
PDF2PowerPointSettingData(bool enable_aggressively_split_sections);

// v3.1 (2 parameters)
PDF2PowerPointSettingData(bool enable_aggressively_split_sections,
    bool enable_adapt_to_largest_page);  // new

Action required: Add the new parameter. Pass false to preserve previous behavior.

PDF2ExcelSettingData — Parameter change

Constructor and Set() method add 2 required parameters:

// v3.0 (3 parameters)
PDF2ExcelSettingData(String decimal_symbol, String thousands_separator,
    WorkbookSettings workbook_settings);

// v3.1 (5 parameters)
PDF2ExcelSettingData(String decimal_symbol, String thousands_separator,
    WorkbookSettings workbook_settings,
    bool enable_aggressive_table_repair,  // new
    bool include_watermarks);             // new

Action required: Add 2 new parameters. Pass true, false to preserve previous behavior.

PDF2OfficeSettingData — Parameter change

Constructor and Set() method add a required enable_matching_system_fonts parameter:

// v3.0 (9 parameters)
PDF2OfficeSettingData(const wchar_t* metrics_data_folder_path,
    bool enable_ml_recognition, const Range& page_range,
    bool include_pdf_comments,
    const PDF2WordSettingData& word_setting_data,
    const PDF2PowerPointSettingData& power_point_setting_data,
    const PDF2ExcelSettingData& excel_setting_data,
    bool enable_trailing_space, bool include_images);

// v3.1 (10 parameters)
PDF2OfficeSettingData(/* same 9 parameters */,
    bool enable_matching_system_fonts);  // new

Action required: Add the new parameter. Pass false to preserve previous behavior.

PDF-to-Word default behavior change

PDF-to-Word conversion now preserves document internal navigation links by default. If downstream workflows depend on link-free Word output, verify conversion results after upgrading.

New Features and Enhancements

PDF to Office

  • Add enable_matching_system_fonts parameter to PDF2OfficeSettingData for system font matching in PDF-to-Word conversion
  • Add enable_adapt_to_largest_page parameter to PDF2PowerPointSettingData to unify slide size by scaling smaller pages to the largest page dimension
  • Add enable_aggressive_table_repair and include_watermarks parameters to PDF2ExcelSettingData to strengthen table structure repair and control whether watermark content is retained in Excel output
  • Improve PDF-to-Word conversion to preserve document internal navigation links (TOC, cross-references) by default
  • Improve PDF-to-Word conversion performance and reduce memory usage for complex documents
  • Improve PDF-to-Word heading recognition accuracy for better Word heading style mapping
  • Improve PDF-to-Word paragraph recognition, page break handling, and cross-page table continuity

Office to PDF

  • Add Linux platform support for Office2PDFSettingData::is_embed_font font embedding
  • Add DOC (Word 97-2003) format support to Office2PDF::ConvertFromWord
  • Add e_ErrNotMatchFont error code for font-missing scenarios in Office-to-PDF conversion

Platform

  • Add Linux ARM64 .NET Core platform support

Bug Fixes

PDF to Word

  • Fix crash when converting specific PDF files to Word on Linux .NET platform
  • Fix conversion failure producing no output file for specific documents
  • Fix exception (0x77574080 ntdll.dll) in MFC-based projects during PDF-to-Word conversion in Debug x86 mode
  • [Linux] Fix incorrect font substitution where Song typeface renders as Hei in converted Word output
  • Improve font selection to avoid Segoe UI Light for better cross-application compatibility with WPS Office
  • Fix font style loss (e.g., bold) in converted Word documents
  • Fix incorrect font size in conversion output causing layout disruption
  • Fix extra spaces between characters in paragraph text of converted Word output
  • Fix title character overlap in converted Word documents
  • Improve layout stability for translation round-trip workflows where longer translated text caused subsequent page disruption
  • Fix crop marks at page corners interfering with third-party translation software
  • Fix table of contents misalignment in converted Word documents
  • Fix layout misalignment in converted Word output for specific files
  • Fix PDF headers and footers incorrectly converted as body text instead of Word header/footer sections
  • Fix extra line breaks at end of text lines causing layout disruption during translation write-back
  • Fix Arabic content loss during PDF-to-Word conversion
  • Improve conversion quality for large documents: reduce layout issues, output file size bloat, and excess page count
  • Improve cross-application rendering consistency between Microsoft Office and WPS Office
  • Fix faded text, abnormal table rendering, content loss, and text overlap for specific files
  • Fix table of contents loss or corruption with headings not recognized in converted output
  • Fix enable_generate_headers_and_footers = true not taking effect in PDF2WordSettingData

PDF to Excel

  • Fix cell text placed inside drawing shapes instead of editable cells
  • Fix excessive conversion time and incorrect table structure with cells appearing as images
  • Fix content loss when converting built-in test documents

Word to PDF

  • Fix crash in Office2PDF::ConvertFromWord when converting specific DOCX files
  • Fix hang with memory spike to 4 GB when converting specific Word files
  • Fix table content loss in specific regions during conversion
  • Improve character spacing and paragraph layout fidelity on Windows
  • Fix is_embed_font = true not taking effect on Windows in Office2PDFSettingData
  • [Linux] Fix blank PDF output on Red Hat systems missing Calibri font
  • Fix incorrect character spacing causing line break differences from original Word document
  • Fix bold text appearing excessively thick in converted PDF output
  • Fix missing last sentence in converted PDF for specific documents
  • Fix graphical shape rendering deviations and incorrect text line breaks

Updated on April 3, 2026