Teknik Makale

HotPDF ile Delphi'de PDF Sayfalarını SVG'ye Aktarma

PDF'de bir başlık kurmanın yaygın yolu /F1 1 Tf 10 0 0 10 72 700 Tm (Total) Tj ( due) Tj şeklindedir: 1 yazı tipi boyutu ve gerçek boyut metin matrisi tarafından taşınır. Bunu el yapımı bir PDF-SVG dönüştürücüsüne verirseniz ikinci bölüm (run) çoğu zaman neredeyse ilkinin üzerine düşer. "Total"in beş glifinin ortalama yarım em taşıdığını varsayın; metin başlangıcı 2,5 metin uzayı birimi kaymalı ve matris bunu 25 puana çevirmeli. 2,5'i doğrudan matrisin öteleme terimine ekleyen bir dönüştürücü kalemi yolun onda birine taşar ve " due" önceki sözcüğün üstüne basar

ISO 32000-1 §9.4.4, metin uzayındaki yer değiştirmelerin metin matrisinden geçtiğini açıkça söyler; yani güncelleme e += tx*a ve f += tx*b şeklindedir, asla e terimine düz bir ekleme değildir. PDF durumunun bir öğe yazıldığı tam anda SVG özniteliklerine taşınması gereken yerlerden biri budur; bu yazının geri kalanı onları tek tek geziyor

BuildLoadedPageSVG ile yüklü bir sayfayı dışa aktarmak

HotPDF, yüklü bir belgenin herhangi bir sayfasını bağımsız bir SVG 1.1 dosyası olarak dışa aktarır. THotPDF.BuildLoadedPageSVG sıfır tabanlı bir sayfa dizini alır ve tüm belgeyi bir AnsiString olarak döndürür; sayfa dışa aktarılamazsa boş dize döner. SaveLoadedPageAsSVG aynı işaretlemeyi bir dosyaya yazar ve başarısızlıkta False döndürür. İkisinin de aşağıda ele alınan EmbedFonts bayraklı bir aşırı yüklemesi (overload) vardır

Dışa aktarılan sayfa boyutunu crop box'tan alır. Genişlik ve yükseklik punto olarak yazılır ve viewBox PDF kullanıcı birimlerini kullanır; SVG'deki bir birim, PDF'deki bir birimdir. Yollar, metin bölümleri, görüntü XObject'leri, satır içi görüntüler, gölgelendirmeler, döşeme desenleri (tiling pattern), kırpma yolları, Type 3 glifleri ve iç içe Form XObject'leri hep çıktıya ulaşır ve raster içerik, dosyanın içinde base64 PNG data URI'leri olarak yolculuk eder

var
  Pdf: THotPDF;
  I: Integer;
begin
  Pdf := THotPDF.Create(nil);
  try
    if Pdf.LoadFromFile('statements.pdf', '') <= 0 then
      Exit;                  // LoadFromFile sayfa sayısını döndürür
    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;

Derlenmiş bir Delphi programına ihtiyaç duymaması gereken derleme hatları için HotPDF komut satırı aracı aynı dışa aktarmayı HotPDFCLI export-svg <pdf-file> [-o prefix] [--pages range] olarak sunar. SVG metindir; bu, onu PDF sayfasını bitmap'e render etme başlığındaki raster yol için iyi bir ortak yapar: bitmap sayfanın neye benzediğini gösterir, SVG ise hangi nesnelerin çizdiğini, bir metin diff'inin okuyabileceği biçimde gösterir

Tek bir sayfa çevirmesi neden glifleri ve fotoğrafları bozar?

PDF kullanıcı uzayı sol alt köşeden yukarı büyür; SVG sol üstten aşağı büyür. Tüm sayfayı bir kez çevirmek her koordinatı düzeltir ve aynı hamlede her harfi ve her fotoğrafı aynalar. Diğer iki uyumsuzluk daha sessizdir. PDF durumu bir yığınla kapsamlar (q iter, Q çıkarır); SVG ise bir öğenin, atası olan grubun bildirdiği her şeyi devralmasına izin verir. Ve PDF birkaç şeyi kurala göre ifade eder: büyük ve birleşim uçları için tam sayılar, "görünür en ince çizgi" anlamına gelen sıfır genişlik, sarma kuralını değiştiren operatör varyantları

