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ı
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
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