Foxit PDF SDK

Public Types | Public Member Functions | List of all members
foxit::addon::comparison::Comparison Class Reference
Inheritance diagram for foxit::addon::comparison::Comparison:

## Public Types
enum | CompareType { e_CompareTypeAll = 0x00000000, e_CompareTypeText = 0x00000001, e_CompareTypeAnnotation = 0x00000002 }
| Enumeration for compare type flags. More...

## Public Member Functions
| Comparison (const pdf::PDFDoc &base_doc, const pdf::PDFDoc &compared_doc)
| Constructor, from PDF document object. More...
| Comparison (const Comparison &other)
| Constructor, with another comparison object. More...
| ~Comparison ()
| Destructor.
CompareResults | DoCompare (int base_page_index, int compared_page_index, foxit::uint32 compare_flags)
| Compare a PDF page of base document with a PDF page in compared document. "base document" and "compared document" means the PDF documents objects that are used to construct current object. More...
pdf::PDFDoc | GenerateComparedDoc (foxit::uint32 compare_flags)
| Compare the base document with the compared document (which are used to construct current object) and then generate a PDF document as the comparison result. More...
pdf::PDFDoc | GenerateComparedDoc (foxit::uint32 compare_flags, bool is_show_all_layers)
| Compare the base document with the compared document (which are used to construct current object) and then generate a PDF document as the comparison result. More...
bool | IsEmpty () const
| Check whether current object is empty or not. More...
bool | operator != (const Comparison &other) const
| Not equal operator. More...
Comparison & | operator= (const Comparison &other)
| Assign operator. More...
bool | operator== (const Comparison &other) const
| Equal operator. More...
Public Member Functions inherited from foxit::Base
FS_HANDLE | Handle () const
| Get the handle of current object. More...

## Detailed Description

This class can be used to compare one PDF file (as "base document") with another PDF file (as "compared document") page by page.

## Member Enumeration Documentation

## ◆ CompareType

enum foxit::addon::comparison::Comparison::CompareType

Enumeration for compare type flags.

Values of this enumeration can be used alone and some values can be used in combination.

Enumerator
e_CompareTypeAll | Compare all content. This value should be used alone.
e_CompareTypeText | Compare text only.
e_CompareTypeAnnotation | Compare annotation only.

## Constructor & Destructor Documentation

## ◆ Comparison() [1/2]

foxit::addon::comparison::Comparison::Comparison | ( | const pdf::PDFDoc & | base_doc,
|  | const pdf::PDFDoc & | compared_doc
| ) |  |
| explicit

Constructor, from PDF document object.

Parameters

  [in] | base_doc | A valid PDF document object as base document.
  [in] | compared_doc | A valid PDF document object as compared document.

Note
  If module "Comparison" is not defined in the license information which is used in function common::Library::Initialize, that means user has no right in using compare related functions and this constructor will throw exception foxit::e_ErrNoComparisonModuleRight.

## ◆ Comparison() [2/2]

foxit::addon::comparison::Comparison::Comparison | ( | const Comparison & | other | ) |

Constructor, with another comparison object.

Parameters

  [in] | other | Another comparison object.

## Member Function Documentation

## ◆ DoCompare()

CompareResults foxit::addon::comparison::Comparison::DoCompare | ( | int | base_page_index,
|  | int | compared_page_index,
|  | foxit::uint32 | compare_flags
| ) |  |

Compare a PDF page of base document with a PDF page in compared document. "base document" and "compared document" means the PDF documents objects that are used to construct current object.

Parameters

  [in] | base_page_index | Page index in base document. Valid range: from 0 to (base_page_count-1). base_page_count is returned by function pdf::PDFDoc::GetPageCount for base document.
  [in] | compared_page_index | Page index in compared document. Valid range: from 0 to (compared_page_count-1). compared_page_count is returned by function pdf::PDFDoc::GetPageCount for compared document.
  [in] | compare_flags | Compare type which specifies what to be compared in PDF pages. Please refer to values starting from Comparison::e_CompareTypeAll and this can be one or combination of some of these values.

Returns
  A comparison::CompareResults object.

## ◆ GenerateComparedDoc() [1/2]

pdf::PDFDoc foxit::addon::comparison::Comparison::GenerateComparedDoc | ( | foxit::uint32 | compare_flags | ) |

Compare the base document with the compared document (which are used to construct current object) and then generate a PDF document as the comparison result.

Comparing the contents of two PDF documents and generating a new PDF document can take a long time.

Parameters

  [in] | compare_flags | Compare type which specifies what to be compared in PDF pages. Please refer to values starting from Comparison::e_CompareTypeAll and this can be one or a combination of these values.

Returns
  A pdf::PDFDoc object which represents the output comparison PDF document.

## ◆ GenerateComparedDoc() [2/2]

pdf::PDFDoc foxit::addon::comparison::Comparison::GenerateComparedDoc | ( | foxit::uint32 | compare_flags,
|  | bool | is_show_all_layers
| ) |  |

Compare the base document with the compared document (which are used to construct current object) and then generate a PDF document as the comparison result.

Comparing the contents of two PDF documents and generating a new PDF document can take a long time.

Parameters

  [in] | compare_flags | Compare type which specifies what to be compared in PDF pages. Please refer to values starting from Comparison::e_CompareTypeAll and this can be one or a combination of these values.
  [in] | is_show_all_layers | A boolean value used to decide whether to show all comparison result layers or not. true means that all comparison result layers are shown by default, while false means only "Text" and "Images" comparison result layers are shown by default.

Returns
  A pdf::PDFDoc object which represents the output comparison PDF document.

## ◆ IsEmpty()

bool foxit::addon::comparison::Comparison::IsEmpty | ( |  | ) | const

Check whether current object is empty or not.

When the current object is empty, that means current object is useless.

Returns
  true means current object is empty, while false means not.

## ◆ operator !=()

bool foxit::addon::comparison::Comparison::operator != | ( | const Comparison & | other | ) | const

Not equal operator.

Parameters

  [in] | other | Another comparison object. This function will check if current object is not equal to this one.

Returns
  true means not equal, while false means equal.

## ◆ operator=()

Comparison& foxit::addon::comparison::Comparison::operator= | ( | const Comparison & | other | ) |

Assign operator.

Parameters

  [in] | other | Another comparison object, whose value would be assigned to current object.

Returns
  Reference to current object itself.

## ◆ operator==()

bool foxit::addon::comparison::Comparison::operator== | ( | const Comparison & | other | ) | const

Equal operator.

Parameters

  [in] | other | Another comparison object. This function will check if current object is equal to this one.

Returns
  true means equal, while false means not equal.