HotPDF, Delphi'den sayfa dışa aktarırken durumlu PDF içerik akışını bildirimsel bir SVG ağacına eşler; y-ekseni başlangıçları, yığın kapsamları ve tamsayı kuralları boyunca
Durumlu PDF içerik akışı bildirimsel SVG ağacıyla karşılaşır ve üç uyumsuzluğun üçü de kopyalamak değil çevirmek ister

BuildLoadedPageSVG çevirmeyi tek bir sayfa ön dönüşümüyle halleder ve metni ile görüntüleri yerelde düzeltir. Her metin öğesi, sayfa ön dönüşümü × CTM × metin matrisi × matrix(1,0,0,-1,0,0) zincirini taşır. Sağdaki çarpan glifleri kendi çerçeveleri içinde yeniden dikiltir ve taban çizgisini sayfa çevirmesinin koyduğu yerde bırakır. Düzeltme özel bir durum değil bir matris olduğundan, döndürülmüş, aynalanmış ve eğrilmiş metin ekstra kod gerektirmez

Görüntüler farklı bir çarpan alır. PDF görüntü uzayı ilk örnek satırı birim karenin üstüne koyarken SVG image öğesinin kendi y-aşağı çerçevesi vardır; bu yüzden yayılan dönüşüm, CTM'nin matrix(1,0,0,-1,0,1) ile sağdan çarpımıdır. İşareti yanlış seçerseniz sayfanın vektör içeriği mükemmel olurken her fotoğraf baş aşağı asılı kalır

/Rotate girdisi taşıyan sayfalar, çevirmeden önce y-yukarı görüntüleme uzayında bir döndürme ekler: 90 derece için (0,-1,1,0,0,W), 180 için (-1,0,0,-1,W,H) ve 270 için (0,1,-1,0,H,0); W ve H döndürülmemiş sayfa boyutlarıdır ve çevirme, döndürülmüş tuvalin yüksekliğini kullanır. Sayfa kutusunun başlangıç noktası da kaymış olabilir. Crop box'ı [100 100 712 892] olan bir sayfada dışa aktarıcı, döndürmeden önce sol alt köşeyi (0,0)'a taşır — raster renderlayıcının aldığı adım da budur; aksi halde içerik tuvalin yüz birim dışına düşer

HotPDF /Rotate 90, 180 ve 270 için sayfa döndürme ön dönüşümlerini birleştirir ve CTM'yi matrix(1,0,0,-1,0,1) ile sağdan çarpar; böylece Delphi PDF-SVG dışa aktarımı gömülü görselleri dik tutar
Sayfa döndürme ön dönüşümleri ve görüntü çevirme matrisi, döndürülmüş sayfaları ve fotoğrafları dışa aktarılan SVG'de dik tutar

Metin matrisleri ve karakter başına konumlar

Her metin bölümü, x özniteliği her karakter için bir konum listeleyen tek bir SVG text öğesine dönüşür. Konumlar, glif ilerlemesine karakter aralığı Tc eklenerek birikir; kelime aralığı Tw yalnızca tek baytlık 32 kodundan sonra eklenir. Tesadüfen 32'ye eşit olan iki baytlık bir kod kelime aralığı almaz; ISO 32000-1 §9.3.3'ün öngördüğü ve CID tabanlı yazı tiplerinin dayandığı davranış budur. Bir ligatürde olduğu gibi bir glif birkaç karakteri temsil ettiğinde, karakterler ilerlemesini paylaşır, böylece her biri yine de kendine ait bir x değeri alır

Yatay ölçekleme ve metin yükseltmesi, §9.4.4'ü izleyerek [Th 0 0 1 0 Trise] × Tm biçiminde metin render matrisine katlanır; böylece dönüştürülmüş bir metin matrisiyle birlikte ölçeklenir ve döner. Bir TJ dizisinin içindeki kerning sayıları binde bir em'dir ve her öteki yatay hareket gibi Th ile çarpılır

