オペレーターの使用

PDFオペレーターとその使用法の紹介

オペレーターは、ページにグラフィカルな形状を描画するなど、実行されるべきいくつかのアクションを指定するPDFキーワードです。オペレーターキーワードは、初期のソリダス文字（2Fh）がないことで名前付きオブジェクトと区別されます。オペレーターはコンテンツストリーム内でのみ意味を持ちます。

コンテンツストリームは、ページに描画されるグラフィカル要素を記述する指示が含まれているPDFストリームオブジェクトです。PDFオペレーターの詳細については、PDF仕様で見ることができます。

実装の詳細

このトピックでは、Aspose.PDFでオペレーターを使用する方法について説明します。 このトピックでは、Aspose.PDFで演算子を使用する方法について説明します。

  • GSave 演算子は、PDFの現在のグラフィカル状態を保存します。
  • ConcatenateMatrix （連結行列）演算子は、画像がPDFページにどのように配置されるかを定義するために使用されます。
  • Do 演算子は、ページ上に画像を描画します。
  • GRestore 演算子は、グラフィカル状態を復元します。

PDFファイルに画像を追加するには：

  1. Document オブジェクトを作成し、入力PDFドキュメントを開きます。
  2. 画像を追加する特定のページを取得します。
  3. 画像をページのResourcesコレクションに追加します。
  4. 演算子を使用してページに画像を配置します：
    • まず、GSave 演算子を使用して現在のグラフィカル状態を保存します。
    • 次に、ConcatenateMatrix 演算子を使用して画像が配置される位置を指定します。
    • Do 演算子を使用してページに画像を描画します。
  5. 最後に、GRestore 演算子を使用して更新されたグラフィカル状態を保存します。

次のコードスニペットも Aspose.PDF.Drawing ライブラリで動作します。 以下のコードスニペットも Aspose.PDF.Drawing ライブラリと一緒に使用できます。

以下のコードスニペットは、PDFオペレーターの使用方法を示しています。

// 完全な例とデータファイルについては、https://github.com/aspose-pdf/Aspose.PDF-for-.NET をご覧ください
// ドキュメントディレクトリへのパス。
string dataDir = RunExamples.GetDataDir_AsposePdf_Operators();

// ドキュメントを開く
Document pdfDocument = new Document(dataDir+ "PDFOperators.pdf");

// 座標を設定
int lowerLeftX = 100;
int lowerLeftY = 100;
int upperRightX = 200;
int upperRightY = 200;

// 画像を追加するページを取得
Page page = pdfDocument.Pages[1];
// 画像をストリームにロード
FileStream imageStream = new FileStream(dataDir + "PDFOperators.jpg", FileMode.Open);
// ページリソースのイメージコレクションに画像を追加
page.Resources.Images.Add(imageStream);
// GSaveオペレーターを使用：このオペレーターは現在のグラフィックス状態を保存します
page.Contents.Add(new Aspose.Pdf.Operators.GSave());
// RectangleとMatrixオブジェクトを作成
Aspose.Pdf.Rectangle rectangle = new Aspose.Pdf.Rectangle(lowerLeftX, lowerLeftY, upperRightX, upperRightY);
Matrix matrix = new Matrix(new double[] { rectangle.URX - rectangle.LLX, 0, 0, rectangle.URY - rectangle.LLY, rectangle.LLX, rectangle.LLY });
// ConcatenateMatrix（マトリックスの連結）オペレーターを使用：画像がどのように配置されるかを定義
page.Contents.Add(new Aspose.Pdf.Operators.ConcatenateMatrix(matrix));
XImage ximage = page.Resources.Images[page.Resources.Images.Count];
// Doオペレーターを使用：このオペレーターは画像を描画します
page.Contents.Add(new Aspose.Pdf.Operators.Do(ximage.Name));
// GRestoreオペレーターを使用：このオペレーターはグラフィックス状態を復元します
page.Contents.Add(new Aspose.Pdf.Operators.GRestore());
dataDir = dataDir + "PDFOperators_out.pdf";
// 更新されたドキュメントを保存
pdfDocument.Save(dataDir);

ページ上にXFormを描画するためのオペレーターの使用

このトピックでは、GSave/GRestoreオペレーター、ContatenateMatrixオペレーターを使用してxFormの位置を指定し、Doオペレーターを使用してページ上にxFormを描画する方法を示します。

以下のコードは、PDFファイルの既存の内容をGSave/GRestoreオペレーターペアでラップします。このアプローチは、既存の内容の最後で初期グラフィックス状態を取得するのに役立ちます。このアプローチがない場合、望ましくない変換が既存のオペレーターチェーンの最後に残る可能性があります。

// 完全な例とデータファイルについては、https://github.com/aspose-pdf/Aspose.PDF-for-.NET をご覧ください
// ドキュメントディレクトリへのパス
string dataDir = RunExamples.GetDataDir_AsposePdf_Operators();

