PDFドキュメントの比較

すべての比較ツールは、Aspose.PDF.Drawingライブラリで利用可能です。

PDFドキュメントを比較する方法

PDFドキュメントを扱う際、2つのドキュメントの内容を比較して違いを特定する必要がある場合があります。Aspose.PDF for .NETライブラリは、この目的のために強力なツールセットを提供します。この記事では、いくつかの簡単なコードスニペットを使用してPDFドキュメントを比較する方法を探ります。

Aspose.PDFの比較機能を使用すると、2つのPDFドキュメントをページごとに比較できます。特定のページまたは全体のドキュメントを比較することができます。結果として得られる比較ドキュメントは、違いを強調表示し、2つのファイル間の変更を特定しやすくします。

以下は、Aspose.PDF for .NETライブラリを使用してPDFドキュメントを比較するための可能な方法のリストです：

  1. 特定のページの比較 - 2つのPDFドキュメントの最初のページを比較します。

  2. 全体ドキュメントの比較 - 2つのPDFドキュメントの全体の内容を比較します。

  3. PDFドキュメントをグラフィカルに比較する：

  • GetDifferenceメソッドを使用してPDFを比較 - 変更がマークされた個々の画像。

  • CompareDocumentsToPdfメソッドを使用してPDFを比較 - 変更がマークされた画像を含むPDFドキュメント。

特定のページの比較

最初のコードスニペットは、2つのPDFドキュメントの最初のページを比較する方法を示しています。

手順：

  1. ドキュメントの初期化。 コードは、それぞれのファイルパス（documentPath1とdocumentPath2）を使用して2つのPDFドキュメントを初期化することから始まります。パスは現在空の文字列として指定されていますが、実際にはこれを実際のファイルパスに置き換えます。

  2. 比較プロセス。

  • ページ選択 - 比較は各ドキュメントの最初のページに制限されます（‘Pages[1]’）。
  • 比較オプション：

‘AdditionalChangeMarks = true’ - このオプションは、追加の変更マーカーが表示されることを保証します。これらのマーカーは、現在比較しているページにない場合でも、他のページに存在する可能性のある違いを強調表示します。

‘ComparisonMode = ComparisonMode.IgnoreSpaces’ - このモードは、テキスト内のスペースを無視し、単語内の変更のみに焦点を当てるように比較者に指示します。

  1. 2つのページ間の違いを強調表示する結果の比較ドキュメントは、‘resultPdfPath’で指定されたファイルパスに保存されます。
// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void ComparingSpecificPages()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_DocumentCompare();

    // Open PDF documents
    using (var document1 = new Aspose.Pdf.Document(dataDir + "ComparingSpecificPages1.pdf"))
    {
        using (var document2 = new Aspose.Pdf.Document(dataDir + "ComparingSpecificPages2.pdf"))
        {
            // Compare
            Aspose.Pdf.Comparison.SideBySidePdfComparer.Compare(document1.Pages[1], document2.Pages[1], dataDir + "ComparingSpecificPages_out.pdf", new Aspose.Pdf.Comparison.SideBySideComparisonOptions
            {
                AdditionalChangeMarks = true,
                ComparisonMode = Aspose.Pdf.Comparison.ComparisonMode.IgnoreSpaces
            });
        }
    }
}

全体ドキュメントの比較

2番目のコードスニペットは、2つのPDFドキュメントの全体の内容を比較する範囲を拡大します。

手順：

  1. ドキュメントの初期化。 最初の例と同様に、2つのPDFドキュメントがファイルパスで初期化されます。

  2. 比較プロセス。

  • 全体ドキュメントの比較 - 最初のスニペットとは異なり、このコードは2つのドキュメントの全体の内容を比較します。

  • 比較オプション - オプションは最初のスニペットと同じで、スペースが無視され、追加の変更マーカーが表示されることを保証します。

  1. 2つのドキュメントのすべてのページにわたる違いを強調表示する比較結果は、‘resultPdfPath’で指定されたファイルに保存されます。
// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void ComparingEntireDocuments()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_DocumentCompare();

    // Open PDF documents
    using (var document1 = new Aspose.Pdf.Document(dataDir + "ComparingEntireDocuments1.pdf"))
    {
        using (var document2 = new Aspose.Pdf.Document(dataDir + "ComparingEntireDocuments2.pdf"))
        {
            // Compare
            Aspose.Pdf.Comparison.SideBySidePdfComparer.Compare(
                document1,
                document2,
                dataDir + "ComparingEntireDocuments_out.pdf",
                new Aspose.Pdf.Comparison.SideBySideComparisonOptions
                {
                    AdditionalChangeMarks = true,
                    ComparisonMode = Aspose.Pdf.Comparison.ComparisonMode.IgnoreSpaces
                });
        }
    }
}

これらのスニペットによって生成された比較結果は、Adobe Acrobatなどのビューアで開くことができるPDFドキュメントです。Adobe Acrobatで2ページ表示を使用すると、変更が並列に表示されます：

  • 削除 - これは左ページに記載されています。
  • 挿入 - これは右ページに記載されています。

