Product:

Get started

Samples

Basic operations

Learn More

Viewer

UI customization

Annotation

Collaboration

MS Office

Conversion

PDF/A

Forms

Generate

Page manipulation

Edit page content

Extraction

Digital signature

Bookmarks

Compare files

Overview

Overlay comparison

Samples

APIs

Optimization

Layers (OCGs)

Measurement

Redaction

Security

Portfolios

Low-level PDF API

Changelogs

Compare files with overlay

Apryse SDK allows you to compare files visually using overlays.

Overlay PDFs to find differences in Xamarin.Android

This tutorial only applies to Xamarin.Android. See Xamarin.iOS equivalent here .

You can visually compare pages. This resolution independent comparison allows you to quickly spot differences between pages.

There are two main ways to integrate the out-of-box UI components in your application:

Standalone activity
Comparison options dialog

Standalone activity

The DiffActivity is a standalone component that handles from picking two files to generating the comparison result.

Define the activity

Storage Permission

Please follow the latest Android best practices and guidelines outlined here

XML

1<activity android:name="com.pdftron.pdf.controls.DiffActivity" android:configChanges="keyboardHidden|orientation|screenSize|screenLayout|smallestScreenSize" android:theme="@style/PDFTronAppTheme" android:windowSoftInputMode="adjustPan" />

Show the activity

C#

1DiffActivity.Open(this);

Comparison options dialog

If you have your own viewer already and only want to show the comparison options in your application, the DiffOptionsDialogFragment can be used.

C#

1public void Show(Context context, FragmentManager fragmentManager, List<Android.Net.Uri> files)
2{
3    var fragment = pdftron.PDF.Dialog.Diffing.DiffOptionsDialogFragment.NewInstance(
4        files[0], files[1]
5    );
6    fragment.SetStyle((int)DialogFragmentStyle.Normal, Resource.Style.PDFTronAppTheme);
7    fragment.DiffOptionsConfirmed += (sender, e) =>
8    {
9        CompareFiles(context, files, e.Color1, e.Color2, e.BlendMode);
10    };
11    fragment.Show(fragmentManager, "diff_options_dialog");
12}

where compareFile is:

C#

1private void CompareFiles(Context context, List<Android.Net.Uri> files, int color1, int color2, int blendMode)
2{
3    Android.Net.Uri uri = pdftron.PDF.Dialog.Diffing.DiffUtils.CompareFilesImpl(context, files, color1, color2, blendMode);
4    // do something with the output
5}

AsyncTask pattern can be used instead of Disposable pattern if desired.

Overlay PDFs to find differences in Xamarin.iOS

This tutorial only applies to Xamarin.iOS. See Xamarin.Android equivalent here .

The Apryse SDK provides powerful file comparison functionality. An example of this capability is shown below by comparing two PDF pages and highlighting the difference between them in red.

File 1	File 2	Difference

Show a file comparison view controller

The PTDiffViewController class shows a control to select two documents and create a new file showing the visual difference between them with customizable colors.

The file comparison control is part of the Tools library, so make sure you have added the Tools library to your project.

C#

1// Initialize a file comparison view controller.
2var diffController = new PTDiffViewController();
3
4diffController.DidCreateDiffFileAtURL += (sender, e) =>
5{
6    // Handle created diff file.
7};
8
9var navigationController = new UINavigationController(diffController);
10if (!UserInterfaceIdiomIsPhone)
11{
12    navigationController.ModalPresentationStyle = UIModalPresentationStyle.Popover;
13
14    navigationController.PopoverPresentationController.SourceView = btn;
15    navigationController.PopoverPresentationController.SourceRect = btn.Bounds;
16}
17
18this.PresentViewController(navigationController, true, null);

The diff view controller must be pushed onto a navigation controller's stack before being shown.

Retrieving the file comparison output.

The PTDiffViewController creates an output file showing the visual difference between the two documents in a temporary directory and returns an NSURL with the file's location via a delegate method. To save and display the file, you must conform to the PTDiffViewControllerDelegate protocol.

File comparison sample code

The following sample code demonstrates how to use PDFNet to generate a document displaying the visual difference between two PDF pages:

C#

1// Xamarin sample code coming soon

Did you find this helpful?

Trial setup questions?

Ask experts on Discord

Need other help?

Contact Support

Pricing or product questions?

Contact Sales