PolyPDFプラグインの仕組み

PolyPDF は、CAD ファイルではなく PDF 図面を使用して作業する人々、つまり単独のエンジニア、建築家、見積もり担当者、およびその周囲の小規模チーム向けのデスクトップ アプリです。その中心となるドキュメント、注釈、測定、エクスポートの作業は、Mac と Windows 上でローカルに行われます。マップ、ライセンスのアクティベーション、アップデート、購入、サポートには接続が必要な場合があります。

このローカルファーストの形状は、追加するものすべてに制約を設定します。プラグインはその内部で設計されています。パッケージには、ダウンロードされた実行可能コードやサブスクリプション サービスではなく、署名されたデータとアートワークが含まれます。

現在のアクセス: プラグイン コンテンツのインストール、実行、編集には PolyPDF Pro が必要です。すでに PDF 上に配置されているコンテンツは、通常のドキュメント コンテンツのままです。

プラグイン パッケージには、データ テーブル、サニタイズされた SVG または PNG アートワーク、およびユーザーが入力するフォームの宣言的記述を含めることができます。実行可能なプラグイン JavaScript は含めません。パッケージは、PolyPDF の固定のホスト所有ジェネレーターの 1 つを指定し、そのジェネレーターに制限された入力を提供します。

この設計により、攻撃対象領域が狭まります。任意のファイルが無害になるわけではありません。パッケージには、構造化された値、ラベル、オプション、グラフィックを含めることができます。したがって、PolyPDF はアーカイブとマニフェストを検証し、サポートされているアートワークをサニタイズし、宣言されたアクセス許可を強制し、何かが挿入される前に独自のジェネレーターによって生成された注釈と画像アセットを検証します。

パッケージのインストール前に確認される内容

• バンドルおよびカタログ配信パッケージでは、すべてのファイルをカバーする SHA-256 ダイジェスト上に Ed25519 署名が使用され、さらに各ファイルに対して個別の SHA-256 チェックが使用されます。
• カタログのインストールは、署名されたカタログがパッケージのチェックサムを固定している場合にのみ受け入れられます。ユーザーが直接選択したファイルには、代わりに自己署名を付けることができます。同意画面ではそのソースを特定し、承認後に作成者キーを固定します。
• 厳密なレイアウト許可リスト - パッケージには、マニフェスト、フォーム スキーマ、署名、データ、アセット、アイコン フォルダーのみを含めることができます。それ以外のものはすべて拒否されます。
• パスの安全性とシンボリックリンクのチェックにより、トラバーサル、絶対パス、重複エントリが拒否されます。
• アーカイブ、各メンバー、およびメンバー数のサイズ上限。

許可モデル

プラグインは、現在のドキュメント コンテキストの読み取り、注釈の作成、ワークスペースでの画像アセットの作成の 3 つの権限のうちどれが必要かを宣言します。詳細ビューまたはサイドロードレビュービューには、わかりやすい言葉でリストが表示されます。これらの権限を超えたジェネレーターの結果は拒否されます。

ジェネレーター ダイアログは、PolyPDF によってプラグインのフォーム スキーマから描画されます。プラグインはフィールドを説明します。アプリがそれらをレンダリングします。パッケージ内の何もインターフェイスを直接制御するものはありません。

プラグインは 1 つのプラグイン ウィンドウで管理され、PolyPDF に含まれるパッケージと自分でインストールしたパッケージの単一のリストが表示されます。詳細ページには、発行者、インストールされているバージョン、権限、コマンド、互換性、パッケージのソースとサイズ、リリース ノート (存在する場合)、およびプラグインが有効かどうかが表示されます。

• 同じウィンドウから、使用可能な以前のバージョンを有効化、無効化、アンインストール、ロールバックします。
• 「ファイルからインストール…」では、ソース、署名者、権限、ダウングレードまたは再インストールのコンテキストを含む、ユーザーが意図的に選択したパッケージの同意レビューが開きます。
• 同意されたサイドロードは、同じバージョンを再インストールすることも、古いバージョンをインストールすることもできます。レビュー画面には、承認する前にこれから何が起こるかが表示されます。
• プラグインをアンインストールしても、すでに生成されたコンテンツには影響しません。そのコンテンツはドキュメントの一部であり、プラグインの一部ではありません。

PolyPDF には 3 つのファーストパーティ ジェネレーターが搭載されており、最初の実行時にそれらが有効になります。 「アップデートの確認」は、ビルドにアップデート ソースが構成されている場合にのみ表示されます。通常の出荷設定には、[検出]、[インストール済み]、または [更新] タブやカタログ更新アクションはありません。

マーケットプレイスや公開提出ディレクトリはありません。 [ファイルからインストール] は、ユーザーが選択したサードパーティ パッケージの明示的なパスであり、その同意画面では、そのパッケージと PolyPDF が提供するソフトウェアとが区別されます。

サポートされている指定 (W24X55、L6X6X1/2、HSS8X8X1/2、PIPE6 など) を入力し、慣用単位またはメートル単位と注釈スケールを選択すると、PolyPDF が断面プロファイルをシート上に描画します。

