.NET でプレゼンテーションのインク オブジェクトを管理する

はじめに

PowerPoint は、フリーフォームのストロークを描くことができるインク機能を提供します。インクは、他のオブジェクトをハイライトしたり、接続やプロセスを示したり、スライド上の特定の項目に注意を引くために使用できます。

Aspose.Slides.Ink 名前空間には、インク オブジェクトを操作するために必要なクラスとインターフェイスが含まれています。たとえば、IInk インターフェイスは、スライド上のインク オブジェクトを表します。

通常のオブジェクトとインク オブジェクトの違い

PowerPoint のスライド上のオブジェクトは、通常、シェイプ オブジェクトで表されます。最も簡単な形では、シェイプはオブジェクト自体(フレーム)の領域を定義するコンテナであり、コンテナのサイズ、形状、背景などのプロパティを持ちます。詳細については、Shape Layout Format を参照してください。

しかし、PowerPoint がインク オブジェクトを処理する場合、サイズ以外のオブジェクト フレーム(コンテナ)のすべてのプロパティは無視されます。コンテナ領域のサイズは、標準の IShape.Width と IShape.Height プロパティで決定されます:

ink_powerpoint1

インク トレース

インク トレースは、ユーザーがデジタルインクで書く際のペンの軌跡を記録するために使用される基本要素です。トレースは、接続されたポイントのシーケンスを保存します。

最もシンプルなエンコード形式は、各サンプル点の X および Y 座標を指定します。すべての接続された点がレンダリングされると、次のような画像が生成されます:

ink_powerpoint2

描画用ブラシ プロパティ

ブラシは、インク トレースのポイントを接続する線を描くために使用されます。ブラシには独自の色とサイズがあり、IInkBrush.Color と IInkBrush.Size プロパティで表されます。

インク ブラシの色を設定

この C# コードは、インク ブラシの色を設定する方法を示しています:

using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Ink;

using var presentation = new Presentation("pres.pptx");
var ink = (IInk)presentation.Slides[0].Shapes[0];
var brush = ink.Traces[0].Brush;
brush.Color = Color.Red;

インク ブラシのサイズを設定

この C# コードは、インク ブラシのサイズを設定する方法を示しています:

using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Ink;

using var presentation = new Presentation("pres.pptx");
var ink = (IInk)presentation.Slides[0].Shapes[0];
var brush = ink.Traces[0].Brush;
brush.Size = new SizeF(5f, 10f);

通常、ブラシの幅と高さは一致せず、そのため PowerPoint はブラシのサイズを表示しません(対応するデータ セクションは灰色表示になります)。ブラシの幅と高さが一致する場合、PowerPoint は次のようにサイズを表示します:

ink_powerpoint3

分かりやすくするために、インク オブジェクトの高さを増やし、重要な寸法を確認しましょう:

ink_powerpoint4

コンテナ(フレーム)はブラシのサイズを考慮せず、常に線の太さが 0 であるとみなします(前の画像を参照)。

したがって、インク オブジェクト全体の可視領域を決定するには、トレースのブラシ サイズを考慮する必要があります。ここでは、対象オブジェクト(手書きテキスト トレース)がコンテナ(フレーム)のサイズに合わせてスケーリングされています。コンテナのサイズが変わると、ブラシのサイズは一定のままで、逆も同様です。

ink_powerpoint5

PowerPoint はテキスト オブジェクトにも同様の動作を使用します:

ink_powerpoint6

エクスポートおよびレンダリング時のインク表示の制御

Aspose.Slides は、エクスポートまたはレンダリングされた出力でインク オブジェクトがどのように表示されるかを制御するための IInkOptions インターフェイスを提供します。そのプロパティを使用してインクを完全に非表示にしたり、インク ブラシのマスク操作の解釈方法を変更したりできます。

Ink options are available through the export or rendering options for several output types:

出力 インク オプション プロパティ
PDF PdfOptions.InkOptions
HTML HtmlOptions.InkOptions
SVG SVGOptions.InkOptions
TIFF TiffOptions.InkOptions
スライド画像 RenderingOptions.InkOptions