‘AdditionalChangeMarks’を’true’に設定することで、現在表示されているページに変更がない場合でも、他のページで発生する可能性のある変更のマーカーを見ることができます。

Aspose.PDF for .NETは、特定のページを比較する必要がある場合でも、全体のドキュメントを比較する必要がある場合でも、PDFドキュメントを比較するための強力なツールを提供します。‘AdditionalChangeMarks’やさまざまな’ComparisonMode設定’のようなオプションを使用することで、比較プロセスを特定のニーズに合わせて調整できます。結果のドキュメントは、変更の明確な並列ビューを提供し、改訂を追跡し、ドキュメントの正確性を確保するのを容易にします。

GraphicalPdfComparerを使用してPDFドキュメントを比較する

特にプロフェッショナルな環境で文書を共同作成する際、同じファイルの複数のバージョンができることがよくあります。

GraphicalPdfComparerクラスを使用してPDFドキュメントとページを比較できます。このクラスは、ページのグラフィックコンテンツの変更を比較するのに適しています。

Aspose.PDF for .NETを使用すると、ドキュメントとページを比較し、比較結果をPDFドキュメントまたは画像ファイルに出力できます。

次のクラスプロパティを設定できます：

  • 解像度 - 出力画像のDPI単位での解像度、および比較中に生成される画像の解像度。
  • 色 - 変更マーカーの色。
  • 閾値 - 変更の閾値（パーセント）。デフォルト値はゼロです。ゼロ以外の値を設定すると、あなたにとって重要でないグラフィックの変更を無視できます。

このクラスには、さらなる処理に適した形でページ画像の違いを取得するメソッドがあります：ImagesDifference GetDifference(Page page1, Page page2)。

このメソッドは、比較される最初のページの画像と違いの配列を含むImagesDifferenceクラスのオブジェクトを返します。違いの配列と元の画像は、RGB24bppピクセル形式を持っています。

ImagesDifferenceを使用すると、異なる画像を生成し、違いの配列を元の画像に追加することで、比較される2番目のページの画像を取得できます。これを行うには、ImagesDifference.GetDestinationImageおよびImagesDifference.DifferenceToImageメソッドを使用します。

GetDifferenceメソッドを使用してPDFを比較する

提供されたコードは、2つのPDFドキュメントを比較し、それらの違いの視覚的表現を生成するGetDifferenceメソッドを定義しています。

このメソッドは、2つのPDFファイルの最初のページを比較し、2つのPNG画像を生成します：

  • 1つの画像（diffPngFilePath）は、ページ間の違いを赤で強調表示します。
  • もう1つの画像（destPngFilePath）は、宛先（2番目の）PDFページの視覚的表現です。

このプロセスは、ドキュメントの2つのバージョン間の変更や違いを視覚的に比較するのに役立ちます。

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void ComparePDFWithGetDifferenceMethod()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_DocumentCompare();

    // Open PDF documents
    using (var document1 = new Aspose.Pdf.Document(dataDir + "ComparePDFWithGetDifferenceMethod1.pdf"))
    {
        using (var document2 = new Aspose.Pdf.Document(dataDir + "ComparePDFWithGetDifferenceMethod2.pdf"))
        {
            // Create comparer 
            var comparer = new Aspose.Pdf.Comparison.GraphicalPdfComparer();
            // Compare
            using (var imagesDifference = comparer.GetDifference(document1.Pages[1], document2.Pages[1]))
            {
                using (var diffImg = imagesDifference.DifferenceToImage(Aspose.Pdf.Color.Red, Aspose.Pdf.Color.White))
                {
                    diffImg.Save(dataDir + "ComparePDFWithGetDifferenceMethodDiffPngFilePath_out.png");
                }
                using (var destImg = imagesDifference.GetDestinationImage())
                {
                    destImg.Save(dataDir + "ComparePDFWithGetDifferenceMethodDestPngFilePath_out.png");
                }
            }
        }
    }
}

CompareDocumentsToPdfメソッドを使用してPDFを比較する

提供されたコードスニペットは、2つのドキュメントを比較し、比較結果のPDFレポートを生成するCompareDocumentsToPdfメソッドを使用しています。

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void ComparePDFWithCompareDocumentsToPdfMethod()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_DocumentCompare();

    // Open PDF documents
    using (var document1 = new Aspose.Pdf.Document(dataDir + "ComparePDFWithCompareDocumentsToPdfMethod1.pdf"))
    {
        using (var document2 = new Aspose.Pdf.Document(dataDir + "ComparePDFWithCompareDocumentsToPdfMethod2.pdf"))
        {
            // Create comparer
            var comparer = new Aspose.Pdf.Comparison.GraphicalPdfComparer()
            {
                Threshold = 3.0,
                Color = Aspose.Pdf.Color.Blue,
                Resolution = new Aspose.Pdf.Devices.Resolution(300)
            };
            // Compare
            comparer.CompareDocumentsToPdf(document1, document2, dataDir + "compareDocumentsToPdf_out.pdf");
        }
    }
}
JavaScriptの操作 PDFにおけるナビゲーションとインタラクション