プロファイルは実際のベクトル ジオメトリであり、貼り付けられたビットマップではなくポリゴン アノテーションとして配置されます。どのズームでも鮮明なままで、指定したサイズで印刷されます。ハイスやパイプなどの中空形状は内側のループで描画されるため、肉厚は実際の肉厚になります。

AISC Steel Sections は断面プロファイルを描画します。容量、コード、または設計のチェックは実行されません。バンドルされたデータは、完全なデータベースではなく、W、M、S、HP、C、MC、L、WT、HSS、HSS-Round、および Pipe ファミリ全体にわたって厳選された 57 形状のサブセットであるため、設計上の決定を行う前に、指定を信頼できるリファレンスと照合して確認してください。

Professional Engineer または Architect を選択し、管轄区域 (50 州とコロンビア特別区) を選択し、管轄区域のテンプレートで要求されるフィールドに入力し、挿入する前にライブ プレビューでシールが構築されるのを確認します。

出力は、テンプレートから生成されたグラフィックです。これは暗号署名ではないため、暗号署名を挿入しても文書に署名されません。 PolyPDF のデジタル署名ツールは別のものであり、検証者がチェックできる署名が必要な場合は、それが使用するパスになります。

Seal Maker のシールはグラフィック アートワークであり、暗号化されたデジタル署名ではありません。 PolyPDF はライセンス ステータスをチェックせず、テンプレートがボードの現在の要件に一致するかどうかを確認しません。シールに名前が表示される資格のある専門家は、シールの外観、文言、および使用について責任を負います。

住所、都市、または場所の名前を入力し、世界ビューから建物レベルまでのズーム レベルを設定し、ページに地図画像を挿入します。 PolyPDF 内では結果を調整できます。ダブルクリックして小さなエディターでパンとズームを行い、ビューを保存します。他の PDF ビューアでは、プレーン画像になります。

場所の検索は、openstreetmap.org の Nominatim を通じてジオコーディングされます。画像自体は、OpenMapTiles スキーマを使用して OpenFreeMap ベクター タイルからレンダリングされます。 PolyPDF は、「OpenFreeMap © OpenStreetMap からの OpenMapTiles データ」を生成された画像 (または、スペースが必要な場合は短いレイアウト フォーム) に焼き込むため、クレジットは PDF とともに移動します。

PDF マップでは、場所を解決して OpenFreeMap タイルをレンダリングするときにインターネット接続が必要です。挿入すると、PDF に含まれる自己完結型の画像注釈が作成されます。

MUTCD サインはプラグインではありません。これらはツールセットとして PolyPDF に組み込まれています。規制チェストには 435 枚のサインカードが含まれています。 R1-1 Stop を選択して配置すると、他のページ コンテンツと同様に移動、サイズ変更、削除できる画像注釈が作成されます。

以下の例では、サンプルのトラフィック制御シートで参照と配置のワークフローを実行します。標識のアートワークは、FHWA 標準高速道路標識 2024 リリースからのものです。

すべてのプラグインは同じパスをたどります。一度学習すれば、次の学習にも応用できます。

1. プラグインマネージャーを開きます。 macOS の場合: PolyPDF ▸ プラグイン…。 Windows の場合: [ツール] ▸ [プラグイン] ▸ [プラグイン…]。
2. 単一のリスト内の行を選択し、その詳細ページ (発行者、インストールされているバージョン、要求されたアクセス許可、ソース、互換性、コマンド) を読みます。
3. 自分で入手したパッケージの場合は、[ファイルからインストール…] を選択し、同意する前に署名者、ソース、権限、再インストールまたはダウングレードの警告を確認します。ここに描かれている 3 つの発電機はすでに設置されています。
4. [ツール] ▸ [プラグイン] からプラグインを実行し、次のコマンドを選択します: [AISC 鋼材セクションを挿入…]、[プロフェッショナル シールを挿入…]、または [マップを挿入…]。
5. ジェネレーターダイアログに入力します。入力するとプレビュー パネルが再描画されるため、ドキュメントに触れる前に結果が表示されます。
6. 「挿入」を選択します。コンテンツは、1 回の元に戻す手順で通常の注釈として配置されます。1 回の元に戻すと、挿入全体が削除されます。
7. その注釈タイプでサポートされている編集操作を使用します。ベクター プロファイルは、移動、サイズ変更、スタイル変更、削除が可能です。画像ベースの出力は、移動、サイズ変更、または削除できます。

ページに表示されるのは、ベイクされた外観ストリームで書かれた標準の PDF 注釈 (鉄鋼セクションのポリゴン、シールまたは地図のスタンプ) です。コンテンツはプラグインではなくドキュメントに属しているため、プラグインをアンインストールしてもコンテンツはそのまま残ります。

最初の 3 つのジェネレーターは、意図的に似ていません。ベクトル ジオメトリを描画するデータ ルックアップ、画像を構成するテンプレート、および外部サービスにアクセスするジェネレーターです。それぞれが、パッケージ形式が次に何をサポートする必要があるかについて、異なることを教えてくれます。

プラグインによって 1 週間が楽になる場合は、プラグインが何を生成し、何を要求するかを教えてください。 support@polypdf.com までご連絡ください。