ドキュメント · PDF ツールキット
MediaBox、CropBox、/Rotate: PDF によるページの定義方法
· 背景
pdf ページジオメトリ 回転
PDF ページには、日常的な意味での固定の「サイズ」はありません。ボックス、単位、および視聴者が解釈する回転値が含まれています。この投稿では、これらのプロパティと、異なる形状のページを結合、回転、透かしマークする場合のそれらの意味について説明します。
結合されたファイルに 2 つのサイズのページがある理由 — A4 文書とレター文書が混在し、結果に両方の形状が表示される
A4 ソースと US Letter ソースを結合しても、すべてのシートが 1 つの長方形に強制されるわけではありません。 ToolAcre は各ページを既存の寸法と回転でコピーするため、出力のサイズを視覚的に切り替えることができます。この動作では、コンテンツを共通のシートに拡大するのではなく、ソース ジオメトリが保持されます。
寸法が混在すると、印刷、サムネイル レイアウト、ウォーターマークの位置、ラスター出力に影響します。結合されたファイルのページ境界を確認し、プリンターのスケーリングを慎重に選択してください。マージは正規化ツールではなく、ファイルが PDF であることは、すべてのページの幅や高さが同じであることを意味するものではありません。
ツールキットは PDF ポイントを使用しますが、一般的な単元履歴のレッスンは提供しません
イメージから PDF への操作は、アプリケーション コードが実際に使用する単位を公開します。マージンはポイント単位で測定されます。フィットした画像ページは、埋め込まれた画像の寸法にマージンの 2 倍を加えたものと一致させることができますが、プリセット シートは構成されたポイントの幅と高さを使用します。この情報源は、この部隊のより広範な歴史を確立していません。
ピクセルは別のパスに入ります。 PDF-to-image は、選択したスケールで pdf.js にビューポートを要求し、それらのピクセル寸法からキャンバスを割り当てます。したがって、ページは安定した PDF ジオメトリを持ちながら、スケールとメモリ ガードに応じてより大きなラスターまたはより小さなラスターを生成できます。ポイントと出力ピクセルは交換可能な設定ではありません。
MediaBox と CropBox の区別は、このインターフェイスでは公開されません
ワークブックでは MediaBox と CropBox が区別されますが、このインターフェイスでは、ユーザーがこれらのボックスを表示、編集、選択することはできません。アプリケーション操作は、ライブラリ ページ オブジェクトに幅と高さを要求し、指定されたとおりにページをコピーします。ボックス優先順位の詳細な説明には、これらのソース以外の直接的な仕様証拠が必要です。
実際的な指示は、目に見える結果を検査することです。ソース ビューアがマークを切り取ったり、予期しない空白を表示したりした場合、マージはボックスを修復するのではなくページを保持します。透かしの配置にはライブラリによって表示される寸法が使用され、PDF-to-image は pdf.js によって提供されるビューポートをレンダリングします。
ツールは、継承されたノードの動作をアサートせずに、ページの回転を読み取り、追加します。
回転は、操作が pdf-lib を通じて読み取るページ角度として保存されます。 ToolAcre は、要求された 4 分の 1 回転を加算し、結果を 0、90、180、または 270 に正規化します。入力値がページ上で直接発生したのか、それとも継承された内部構造を通じて発生したのかは公開されません。
この省略によって使用規則が弱くなるわけではありません。回転は相対的なものです。現在 270 で報告されているページに 90 度を適用すると、0 が生成されます。このツールは、保存されたディメンションを変更しないままにし、コンテンツ ストリームを変換しません。 2 番目のパスが再び追加されるため、別のターンを選択する前に現在の出力を確認してください。
縦向きと横向き — 方向が個別のフラグではなく、ボックスの寸法と回転の結果である理由
縦向きと横向きは、このインターフェイスの個別のコントロールではなく、ページの寸法、コンテンツ、および適用された回転の結果です。 0 度回転したワイド ページと 90 度回転した縦長ページはどちらも横向きに表示されます。ツールキットは方向のラベルを再設定しません。選択した操作に従って寸法をコピーしたり、回転を更新したりします。
これは、混合スキャンにページ固有の処理が必要な理由を説明しています。推測された方向フラグではなく、表示されるコンテンツに基づいて物理的な位置を選択します。画像から PDF へのプリセットの場合、縦向きと横向きは明示的なシート寸法ですが、「各画像に一致」では各画像の幅と高さに基づいてページが作成されます。
ページレベルのツールの結果 — 結合では各ページの独自のボックスが保持され、透かしは各ページのボックスを基準にして配置する必要があります。
Merge では、各ページの独自の寸法と回転が保持されます。透かしは、各ページの幅と高さに対して位置を計算し、ページ幅の一部として画像マークを拡大縮小し、選択したアンカーにテキストを描画します。したがって、固定テキスト サイズは、小さなシートと大きな図面では異なるように感じられる場合があります。
斜めのマークはアンカーを中心に回転し、回転していないマークの測定値に基づいて配置されるため、斜めのスタンプは直感的な中心を占めない場合があります。混合ページ サイズと既存のローテーションをテストします。 PDF-to-image も同様に、ソース ページが異なる場合、選択した 1 つの縮尺の下であっても、混合ピクセル寸法を生成します。
プリプレス ボックスと均一なページ スケーリングはこのツールキットの対象外です
BleedBox、TrimBox、ArtBox、プリプレス面付け、および均一なページ スケーリングは、ここでは実装されていないオプションです。また、このツールキットは、結合中に選択したボックスに合わせてページをトリミングしたり、コピーされたページのサイズを変更したりしません。これらのワークフローには、ジオメトリ制御と出力保証が明示的に文書化されているソフトウェアが必要です。
マージの成功を印刷の正規化として記述することは避けてください。プロフェッショナルな制作の場合は、ページ作業後にプリプレス ツールを使用してボックスと拡大縮小を検査します。 ToolAcre は、規定の動作に基づくコピー、順序付け、四つ折り、マーキング、および変換に適しており、印刷準備ができているページ定義の認証には適していません。
ページごとの寸法と追加の回転により、出荷された操作を予測します
最も有用なジオメトリ モデルはソースに基づいたものです。すべてのページには寸法と現在の回転が含まれます。マージはそれらをコピーし、回転は角度を追加し、ウォーターマークは配置用の寸法を読み取り、ラスター変換はレンダリングされたビューポートをピクセルに変換します。これらの事実は、ユーザーに何が表示されるかを予測します。
また、自動的には起こらないことも特定します。ページは均一化されず、ボックスは編集用に公開されず、コンテンツは回転中に再描画されません。最終ビューアで混合サイズの出力を確認し、オリジナルを保存し、ジョブがこれらのページ レベルの操作を超える場合は、特殊なジオメトリ ツールを使用します。 PDF ツールキットが混合ソース寸法を忠実に保持した後、プリンターが独自のフィット動作を強制する可能性があるため、印刷の場合はスケーリング設定を個別に確認してください。印刷プレビューでは、ローカル ページ コピー自体ではなくコピー先の設定によって発生するクリッピングや予期しないセンタリングが明らかになることがあります。最大シートと最小シートを 1 回追加チェックすると、混合パケット全体が印刷される前にスケーリングの仮定が明らかになることがよくあります。