PDF user spaceinde (orijin sol altta) x = 560, y = 30 noktasına çizilen bir sayfa numarası, Letter bir sayfanın sağ alt köşesine düşer. Portrait media olarak saklanmış, /MediaBox [0 0 612 792] ve /Rotate 90 taşıyan taranmış bir landscape sayfada aynı çizim çağrısı, numarayı okuyucunun gördüğünün sol kenarından 30 point, altından 52 point yukarıya koyar ve rakamlar kenardan aşağı akar. Damgalama kodu kendisine söyleneni tam olarak yaptı. Herkes bakmadan önce her görüntüleyicinin saat yönünde çeyrek tur çevirdiği bir koordinat sistemine yazdı
Tarayıcılar ve telefon yakalama uygulamaları bu tür sayfaları sürekli üretir; çünkü döndürme bayrağı kurmak, bir JPEGi yeniden kodlamaktan çok daha ucuzdur. Görüntüleyiciler /Rotatee saygı duyar; dosya, ham user spacete çalışan bir şeye kadar iyi görünür: bir damgalama rutini, yerleşimini yalnızca /MediaBoxtan alan bir imposition adımı, kendi yönelim fikri olan bir print RIP. Kalıcı çözüm döndürmeyi düzleştirmektir: turu içerik akışına taşımak ve /Rotatei 0 yaparak saklanan geometri ile gösterilen geometriyi sonunda uzlaştırmak. Tek bir matris gibi görünür. Uygulamada beş sayfa kutusuna, üç tür açıklama geometrisine, sayfayı hedefleyen her linke ve structure treeye uzanır ve ISO 32000-1 her biri için ayrı bir kural koyar
/Rotate bir PDF sayfasını hangi yöne döndürür?
/Rotate, sayfayı görüntüleme ve yazdırma için saat yönünde, 90 derecenin katlarıyla çevirir (ISO 32000-1 §7.7.3.3, Tablo 30). 90 derecede medyanın sol kenarı üst, üst kenarı sağ taraf olur; y-aşağı device spacendeki eşleme X = (y - Bottom) * Scale ve Y = (x - Left) * Scaledir. 270 derecede sağ kenar üst olur. Anahtar kalıtsaldır da: /Resources, /MediaBox ve /CropBox ile birlikte bir /Pages atasının verebileceği dört sayfa özniteliğinden biridir (§7.7.3.4); yani kendi /Rotatei olmayan bir sayfa sözlüğü yine de çevrilmiş olabilir. THotPDF.GetLoadedPageRotation /Parent zincirini yürür, karşılaştığı ilk /Rotatei alır ve 0-359 arasına normalleştirir; saklanmış bir -90 270 olarak döner
Yön, kimsenin fark etmediği bozulan parçadır. 90 ve 270 derece için y bileşenleri yer değiştirmiş bir sayfa-to-device matrisi sayfayı hiç döndürmez — diyagonal boyunca aynalar ve determinant işaret değiştirir. Her iki açı da çevrilmiş görünür. Bitmap takas edilmiş genişlik ve yüksekliğe sahiptir, bir noktayı görünüme ve geriye eşlemek başladığınız noktayı verir; boyut kontrolleri ve gidiş-dönüş testleri şikayetsiz geçer. Hatayı yakalayan şey, bir köşesinde asimetrik bir işaret taşıyan, bağımsız bir renderera karşı piksel piksel karşılaştırılan bir sayfadır; geometri uygulamasını yalnızca kendisiyle test etmek burada pek bir şey kanıtlamaz. HotPDFte FlattenLoadedPageRotation ile RenderLoadedPageToBitmap tek bir saat yönü uzlaşmasını paylaşır; rendererın çevrilmiş bir sayfanın sol üstünde çizdiği köşe, düzleştirmeden sonra da sol üsttedir
FlattenLoadedPageRotation ile bir sayfa aralığını düzleştirmek
THotPDF.FlattenLoadedPageRotation(PageRange, Info), etkin döndürmesi 90, 180 ya da 270 olan PageRangeteki her sayfayı işler ve düzleştirdiği sayfa sayısını döndürür. Boş bir PageRange tüm belge demektir; aksi halde dize, 1 tabanlı '1-3,7' sözdizimini kullanır ve aralığın ötesindeki bir sayfa numarası sessizce aralık dışına düşmek yerine exception fırlatır. Özgün içerik akışları bayt bayt olduğu gibi bırakılır. Metot, q ile bir cm turunu taşıyan yeni bir akışı /Contentsin başına, Q taşıyan bir akışı sonuna koyar ve sonra sayfa sözlüğünün kendisine /Rotate 0 yazar
| Etkin /Rotate | Önek akışı | Yeni MediaBox |
|---|---|---|
| 90 | q 0 -1 1 0 -Bottom Width+Left cm | [0 0 Height Width] |
| 180 | q -1 0 0 -1 Width+Left Height+Bottom cm | [0 0 Width Height] |
| 270 | q 0 1 -1 0 Height+Bottom -Left cm | [0 0 Height Width] |
Açık sıfır göründüğünden daha önemlidir. /Rotate anahtarını silmek daha derli toplu görünür ve 90ını bir /Pages düğümünden almış her sayfayı bozar: sayfa turu yeniden miras alır ve görüntüleyici, zaten dik duran içeriği çevirir. Sayfa sözlüğündeki bir /Rotate 0 o mirası engeller; yazılacak tek güvenli değer budur
var
Pdf: THotPDF;
Info: THPDFRotationFlattenInfo;
Flattened: Integer;
begin
Pdf := THotPDF.Create(nil);
try
if Pdf.LoadFromFile('scanned-batch.pdf') > 0 then
begin
// '' = tüm sayfalar; 0 derecede olan sayfalar sayılır ama dokunulmaz
Flattened := Pdf.FlattenLoadedPageRotation('', Info);
Writeln(Format('Scanned %d, flattened %d pages',
[Info.ScannedPageCount, Info.FlattenedPageCount]));
Writeln(Format('Turned %d annotations, %d destinations, %d tagged geometry entries',
[Info.TransformedAnnotationCount, Info.TransformedDestinationCount,
Info.TransformedStructureGeometryCount]));
if Flattened > 0 then
Pdf.SaveLoadedDocument('scanned-batch-upright.pdf');
end;
finally
Pdf.Free;
end;
end;
THPDFRotationFlattenInfo kaydını çöpe atmak yerine loglayın. ScannedPageCount aralıktaki sayfa sayısıdır, FlattenedPageCount dönüş değeriyle eşleşir ve üç Transformed... sayacı, linklerin, yer imlerinin ya da etiketli geometrinin çevrilen sayfalara işaret edip etmediğini gösterir. Bir tarayıcı yığınında sıfır hedef normaldir; tarayıcılar zaten nadiren link yazar. Bildiğiniz kadarıyla şekil sınırlayıcı kutuları taşıyan ama sıfır yapı geometrisi bildiren bir etiketli PDF/UA dosyası, elle açılacak olan dosyadır
Yazmadan önce tüm sayfa kutularını okuyun
Düzleştirme yalnızca sayfanın hâllâ sahip olduğu kutuları yeniden yazar ve ilkini yazmadan önce hepsini okur. Sıra, §14.11.2deki öntanımlı zincir yüzünden önemlidir: GetLoadedPageBox(PageIndex, pbCropBox, ...), sayfanın /CropBoxı yoksa MediaBoxı döndürür ve /BleedBox, /TrimBox ile /ArtBox CropBoxa düşer. Bir kutuyu okuyup çevirip yazan bir döngü, doğrudan o zincire yürür. MediaBoxı çevirir ve saklar; "CropBox"ı okur, henüz çevrilmiş MediaBoxı geri alır, onu ikinci kez çevirir ve sayfanın hiç sahip olmadığı bir CropBox yazar. Letter bir sayfada ikinci tur [0 -180 612 612] verir ve yeni MediaBoxa kırılınca görünür sayfa 612 × 612lik bir kareye iner
Kalıtım beş kutuyu iki gruba böler. MediaBox ile CropBox /Parent zinciri boyunca aranır; BleedBox, TrimBox ve ArtBox yalnızca sayfa sözlüğünün üzerinde dururlarsa sayılır. FlattenLoadedPageRotation, hangi kutuların var olduğuna karar verirken aynı ayrımı izler: kalıtsal bir CropBox çevrilir ve sayfaya yazılır; bir /Pages düğümündeki başıboş bir /TrimBox yok sayılır ve asla aşağı kopyalanmaz
procedure DumpPageGeometry(Pdf: THotPDF; PageIndex: Integer);
var
L, B, R, T: Single;
begin
Writeln('Effective /Rotate: ', Pdf.GetLoadedPageRotation(PageIndex));
if Pdf.GetLoadedPageBox(PageIndex, pbMediaBox, L, B, R, T) then
Writeln(Format('MediaBox [%g %g %g %g]', [L, B, R, T]));
// /TrimBox anahtarı olmasa da True: değer önce CropBoxa, sonra MediaBoxa döner
if Pdf.GetLoadedPageBox(PageIndex, pbTrimBox, L, B, R, T) then
Writeln(Format('TrimBox [%g %g %g %g]', [L, B, R, T]));
// Letter presetli; GetLoadedPageVisibleBox başarısızlıkta çıktılara dokunmaz
L := 0; B := 0; R := 612; T := 792;
Pdf.GetLoadedPageVisibleBox(PageIndex, L, B, R, T);
Writeln(Format('Visible [%g %g %g %g]', [L, B, R, T]));
end;
O yardımcıyı düzleştirme öncesinde ve sonrasında koşturun. MediaBoxı [0 0 612 792] olan 90 derecelik bir sayfa için düzleştirilmiş MediaBox [0 0 792 612] okur. Yeniden yazılan her kutu, özgün MediaBox orijinine göre aynı saat yönü turundan geçer; yeni MediaBox daima 0,0dan başlar ve [18 18 594 774]lik bir TrimBox [18 18 774 594] olur — landscape sayfanın her kenarından hâlâ 18 point içeride
GetLoadedPageVisibleBox, bir görüntüleyicinin gösterdiği ve yazıcının bastığı bölgeyi döndürür: MediaBoxa kırılmış CropBox, Left Rightdan ve Bottom Topdan küçük olacak şekilde normalize edilmiş. Sayfa renderıcısı ile SVG exportu çıktılarını aynı kutudan alır. Bir kişinin gerçekten gördüğü boyutu isteyen kod GetLoadedPageVisibleBoxu çağırmalıdır; o amaçla /MediaBoxı okumak, CropBoxlı her sayfada yanlış cevap verir
Yalnızca /Recti döndürünce annotationlar neden bozulur?
Açıklamalar kırılır, çünkü bir appearance stream asla doğrudan /Recte çizilmez. §12.5.5 altında görüntüleyici önce formun /BBoxını /Matrixiyle dönüştürür, sonra sonucun sınırlayıcı kutusunu ölçekleyip /Recte taşır. Yalnızca /Recti çevirirseniz 200 × 40lik bir damga, kimse okuyamadığı 40 × 200lik bir yuvaya sıkışır. FlattenLoadedPageRotation bu yüzden sayfanın saat yönü turunu, /N, /R ve /D görünümleri boyunca ve içindeki her durum için her bir appearance /Matrixine sağdan çarpar (satır vektör uzlaşmasında 90 derecede [0 -1 1 0 0 0]). Tek bir appearance stream birden çok açıklamaya ya da duruma hizmet edebilir; her akış çağrı başına tam olarak bir kez çevrilir, farklı döndürmelerdeki sayfalarca paylaşılan bir akış ona ilk ulaşan sayfanın turunu alır
İki küçük kural daha form alanlarını ve yapışkan notları yerinde tutar. Bir widgetın /MK /R girdisi (§12.5.6.19) saat yönünün tersine bir açıdır; sayfanın saat yönü açısı ondan çıkarılır, 360 modunda. Dokunulmaz bırakılırsa bir sonraki görünüm üretimi alan metnini yanlış yöne çizer. NoRotate bayraklı açıklamalar (bit konumu 5, değer 16, §12.5.3) çevrilmiş bir sayfada dik durur ve /Rectlerinin sol üst köşesi etrafında döner; onlar için metot genişliği, yüksekliği ve dik görünümü korur ve yalnızca o köşeyi turun koyduğu yere taşır
Açıklama sözlüklerinin ötesinde aynı çağrı /QuadPoints, /Vertices, /L ve /InkListi çevirir. Sayfayı adlandıran açık hedefleri yeniden yazar: /XYZ noktaları ile /FitR dikdörtgenleri turdan eşlenir ve 90 ya da 270 derecede /FitH ile /FitBH /FitV ile /FitBV olur, tersi de aynısı (§12.3.2.2). /Pgsi sayfa olan yapı ögelerinin öznitelik /BBox girdileri gibi etiketli geometriyi de dönüştürür
Structure tree, düz bir yürüyüşün hoş olmayan biçimde yanıldığı yerdir. Bir yapı ögesinin /Pgsi sayfa nesnesine geri işaret eder; "bu sayfaya ait" bilgisini her anahtar boyunca aşağı taşıyan bir tarayıcı /Pgden sayfaya, oradan /Annotsa girer — açıklama dikdörtgenlerini ikinci kez çevirir — ve /BBoxı form spacinde yaşayan, dıştaki cm tarafından çoktan kapsanan Form XObjectlerine. /Pyi izlemek ağacın köküne tırmanır ve diğer sayfalardan ögeleri içeri çeker. Bunların hangisinin ateşleneceği, nesnelerin hangi sırayla ziyaret edildiğine bağlıdır; katalogda /Pages, /StructTreeRootdan önce geldiyse sayfaya önce ulaşılmaya eğilimlidir ve hasar saklı kalır, sıradan test dosyaları bu yüzden geçebilir. FlattenLoadedPageRotation sayfa bağlamını yalnızca /K (çocuklar) ve /A (öznitelikler) üzerinden taşır; başka bir sayfada kendi /Pgsi olan bir çocuk o sayfaya bırakılır
Yığını göndermeden önce sonucu kontrol etmek
Düzleştirilmiş bir sayfa görüntüleyicide birebir aynı görünmeli ve işe yarayan kontroller, görünmüyorsa fark edecek olanlardır. Birkaç davranış nasıl doğrulayacağınızı biçimlendirir
- Etkin döndürmesi hâllâ 0 olan ya da MediaBoxı eksik ya da sıfır genişlik/yükseklikte olan sayfalar exception olmadan atlanır; dönüş değerini, değişmesini beklediğiniz sayımla karşılaştırın
- Sayfa kaynaklarından referans verilen Form XObjectler kendi
/BBoxile/Matrixlerini korur; çünkü dıştakicmçizdiklerinin tamamını çoktan çevirmiştir - Hedefler, her düzleştirilen sayfa için dolaylı nesnelerin bir kez yürünmesiyle bulunur; yüzlerce çevrilmiş sayfası olan büyük bir dosyada her biri için o yürüyüşü bütçenize alın
RenderLoadedPageToBitmapsayfa içerik akışlarını çizer ve açıklamaları dışarıda bırakır; çevrilmiş damgaların görsel kontrolü için önceFlattenLoadedAnnotationsı, belgenin bir kopyası üzerinde, çalıştırın
Kendini amorti eden test sayfası, bir köşesinde asimetrik bir şey taşır; örneğin gösterilen sayfanın sol üstünde dolgulu bir kare. Düzleştirmeden önce ve sonra render edin, sonra o işaretin çevresindeki pikselleri karşılaştırın. Genişlik ve yükseklik tek başına, aynalanmış bir sayfada da aynı derecede mutlu uyuşur
// Yalnızca kopya belge üzerinde: FlattenLoadedAnnotations açıklamaları
// sayfa içeriğine işler ve sayfadan kaldırır
Pdf.FlattenLoadedAnnotations('1'); // 1 tabanlı sayfa aralığı
Before := Pdf.RenderLoadedPageToBitmap(0, 96); // 0 tabanlı sayfa indeksi
if Before = nil then
raise Exception.Create('Page 1 did not render');
try
Pdf.FlattenLoadedPageRotation('1', Info);
After := Pdf.RenderLoadedPageToBitmap(0, 96);
if After = nil then
raise Exception.Create('Flattened page 1 did not render');
try
// Kendi kontrolleriniz, kütüphane çağrıları değil: boyutlar eşit olmalı...
Assert((Before.Width = After.Width) and (Before.Height = After.Height));
// ...ve sol üst köşedeki işaret pikselleri de öyle
Assert(Before.Canvas.Pixels[8, 8] = After.Canvas.Pixels[8, 8]);
finally
After.Free;
end;
finally
Before.Free;
end;
Çevrilmiş sayfalarınızdaki damgaların henüz appearance streami yoksa açıklama görünümlerini düzleştirmeden önce sentezleme o adımı ele alır. Köşe karşılaştırmasının arkasındaki renderer yüklenmiş bir PDF sayfasını bitmapa render etme yazısında anlatılır ve yüklenmiş PDFlerde redaction ve N-up birleştirme, özgün akışları yeniden kodlamadan /Contentse akış ekleme fikrinin aynısına yaslanır. FlattenLoadedPageRotation, GetLoadedPageBox ve GetLoadedPageVisibleBox, Delphi ve C++Builder için HotPDF ile gelir — ayrıntılar HotPDF Delphi PDF bileşeni sayfasındadır