PDF annotations cloud

Cloud annotationは、小さな円弧で構成されるクラウド状の境界線で囲まれた多角形または矩形の図形を表示する、PDF内の特殊なマークアップアノテーションです。 ( Citation: N.A., 2020 (N.A.). (2020). Document management — Portable document format — Part 2: PDF 2.0 .  International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で定義されているように、cloud annotationは文書レビューワークフローにおいて、特定のコンテンツ領域に注意を引いたり、修正が必要な領域を示すために一般的に使用されます。polygon annotationやpolyline annotationと同様に機能しますが、波状のエッジによって作成される独特の視覚的外観を持っています。

Cloud annotationは、PDF仕様ではpolygon cloud annotationまたはpolyline cloud annotationとして正式に知られており、クラウド状の境界効果を持つ接続された頂点の系列をレンダリングする幾何学的アノテーションです。頂点間を直線で表示する標準的なpolygon annotationとは異なり、cloud annotationはこれらのエッジを自動的に小さな半円状の円弧の系列に変換し、クラウドのような外観を作成します。このアノテーションは図形の頂点を指定する座標配列によって定義され、PDFレンダラーは円弧のサイズと頻度を決定する強度値に基づいて、アルゴリズム的にクラウド効果を適用します。Cloud annotationはマークアップアノテーションのカテゴリーに属するため、ポップアップノート、著者情報、変更日時、レビューステータスインジケーターなどの標準的なアノテーション機能をサポートします。

PDFのレビューおよびコラボレーション機能を実装する開発者にとって、cloud annotationは特別な注意が必要なコンテンツや不確実性のある領域を示すための標準化された方法を提供します。これらは、異なるタイプのマークアップ間の視覚的区別が重要となる、エンジニアリング、建築、法的文書のワークフローにおいて特に価値があります。PDFアノテーションツールや文書管理システムを構築する際、cloud annotationをサポートすることで、ユーザーは単純なハイライトやノートとは明確に区別される、より表現力豊かなマークアップを作成できます。Cloud annotationを正確に解析およびレンダリングする方法を理解することで、さまざまなソースからの文書を処理する際にアプリケーションの忠実度を維持し、ユーザーに標準的なPDFマークアップ機能の全範囲を提供できます。

Cloud annotationは、polygon annotationと同じ基礎データ構造を使用して実装されますが、クラウド状のレンダリングスタイルを指定する追加のBorder Effect（BE）ディクショナリを持ちます。アノテーションディクショナリには、図形の輪郭を定義する座標ペアを含むVertices配列が含まれ、BEディクショナリには値"C"（cloudの略）を持つSエントリと、クラウド境界を形成する個々の円弧セグメントのサイズを制御する強度を指定するIエントリが含まれます。レンダリング時、PDFプロセッサーは頂点間の各線分に沿って小さな円弧の位置を計算し、強度値が線幅の割合として円弧半径を決定します。クラウド効果はレンダリング中に適用され、基礎となる頂点データを変更しないため、必要に応じて同じアノテーションをクラウドと非クラウドの外観間で切り替えることができます。PDFライブラリを使用する開発者は、アノテーション作成コードに適切なBEディクショナリが含まれていること、およびレンダリングエンジンがこれらの値を正しく解釈して特徴的なクラウド外観を生成することを確認する必要があります。

• Polygon annotation – 直線のエッジで閉じた形状を形成する接続された頂点によって定義されるマークアップアノテーション
• Markup annotation – コメントや文書レビューワークフローをサポートするインタラクティブなPDFアノテーションのカテゴリー
• Annotation appearance stream – ページ上でどのようにレンダリングされるべきかを定義するアノテーションの視覚的表現
• Polyline annotation – Polygonと同様ですが、図形が自動的に閉じられない開いたパスのアノテーション
• Border style – 幅、破線パターン、効果など、アノテーション境界線の視覚的外観を制御するプロパティ