PDFファイルの画像情報

導入

PDF ファイルは、今日ではどこにでもあります。事実上、あらゆるビジネス文書や個人文書は、ある時点でこの形式になります。レポート、パンフレット、電子書籍など、これらのファイルをプログラムで操作する方法を理解することで、さまざまな可能性が広がります。一般的な要件の 1 つは、PDF ファイルから画像情報を抽出することです。このガイドでは、.NET 用の Aspose.PDF ライブラリを使用して、PDF 文書に埋め込まれた画像に関する重要な詳細を抽出する方法について詳しく説明します。

前提条件

コーディングの細部に入る前に、いくつかの前提条件を満たす必要があります。

  1. 開発環境: .NET 開発環境をセットアップする必要があります。Visual Studio またはその他の .NET 互換 IDE を使用できます。
  2. Aspose.PDFライブラリ: Aspose.PDFライブラリにアクセスできることを確認してください。 Aspose ウェブサイト .
  3. 基本的な C# の知識: C# とオブジェクト指向プログラミングの概念に精通していると、チュートリアルを簡単に理解できるようになります。
  4. PDF ドキュメント: コードをテストするための画像を含むサンプル PDF ドキュメントを用意しておきます。

パッケージのインポート

Aspose.PDF ライブラリの使用を開始するには、必要な名前空間を C# ファイルにインポートする必要があります。簡単に説明します。

using System.IO;
using Aspose.Pdf;
using System;

これらの名前空間により、PDF ファイルを操作したり画像データを抽出したりするために必要なクラスとメソッドにアクセスできるようになります。

これですべての設定が完了したので、これを管理しやすいステップに分解します。PDF ドキュメントを読み込み、各ページを調べ、ドキュメント内の各画像のサイズと解像度を抽出する C# プログラムを作成します。

ステップ1: ドキュメントを初期化する

このステップでは、PDFファイルへのパスを使用してPDFドキュメントを初期化します。"YOUR DOCUMENT DIRECTORY" PDF ファイルが保存されている実際のパスを入力します。

//ドキュメント ディレクトリへのパス。
string dataDir = "YOUR DOCUMENT DIRECTORY";
//ソースPDFファイルを読み込む
Document doc = new Document(dataDir + "ImageInformation.pdf");

私たちはDocument指定されたディレクトリから PDF を読み込むオブジェクト。これにより、ファイルの内容を操作できるようになります。

ステップ 2: デフォルトの解像度を設定し、データ構造を初期化する

次に、計算に便利な画像のデフォルト解像度を設定します。また、画像名を保持する配列と、グラフィックの状態を管理するためのスタックも準備します。

//画像のデフォルトの解像度を定義する
int defaultResolution = 72;
System.Collections.Stack graphicsState = new System.Collections.Stack();
//画像名を保持する配列リストオブジェクトを定義する
System.Collections.ArrayList imageNames = new System.Collections.ArrayList(doc.Pages[1].Resources.Images.Names);

defaultResolution変数は画像の解像度を正しく計算するのに役立ちます。graphicsStateスタックは、変換演算子に遭遇したときにドキュメントの現在のグラフィカル状態を保存する手段として機能します。

ステップ3: ページ上の各演算子を処理する

ここで、ドキュメントの最初のページにあるすべての演算子をループします。ここで、大変な処理が行われます。

foreach (Operator op in doc.Pages[1].Contents)
{
    //プロセスオペレーター...
}

PDF ファイル内の各演算子は、画像などのグラフィック要素を管理する方法をレンダラーに指示するコマンドです。

ステップ4: GSave/GRestore演算子を処理する

ループ内では、グラフィックの状態に加えられた変更を追跡するために、グラフィックの保存および復元コマンドを処理します。

if (opSaveState != null) 
{
    //以前の状態を保存
    graphicsState.Push(((Matrix)graphicsState.Peek()).Clone());
} 
else if (opRestoreState != null) 
{
    //以前の状態を復元
    graphicsState.Pop();
}

GSave現在のグラフィック状態を保存しますが、GRestore最後に保存された状態を復元し、画像を処理するときに変換を元に戻すことができます。

ステップ5: 変換マトリックスを管理する

次に、画像に変換を適用するときに、変換行列の連結を処理します。

else if (opCtm != null) 
{
    Matrix cm = new Matrix(
        (float)opCtm.Matrix.A,
        (float)opCtm.Matrix.B,
        (float)opCtm.Matrix.C,
        (float)opCtm.Matrix.D,
        (float)opCtm.Matrix.E,
        (float)opCtm.Matrix.F);
    
    ((Matrix)graphicsState.Peek()).Multiply(cm);
    continue;
}

変換行列が適用されると、グラフィックス状態に格納されている現在の行列とそれを乗算して、画像に適用されたスケーリングや変換を追跡できるようにします。

ステップ6: 画像情報を抽出する

最後に、画像の描画演算子を処理し、寸法や解像度などの必要な情報を抽出します。

else if (opDo != null) 
{
    //オブジェクトを描画するHandle Do演算子
    if (imageNames.Contains(opDo.Name)) 
    {
        Matrix lastCTM = (Matrix)graphicsState.Peek();
        XImage image = doc.Pages[1].Resources.Images[opDo.Name];
        double scaledWidth = Math.Sqrt(Math.Pow(lastCTM.Elements[0], 2) + Math.Pow(lastCTM.Elements[1], 2));
        double scaledHeight = Math.Sqrt(Math.Pow(lastCTM.Elements[2], 2) + Math.Pow(lastCTM.Elements[3], 2));
        double originalWidth = image.Width;
        double originalHeight = image.Height;
        
        double resHorizontal = originalWidth * defaultResolution / scaledWidth;
        double resVertical = originalHeight * defaultResolution / scaledHeight;
        
        //情報を出力する
        Console.Out.WriteLine(string.Format(dataDir + "image {0} ({1:.##}:{2:.##}): res {3:.##} x {4:.##}",
                         opDo.Name, scaledWidth, scaledHeight, resHorizontal, resVertical));
    }
}

ここでは、オペレータがイメージの描画を担当しているかどうかを確認します。 担当している場合は、対応する XImage オブジェクトを取得し、そのスケールされた寸法と解像度を計算し、必要な情報を出力します。

結論

おめでとうございます。Aspose.PDF for .NET を使用して PDF ファイルから画像情報を抽出する実用的な例を作成しました。この機能は、レポート、データ抽出、カスタム PDF ビューアーなど、さまざまなアプリケーションで PDF ドキュメントを分析または操作する必要がある開発者にとって非常に便利です。

よくある質問

Aspose.PDF ライブラリとは何ですか?

Aspose.PDF ライブラリは、.NET アプリケーションで PDF ファイルを作成、操作、変換するための強力なツールです。

図書館は無料で利用できますか?

はい、Asposeは無料トライアルを提供しています。ダウンロードできます。 ここ .

どのような種類の画像形式を抽出できますか?

ライブラリは、PDF に埋め込まれている限り、JPEG、PNG、TIFF などのさまざまな画像形式をサポートします。

Aspose は商用目的で使用されますか?

はい、Aspose製品は商用利用が可能です。ライセンスについては、 購入ページ .

Aspose のサポートを受けるにはどうすればよいですか?

サポートフォーラムにアクセスできます ここ .