AddInkAnnotation

注釈とホットスポットリンク

説明

ページ上に描いた 1 本以上の手書きストローク、自由形式のマーク、またはフリーハンドスケッチを表すインクマークアップ注釈（PDF /Subtype /Ink）を追加します。/InkList 辞書エントリにはストロークの配列が含まれ、各ストロークはペンダウンからペンアップまでの間にポインティングデバイスがたどったパスを表す x/y 座標の交互配列です。色成分と不透明度は 0–1 スケールで表し、Transparency は 0–100 スケールで指定します（0 = 完全に不透明、100 = 完全に透明）。このエントリポイントは PDF 1.4 注釈の /CA 不透明度キーを出力するため、ライブラリは保存前にロックされていない下位ドキュメントを PDF 1.4 に引き上げます。ロックされた下位ターゲットは互換性ゲートで拒否されます。ISO 32000-1 §12.5.6.13 で定義されています

構文

Delphi

Function TPDFlib.AddInkAnnotation(Const InkPaths: WideString; BorderWidth: Double; InkRed, InkGreen, InkBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

パラメータ

InkPaths — 1 つ以上のストロークを 1 文字列でエンコードします。ストロークは '|' または改行（CR / LF / CRLF）で区切ります。各ストローク内の座標ペアは AddPolygonAnnotation と同じ区切り規約を使用し、x/y 値を空白、カンマ、セミコロン、またはタブで交互に区切ります。例: "100 100 110 105 120 110 | 200 200 210 205" は 2 つの個別ストロークを示します。各ストロークには 2 つ以上の座標ペア（4 個の数）が必要で、値の合計数が偶数でない場合は 0 を返します

BorderWidth — 現在の単位で表したインクのストローク幅

InkRed、InkGreen、InkBlue — /C に書き込むインク色の RGB 成分 (0–1)

Title — 注釈's /T エントリに書き込む作成者名です。省略するには空文字列を渡します

Contents — 注釈に関連付けられたポップアップの本文。スキップするには空文字列を渡します

透明度 — パーセントで表す透過率（0–100）。ライブラリはこれを PDF /CA = 1 - Transparency/100 に変換し、範囲にクランプする

戻り値

成功時は 1、文書が選択されていない、ink 文字列が有効なストロークリストとして解析できない、または注釈を作成できない場合は 0

備考

注釈の /Rect は、すべてのストロークを合わせた範囲に境界線幅に比例する小さな余白を加えて自動計算されるため、レンダリングされたストロークが注釈の境界ボックス内に収まります

このエントリポイントは、タッチまたはペンデバイスから取り込んだ手書き文字と、走り書き署名や他のツールからインポートした注釈などプログラムで生成したフリーハンド図形の両方に適しています。作成後にインク色、境界線、内容、または矩形を上書きするには、SetAnnotBorderColor、SetAnnotBorderStyle、SetAnnotContents、SetAnnotRect を使用します