string imageFile = dataDir+ "aspose-logo.jpg";
string inFile = dataDir + "DrawXFormOnPage.pdf";
string outFile = dataDir + "blank-sample2_out.pdf";

using (Document doc = new Document(inFile))
{
    OperatorCollection pageContents = doc.Pages[1].Contents;

    // サンプルは以下を示しています
    // GSave/GRestoreオペレーターの使用
    // xFormの位置指定にContatenateMatrixオペレーターを使用
    // ページにxFormを描画するためにDoオペレーターを使用

    // 既存の内容をGSave/GRestoreオペレーターペアでラップ
    //        これは既存の内容の最後で初期グラフィックス状態を取得するためです
    //        それ以外の場合、望ましくない変換が既存のオペレーターチェーンの最後に残る可能性があります
    pageContents.Insert(1, new Aspose.Pdf.Operators.GSave());
    pageContents.Add(new Aspose.Pdf.Operators.GRestore());

    // 新しいコマンドの後でグラフィックス状態を適切にクリアするために、グラフィックス状態の保存オペレータを追加
    pageContents.Add(new Aspose.Pdf.Operators.GSave());

    #region create xForm

    // xFormを作成
    XForm form = XForm.CreateNewForm(doc.Pages[1], doc);
    doc.Pages[1].Resources.Forms.Add(form);
    form.Contents.Add(new Aspose.Pdf.Operators.GSave());
    // 画像の幅と高さを定義
    form.Contents.Add(new Aspose.Pdf.Operators.ConcatenateMatrix(200, 0, 0, 200, 0, 0));
    // 画像をストリームに読み込む
    Stream imageStream = new FileStream(imageFile, FileMode.Open);
    // 画像をXFormリソースの画像コレクションに追加
    form.Resources.Images.Add(imageStream);
    XImage ximage = form.Resources.Images[form.Resources.Images.Count];
    // Doオペレーターを使用: このオペレーターは画像を描画します
    form.Contents.Add(new Aspose.Pdf.Operators.Do(ximage.Name));
    form.Contents.Add(new Aspose.Pdf.Operators.GRestore());

    #endregion

    pageContents.Add(new Aspose.Pdf.Operators.GSave());
    // x=100 y=500の座標にフォームを配置
    pageContents.Add(new Aspose.Pdf.Operators.ConcatenateMatrix(1, 0, 0, 1, 100, 500));
    // Doオペレーターを使用してフォームを描画
    pageContents.Add(new Aspose.Pdf.Operators.Do(form.Name));
    pageContents.Add(new Aspose.Pdf.Operators.GRestore());

    pageContents.Add(new Aspose.Pdf.Operators.GSave());
    // x=100 y=300の座標にフォームを配置
    pageContents.Add(new Aspose.Pdf.Operators.ConcatenateMatrix(1, 0, 0, 1, 100, 300));
    // Doオペレーターを使用してフォームを描画
    pageContents.Add(new Aspose.Pdf.Operators.Do(form.Name));
    pageContents.Add(new Aspose.Pdf.Operators.GRestore();

    // GSaveの後でグラフィックス状態をGRestoreで復元
    pageContents.Add(new Aspose.Pdf.Operators.GRestore());
    doc.Save(outFile);
}

オペレータクラスを使用してグラフィックオブジェクトを削除する

オペレータクラスは、PDF操作に優れた機能を提供します。PDFファイルにPdfContentEditor クラスの DeleteImage メソッドを使用して削除できないグラフィックが含まれている場合、代わりにオペレータクラスを使用して削除できます。

次のコードスニペットは、グラフィックを削除する方法を示しています。PDFファイルにグラフィックのテキストラベルが含まれている場合、このアプローチを使用すると、PDFファイルにラベルが残る可能性があるため、そのような画像を削除する代替方法としてグラフィックオペレーターを探してください。

// 完全な例とデータファイルについては、https://github.com/aspose-pdf/Aspose.PDF-for-.NET にアクセスしてください
// ドキュメントディレクトリへのパス。
string dataDir = RunExamples.GetDataDir_AsposePdf_Operators();

Document doc = new Document(dataDir+ "RemoveGraphicsObjects.pdf");
Page page = doc.Pages[2];
OperatorCollection oc = page.Contents;

// 使用されるパスペイントオペレータ
Operator[] operators = new Operator[] {
        new Aspose.Pdf.Operators.Stroke(),
        new Aspose.Pdf.Operators.ClosePathStroke(),
        new Aspose.Pdf.Operators.Fill()
};

oc.Delete(operators);
doc.Save(dataDir+ "No_Graphics_out.pdf");
JavaScriptの利用方法 PDFドキュメントを比較する