İki XML ayrıntısı önemlidir. Her text öğesi xml:space="preserve" taşır; olmadığında bir görüntüleyici boşluk dizilerini daraltır ve x listesi karakterlerle adım dışı kalır. Ve dosya UTF-8'dir; karakterler sistem kod sayfasından geçirilmek yerine açıkça UTF-8 olarak kodlanır. XML 1.0'ın yasakladığı kod noktaları (0x20 altı kontrol karakterleri, vekiller, U+FFFE ve U+FFFF) U+FFFD ile değiştirilir. Karmaşık betik şekillendirme metni de aynı yolu izler; çünkü şekillendirici, kümeleri içerik akışı yazılmadan önce konumlandırılmış gliflere çoktan çevirmiştir

Adla anılan yazı tipleri ya da gömülü dış hatlar

Varsayılan olarak metin, yazı tipini adıyla anar: dışa aktarıcı /BaseFont ve yazı tipi tanımlayıcısından bir aile türetir, Arial, sans-serif gibi genel bir yedeğe ekler ve görüntüleyici metni kurulu bir yazı tipiyle çizer. Bu, dosyaları küçük ve metni tamamen canlı tutar; ama gömülü bir kurumsal yazı tipiyle dizilmiş bir sayfa, o tipi olmayan her makinede bir yedek yazı tipiyle çizilir ve genişlikleri karakter başına konumlarla artık uyuşmaz

EmbedFonts için True geçmek, gömülü yazı tipi programlarının gliflerini bir defs bloğunda dış hatlar olarak yazar; bu blok, sayfadaki tüm tekrarları arasında paylaşılır. Orijinal metin, seçilebilir ve aranabilir kalması için sıfır dolgu opaklığıyla yine üstüne yazılır. SVG'yi üreten makineden ayrılacaksa her zaman True kullanın: bir tasarım teslimi, bir arşiv, bir CI ajanında görsel diff. Dosya, yazı tiplerine sahip bir ortamın içinde kalacaksa ve boyut önemliyse varsayılanı kullanın

procedure ExportOutlined(Pdf: THotPDF);
var
  Svg: AnsiString;
  Output: TFileStream;
begin
  // Gömülü yazı tiplerinden glif dış hatları, üstte seçilebilir metin
  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;

Render modları her iki yolda da dikkate alınır. Mod 1 doldurmadan vuruş yapar, mod 2 hem doldurur hem vuruş yapar, mod 3 görünmezdir ama kalemi yine ilerletir; 4'ten 7'ye modlar glifleri kırpma yoluna ekler. Vuruşlu bir glif bir düzeltme daha ister: çizgi genişliği kullanıcı uzayında yaşarken text öğesi metin uzayında çizer, bu yüzden genişlik metin matrisinin ölçeğine bölünür. 2 Tr 0.25 w ile kalınlaştırılmış metin bu sayede çeyrek puntoluk dış hattını korur; SVG'nin bir birimlik varsayılanında bırakılsaydı ağır görünürdü

Grafik durumunun her öğeye taşıdıkları

SVG sunum öznitelikleri PDF kapsam modelini izlemez; bu yüzden her yol, o an geçerli olan tam vuruş durumuyla yazılır. Çizgi ucu 0, 1, 2 butt, round, square olur; çizgi birleşimi 0, 1, 2 miter, round, bevel olur; miter sınırı, kesik çizgi dizisi ve fazı ayarlıysa yazılır. Negatif bir girdi taşıyan ya da pozitif girdisi olmayan dolu bir kesik çizgi dizisi yok sayılır ve önceki desen kalır; boş dizi [] kesintisiz çizgiyi geri getirir. Aynı değerler bir ExtGState sözlüğüyle de gelebilir; onun LW, LC, LJ, ML, ca ve CA anahtarları da uygulanır

PDF'de sıfır çizgi genişliği, aygıtın çizebileceği en ince çizgi demektir. Olduğu gibi kopyalamak görünmez bir vuruş, 1 olarak kopyalamak her yakınlaştırma adımıyla kalınlaşan bir çizgi verir. Dışa aktarıcı stroke-width="1" ile vector-effect="non-scaling-stroke" yazar; böylece ince çizgi her büyütmede yaklaşık bir aygıt pikseli genişliğinde kalır. Yıldızlı operatörler f*, B* ve b*, fill-rule="evenodd" ekler; düz biçimleri SVG'nin varsayılan sıfır-olmayan sarma kuralını korur

