PDFで見出しを設定する一般的な方法は/F1 1 Tf 10 0 0 10 72 700 Tm (Total) Tj ( due) Tjです。フォントサイズを1とし、実際のサイズはテキスト行列に持たせます。これを手作りのPDF-SVGコンバーターに食わせると、2つ目のランはしばしば1つ目のほぼ真上に着地します。"Total"の5グリフが平均して半emだとすると、テキスト原点は2.5テキスト空間単位動くはずで、行列はそれを25ポイントへ変換します。2.5を行列の平行移動に素直に足すコンバーターはペンをその1/10しか動かせず、" due"は直前の語に重ね打ちされます
ISO 32000-1の§9.4.4は、テキスト空間内の変位がテキスト行列を通ることを明示しており、更新はe += tx*aとf += tx*bであって、eへの素の加算ではありません。これは、要素を書き出すその瞬間にPDFの状態をSVG属性へ運ばなければならない多くの場所の1つにすぎません。以下、この記事はその残りを順にたどります
BuildLoadedPageSVGで読み込み済みページをエクスポートする
HotPDFは、読み込み済みドキュメントの任意のページをスタンドアロンのSVG 1.1ファイルとしてエクスポートします。THotPDF.BuildLoadedPageSVGは0始まりのページインデックスを受け取り、ドキュメント全体をAnsiStringで返します。エクスポートできないページでは空文字列を返します。SaveLoadedPageAsSVGは同じマークアップをファイルへ書き出し、失敗するとFalseを返します。両者にはEmbedFontsフラグを持つオーバーロードがあり、後述します
エクスポートされるページのサイズはクロップボックスから取られます。幅と高さはポイントで書き出され、viewBoxはPDFユーザー単位を使うので、SVGの1単位はPDFの1単位です。パス、テキストラン、画像XObject、インライン画像、シェーディング、タイリングパターン、クリッピングパス、Type 3グリフ、ネストしたフォームXObjectがすべて出力に現れ、ラスター内容はbase64のPNGデータURIとしてファイル内を旅します
var
Pdf: THotPDF;
I: Integer;
begin
Pdf := THotPDF.Create(nil);
try
if Pdf.LoadFromFile('statements.pdf', '') <= 0 then
Exit; // LoadFromFileはページ数を返す
for I := 0 to Pdf.LoadedPageCount - 1 do
if not Pdf.SaveLoadedPageAsSVG(I, Format('page-%d.svg', [I + 1])) then
Writeln('Page ', I + 1, ' could not be exported');
finally
Pdf.Free;
end;
end;
コンパイル済みのDelphiプログラムを必要とすべきでないビルドパイプラインのために、HotPDFのコマンドラインツールは同じエクスポートをHotPDFCLI export-svg <pdf-file> [-o prefix] [--pages range]として公開しています。SVGはテキストなので、PDFページをビットマップへ描画するラスター経路の良い相棒になります。ビットマップはページの見た目を示し、SVGはどのオブジェクトがそれを描いたのかを、テキスト差分が読める形で示します
1回のページ反転がグリフと写真を壊す理由
PDFのユーザー空間は左下隅から上向きに伸び、SVGは左上から下向きに伸びます。ページ全体を1度反転すればすべての座標は直りますが、同時にすべての文字とすべての写真が鏡像になります。残る2つの食い違いはもっと静かです。PDFはスタックで状態をスコープ化し(qでプッシュ、Qでポップ)、SVGは要素が祖先グループの宣言を継承します。そしてPDFはいくつかのことを慣習で表現します。線端と線結合は整数、幅ゼロは「見える最細線」を意味し、演算子の別形が巻数規則を切り替えます
BuildLoadedPageSVGは反転を1つのページ前置変換で処理し、テキストと画像はローカルに補正します。すべてのテキスト要素は「ページ前置変換 × CTM × テキスト行列 × matrix(1,0,0,-1,0,0)」のチェーンを保持します。右端の因子がグリフを自分のフレーム内で再び直立させ、ベースラインはページ反転が置いた位置に留まります。補正が特別扱いではなく行列であるため、回転、鏡像、せん断されたテキストに追加のコードは要りません
画像には別の因子が付きます。PDFの画像空間は最初のサンプル行を単位正方形の上端に置く一方、SVGのimage要素は独自のy下向きフレームを持つため、出力される変換はCTMにmatrix(1,0,0,-1,0,1)を右乗算したものです。符号を間違えると、ページのベクター内容は完璧なのにすべての写真が逆さまに吊るされます
/Rotateエントリを持つページは、反転の前にy上向き表示空間での回転を追加します。90度なら(0,-1,1,0,0,W)、180度なら(-1,0,0,-1,W,H)、270度なら(0,1,-1,0,H,0)です。WとHは回転前のページサイズで、反転は回転後キャンバスの高さを使います。ページボックスは原点から始まるとも限りません。クロップボックスが[100 100 712 892]のページでは、エクスポーターは回転の前に左下隅を(0,0)へ移動します。ラスター描画側が取るのと同じ手順で、これを欠くと内容はキャンバスから100単位ずれて着地します
テキスト行列と文字ごとの位置
各テキストランは1つのSVGtext要素になり、そのx属性は文字ごとの位置を列挙します。位置はグリフのアドバンスに文字間隔Tcを加えて積み上がり、単語間隔Twはシングルバイトのコード32の後にだけ加算されます。偶然32に等しい2バイトのコードには単語間隔は付かず、これがISO 32000-1の§9.3.3が定める挙動で、CIDキー付きフォントが依存しているものです。合字のように1グリフが複数文字を表す場合は、各文字が依然として固有のx値を得られるよう、文字たちはそのアドバンスを分け合います
水平スケーリングとテキストライズは、§9.4.4に従い[Th 0 0 1 0 Trise] × Tmとしてテキスト描画行列に折り込まれるため、変換されたテキスト行列とともにスケールし回転します。TJ配列内のカーニング数値はemの1/1000単位で、他の水平移動と同様にThが乗算されます
XMLの細部で重要なものが2つあります。すべてのtext要素はxml:space="preserve"を持ちます。これがないとビューアが空白の連なりを圧縮し、xリストが文字と歩調を合わせなくなります。そしてファイルはUTF-8なので、文字はシステムコードページを経由せず明示的にUTF-8で符号化されます。XML 1.0が禁じるコードポイント(0x20未満の制御文字、サロゲート、U+FFFEとU+FFFF)はU+FFFDに置き換えられます。複雑なスクリプトのシャーピングからのテキストも同じ経路をたどります。シャーパーがクラスタを位置付きグリフへ変換し終えてからコンテンツストリームが書かれるからです
名前付きフォントか、埋め込みアウトラインか
デフォルトではテキストはフォント名を持ちます。エクスポーターは/BaseFontとフォント記述子からファミリーを導出し、Arial, sans-serifのような総称フォールバックを加えます。ビューアはインストール済みフォントでテキストを描きます。ファイルは小さく保たれ、テキストは完全に生き続けますが、埋め込みのコーポレート書体で組まれたページは、そのフォントを持たないマシンでは代替フォントで描かれ、その幅は文字ごとの位置と一致しなくなります
EmbedFontsにTrueを渡すと、埋め込みフォントプログラムのグリフがdefsブロック内のアウトラインとして書き出され、ページ上のすべての出現箇所で共有されます。元のテキストは塗り不透明度ゼロでその上に書かれたままなので、選択も検索も可能です。SVGが作成元のマシンを離れるときは常にTrueを使ってください。デザインの引き渡し、アーカイブ、CIエージェントでのビジュアル差分などがこれに当たります。ファイルがフォントを持つ環境の中に留まり、サイズが重要な場合はデフォルトを使います
procedure ExportOutlined(Pdf: THotPDF);
var
Svg: AnsiString;
Output: TFileStream;
begin
// 埋め込みフォントのグリフアウトライン、選択可能なテキストはその上に
Svg := Pdf.BuildLoadedPageSVG(0, True);
if Svg = '' then
raise Exception.Create('Page 1 could not be exported');
Output := TFileStream.Create('page-1-outlined.svg', fmCreate);
try
Output.WriteBuffer(Svg[1], Length(Svg));
finally
Output.Free;
end;
end;
描画モードは両方の経路で尊重されます。モード1は塗らずにストロークし、モード2は塗りとストローク、モード3は不可視でもペンを進め、モード4から7はグリフをクリッピングパスへ追加します。ストロークされたグリフにはもう1つ補正が必要です。線幅はユーザー空間に住み、text要素はテキスト空間で描くため、幅はテキスト行列のスケールで割られます。したがって2 Tr 0.25 wで太くされたテキストは1/4ポイントのアウトラインを保ち、SVGデフォルトの1単位のままにしておくと重たく見えます
グラフィックス状態が各要素に運ぶもの
SVGのプレゼンテーション属性はPDFのスコープに従わないため、すべてのパスはその時点で有効な完全なストローク状態とともに書かれます。線端の0、1、2はbutt、round、squareになり、線結合の0、1、2はmiter、round、bevelになります。マイター制限、破線配列、破線位相は設定されているときに書かれます。負の項目を含む破線配列、正の項目を1つも持たない非空の配列は無視され、前のパターンが残ります。空の配列[]は実線を復元します。同じ値はExtGState辞書経由でも届くことがあり、そのLW、LC、LJ、ML、ca、CAキーも同様に適用されます
PDFでの幅ゼロは、デバイスが描ける最細の線を意味します。それを文字通りコピーすると見えないストロークになり、1としてコピーするとズームのたびに太くなる線になります。エクスポーターはstroke-width="1"とvector-effect="non-scaling-stroke"を併せて書き出し、どの拡大率でも極細線をほぼ1デバイスピクセルの幅に保ちます。星付き演算子f*、B*、b*はfill-rule="evenodd"を追加し、素の形はSVGのデフォルトである非ゼロ巻数を保ちます
Qは塗りとストロークの色、不透明度、線幅、線端、線結合、マイター制限、破線配列と位相、そしてテキスト状態をも復元します。ISO 32000-1の§9.3.1はテキスト状態をグラフィックス状態の一部としているため、q … Qの内側で設定された2 TrがQの後のテキストをストロークしてはなりません。クリッピングは§8.5.4に従います。Wはパスをマークするだけで、クリップは描画演算子の後に効くため、re W fはまず矩形を塗ってからクリップします。各クリップはclipPathとラッピンググループになり、Qは対応するq以降に開かれたグループを閉じます
フォームXObjectは暗黙のq … Qとして振る舞います。エクスポーターはフォームをその/BBoxでクリップし、進入時に状態を保存し、退出時に復元するので、スタンプ内の破線枠がその後のページ内容へ漏れ出すことはありません。タイリングパターンは、それを使うコンテンツストリーム(ページまたはフォーム)のデフォルト空間へ写像され(§8.7.2)、パターンが描かれる時点のCTMには従いません。EMFとWMFのベクターインポートは逆方向に似た状態モデルを走らせ、フォームXObjectとしてのSVGインポートはSVGからPDFへの逆の旅を扱います
色、シェーディング、そしてテストが比較する文字列
色はすべてのPDFカラーオペレータを通じてSVGへ届きます。g、rg、kとそれらのストローク版、さらにページやフォームの/ColorSpaceリソースから名前付き空間を取るcs / scnです。Separation、DeviceN、ICCBased、Indexed、Labの色は、ページ描画側が使うのと同じ色空間コードでRGBへ解決されます。csでの空間選択は§8.6.8が定める初期色から始まります。デバイス空間では黒、SeparationとDeviceNではティント1.0、Indexedではインデックス0です。SVGにはインキの概念がないため、スポットカラーはそのRGBでの見た目として届き、インキ名はPDFの中に留まります。本物の分解版を必要とする校正仕事は、SeparationとDeviceNのスポットカラーの描画で説明するペインティングモデルの管轄です
アキシアルとラジアルのシェーディングはSVGグラデーションになります。仕様は/Extendのデフォルトを[false false]としており、t0の前でもt1の後でも何も描かないことを意味します。一方SVGのpadスプレッドは端の色を外側へ描きます。エクスポーターは、延長しない端に完全に透明なストップを追加してこの差を橋渡しします。関数ベースのシェーディングは単位あたり約1サンプルで画像へサンプリングされ、メッシュシェーディングは埋め込み画像へ描画されます
16進の色は大文字で出力されます。文字列を比較する回帰テストは#FF0000を期待する必要があり、小文字で書かれたテストは完全に正しい出力で失敗します。座標と幅は小数点以下4桁に丸められ、transform行列は9桁の有効数字を保持します。どちらも小数点区切りはピリオドで、テストを実行するマシンのロケールに左右されません
procedure CheckRedRectangle(Pdf: THotPDF);
var
Svg: AnsiString;
begin
Svg := Pdf.BuildLoadedPageSVG(0);
// Assertは自前のテストで追加するチェックであり、エクスポートの一部ではない
Assert(Pos(AnsiString('fill="#FF0000"'), Svg) > 0,
'expected the red fill in uppercase hex');
Assert(Pos(AnsiString('xml:space="preserve"'), Svg) > 0,
'text elements keep their spaces');
end;
この種の文字列チェックは、入力PDFが自前のコードで生成され、期待する色がわかっているときに持ちこたえます。外部から来るページには、2つのビルドのSVG同士を比較するほうが、どのハードコードされた属性よりも多くを捉えます。描画から編集、エクスポートまで、読み込み済みドキュメントを扱うツールキットの残りは、HotPDF Delphi PDFコンポーネントのページに説明があります