Comparison Profile

The Compare selected pages option limits the i-net PDFC comparison to selected pages from exactly two documents. The profile sidebar provides the fixed entries Document 1 and Document 2; you cannot add more documents in this interface.

Paging and sections

Compare selected pages

The following options are available for each document:

Document 1

  • Page range: Enter one-based page numbers or inclusive ranges separated by commas, for example 1-5,8,11-13. A range includes both its first and last page.
  • Last pages: Enter how many pages should additionally be excluded from the end of the selected page range.

Document 2

  • Page range: Enter one-based page numbers or inclusive ranges separated by commas, for example 1-5,8,11-13. A range includes both its first and last page.
  • Last pages: Enter how many pages should additionally be excluded from the end of the selected page range.

The page range is determined first. The number entered for Last pages is then excluded from the end of that result. An empty field or the value 0 excludes no pages from the end.

The inputs are validated. For Last pages, enter an integer from 0 to 99999; negative values and values outside this range are invalid. A valid page range consists of one-based page numbers and inclusive ranges separated by commas. A validation error is shown at the affected field and prevents the value from being saved.

Comparison Profile

Filters and optimizations

Pages to compare

The Pages to compare GUI page describes the current profile sidebar. The following sections document the stored profile values and their mapping separately from the user interface.

Raw profile values

Name Value and meaning
FILTERS Contains the PAGERANGE filter identifier to activate the page-range filter. Values are stored as a comma-separated list.
PAGERANGE_DOCUMENT1 One-based page numbers and inclusive page ranges for document 1, separated by commas, for example 1-5,8,11-13.
PAGERANGE_DOCUMENT2 One-based page numbers and inclusive page ranges for document 2, separated by commas.
PAGERANGE_END_DOCUMENT1 Non-negative number of pages removed from the end of document 1 after the page-range selection. 0 means that no additional pages are removed.
PAGERANGE_END_DOCUMENT2 Non-negative number of pages removed from the end of document 2 after the page-range selection. 0 means that no additional pages are removed.

Page-range values use one-based page numbers. The end filters are applied after the page-range selection. The current plugin definition uses the full names PAGERANGE_END_DOCUMENT1 and PAGERANGE_END_DOCUMENT2 for the two end filters. The shortened identifiers PAGERANGEEND1 and PAGERANGEEND2 are not current profile names.

Profile XML

The following example shows the raw values in a profile configuration: 

<entry key="FILTERS">PAGERANGE</entry>
<entry key="PAGERANGE_DOCUMENT1">1-5,8,11-13</entry>
<entry key="PAGERANGE_DOCUMENT2">1-5,8,11-13</entry>
<entry key="PAGERANGE_END_DOCUMENT1">2</entry>
<entry key="PAGERANGE_END_DOCUMENT2">0</entry>

Structure and API keys

The server structure and API keys are derived from the raw profile values:

Key Mapping
pdfc.filter.PAGERANGE Adds or removes PAGERANGE in FILTERS.
pdfc.filter.PAGERANGE_DOCUMENT1 Accesses PAGERANGE_DOCUMENT1.
pdfc.filter.PAGERANGE_DOCUMENT2 Accesses PAGERANGE_DOCUMENT2.
pdfc.filter.PAGERANGE_END_DOCUMENT1 Accesses PAGERANGE_END_DOCUMENT1.
pdfc.filter.PAGERANGE_END_DOCUMENT2 Accesses PAGERANGE_END_DOCUMENT2.

Mapping to the current sidebar

  • Compare selected pages adds PAGERANGE to FILTERS or removes the identifier.
  • In Document 1 and Document 2, Page range writes PAGERANGE_DOCUMENT1 and PAGERANGE_DOCUMENT2. The list contains exactly one row for each document.
  • Last pages writes PAGERANGE_END_DOCUMENT1 and PAGERANGE_END_DOCUMENT2. An empty value is treated by the sidebar as no additional pages.
  • The page-list fields are enabled only when the filter is active. Validation expects valid page ranges for both documents and a value from 0 to 99999 for the last-pages fields.