Q, dolgu ve vuruş rengini, opaklığı, çizgi genişliğini, ucu, birleşimi, miter sınırını, kesik çizgi dizisini ve fazını ve metin durumunu geri yükler. ISO 32000-1 §9.3.1 metin durumunu grafik durumunun parçası sayar; bu yüzden q … Q içinde ayarlanan 2 Tr, Q'dan sonraki metni vuruşlu çizmemelidir. Kırpma §8.5.4'ü izler: W yalnızca yolu işaretler ve kırpma, boyama operatöründen sonra geçerli olur; re W f dikdörtgeni önce doldurur, sonra kırpma uygular. Her kırpma bir clipPath artı saran bir gruba dönüşür ve Q, eşleşen q'dan beri açılan grupları kapatır

Form XObject'ler örtük bir q … Q gibi davranır. Dışa aktarıcı bir formu /BBox'ına kırparger, girişte durumu kaydeder ve çıkışta geri yükler; böylece bir damganın içindeki kesikli kenarlık, ardından gelen sayfa içeriğine sızamaz. Döşeme desenleri, onları kullanan içerik akışının (sayfa ya da form) varsayılan uzayına eşlenir; desen boyandığı andaki CTM'sine bakılmaksızın (§8.7.2). EMF ve WMF vektör içe aktarma benzer bir durum modelini ters yönde çalıştırır; Form XObject olarak SVG içe aktarma ise SVG'den PDF'e giden dönüş yolunu kapsar

Renk, gölgelendirmeler ve testlerin karşılaştırdığı dizeler

Renk, her PDF renk operatörü üzerinden SVG'ye ulaşır: g, rg, k ve vuruş biçimleri; ayrıca sayfa ya da form /ColorSpace kaynaklarından adla anılan bir uzayla cs / scn. Separation, DeviceN, ICCBased, Indexed ve Lab renkleri, sayfa renderlayıcının kullandığı aynı renk uzayı koduyla RGB'ye çözümlenir. cs ile bir uzay seçmek §8.6.8'in tanımladığı başlangıç renginden başlar: aygıt uzaylarında siyah, Separation ve DeviceN'de 1.0 ton, Indexed'te 0 indeksi. SVG'nin mürekkep kavramı yoktur; bir spot renk RGB görünümü olarak gelir ve mürekkep adı PDF'de kalır. Gerçek ayrımlar isteyen proofing işi, Separation ve DeviceN spot renklerini render etme başlığındaki boyama modeline aittir

Axial ve radial gölgelendirmeler SVG gradyanlarına dönüşür. Şartname /Extend varsayılanını [false false] tutar; t0'dan önce ya da t1'den sonra hiçbir şey boyanmaz, oysa SVG'nin pad yayılması uç renkleri dışa taşar. Dışa aktarıcı bunu, genişletmeyen her uca tamamen saydam bir durak ekleyerek köprüler. İşlev tabanlı gölgelendirmeler birim başına yaklaşık bir örnekle bir görüntüye örneklenir; ağ (mesh) gölgelendirmeleri gömülü bir görüntüye render edilir

Hex renkler büyük harfle çıkar. Dizeleri karşılaştıran bir regresyon testi #FF0000 beklemeli; küçük harfe karşı yazılmış bir test, tamamen doğru olan çıktıda başarısız olur. Koordinatlar ve genişlikler dört ondalık basamağa yuvarlanır ve transform matrisleri dokuz anlamlı basamağı korur; ikisi de, testi çalıştıran makinenin yerel ayarına bakmaksızın ondalık ayırıcı olarak nokta kullanır

procedure CheckRedRectangle(Pdf: THotPDF);
var
  Svg: AnsiString;
begin
  Svg := Pdf.BuildLoadedPageSVG(0);
  // Assert, kendi testinize eklediğiniz bir denetimdir; dışa aktarımın parçası değildir
  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;

Böyle bir dize denetimi, girdi PDF'yi kendi kodunuzun ürettiği ve beklenen renklerin bilindiği durumlarda sağlamdır. Dışarıdan gelen sayfalar için, iki derlemenin SVG'sini birbiriyle karşılaştırmak, kod içine gömülü herhangi bir öznitelik denetiminden fazlasını yakalar. Yüklü belgeler için render ve düzenlemeden dışa aktarmaya uzanan araç setinin gerisini HotPDF Delphi PDF bileşeni sayfası anlatır