The same two settings are available through these properties:

  • HideInk は、インク オブジェクトを出力に含めるかどうかを決定します。デフォルト値は false です。
  • InterpretMaskOpAsOpacity は、インク ブラシをレンダリングする際にマスク操作を不透明度として解釈するかどうかを決定します。デフォルト値は true です。false に設定すると、代わりに ROP 操作が使用されます。

PDF 出力でインク オブジェクトを非表示にする

既定では、エクスポート時にインク オブジェクトは表示されたままです。手書きの注釈やその他のインク コンテンツを除いたクリーンな出力が必要な場合は、IInkOptions.HideInk を true に設定します。

次の C# サンプルは、すべてのインク オブジェクトを非表示にした状態でプレゼンテーションを PDF にエクスポートします:

using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("presentation.pptx");
var pdfOptions = new PdfOptions();
pdfOptions.InkOptions.HideInk = true;

presentation.Save("presentation_without_ink.pdf", SaveFormat.Pdf, pdfOptions);

スライドを画像としてレンダリングする際にインク オブジェクトを非表示にする

スライドをビットマップ画像としてレンダリングする際にインク オブジェクトを非表示にするには、RenderingOptions.InkOptions を設定し、レンダリング オプションを ISlide.GetImage メソッドに渡します。

次の C# サンプルは、インク オブジェクトを除いた PNG 画像として最初のスライドをレンダリングします:

using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("presentation.pptx");
var renderingOptions = new RenderingOptions();
renderingOptions.InkOptions.HideInk = true;

using var image = presentation.Slides[0].GetImage(renderingOptions);
image.Save("slide_without_ink.png", ImageFormat.Png);

インク マスクのレンダリングを制御

IInkOptions.InterpretMaskOpAsOpacity プロパティは、インク ブラシをレンダリングする際にマスク操作がどのように解釈されるかを制御します。デフォルト値は true で、不透明度として扱われます。false に設定すると、代わりに ROP 操作が使用されます。

次の C# サンプルは、スライドを SVG にエクスポートし、インク マスク操作に ROP ベースのレンダリングを使用します:

using System.IO;
using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("presentation.pptx");
var svgOptions = new SVGOptions();
svgOptions.InkOptions.InterpretMaskOpAsOpacity = false;

using var stream = File.Create("slide.svg");
presentation.Slides[0].WriteAsSvg(stream, svgOptions);

プレゼンテーションをエクスポートする場合やスライドを TIFF にレンダリングする場合も、TiffOptions.InkOptions を使用して同じ設定を適用できます。

インクを非表示にするか保持するかを選択

注釈付きプレゼンテーションのクリーンなバージョン(レビュー マークなしで配布する最終コピーなど)としてエクスポートする場合は、IInkOptions.HideInk を true に設定します。

インク 注釈が意図したコンテンツの一部である(レビュー コメント、手書きメモ、ハイライト、描画など)場合は、IInkOptions.HideInk をデフォルトの false のままにしてください。これにより、アプリケーションは同じプレゼンテーションからソースのインク オブジェクトを変更せずに、レビュー用と最終用の別々の出力を生成できます。

FAQ

既存のインク ストロークの色やサイズを変更できますか?

はい。IInk.Traces からトレースを取得し、IInkTrace.Brush を変更します。ブラシの IInkBrush.Color と IInkBrush.Size プロパティを設定できます。

インクを非表示にすると元のプレゼンテーションが変更されますか?

いいえ。IInkOptions.HideInk は、レンダリングまたはエクスポートされた結果にのみ影響し、ソースのプレゼンテーション内のインク オブジェクトを削除したり変更したりしません。

どのエクスポート形式がインク オプションをサポートしていますか?

上記の対応するエクスポートまたはレンダリング オプションを使用して、PDF、HTML、SVG、TIFF、ビットマップ スライド画像のインク オプションを構成できます。

さらに読む