HotPDF Component'te THotPDF.Resolution çizim birimini tanımlar: her X ile Y koordinatı, her kenar boşluğu, SetFonta geçilen boyut ve TextWidth ile GetWideTextWidth'in sonuçları 1/Resolution inç olarak ölçülür. THPDFPage.Width ile Height onu izlemez ve puantoda kalır; düzen sınırları bu yüzden salt okunur UserWidth ile UserHeightten gelmelidir. Resolution'a dokunmanın sıradan sebebi bir porttur: 1/96 ya da 1/144 inçte düşünen bir rapor motoru, her çağrı noktasına bir dönüşüm katsayısı koymaktansa PDF tarafı aynı birimi konuştuğunda taşınması kolaydır. Bu iyi çalışır; hangi sayıların yeni birime taşındığını, hangilerinin geride kaldığını bildiğiniz sürece
THotPDF.Resolution aslında neyi değiştirir?
THotPDF.Resolution yalnızca HotPDF'in geçtiğiniz sayıları nasıl okuduğunu değiştirir; yazdığı PDF aynıdır. Setter iki satırdır: SetResolution değeri saklar ve DocScale := Value / 72 set eder. O andan itibaren XProjection ile YProjection her koordinatı content stream'ine girerken DocScale'e böler ve SetFont boyutu aynı şekilde bölüp kaydeder. PDF user space varsayılanı 1/72 inçtir (ISO 32000-1 §8.3.2.3); varsayılan Resolution 72'de izdüşüm kimliktir, 144'te bir çizim birimi yarım puntodur. /UserUnit girdisi yazılmaz. O sayfa attributü, PDF 1.6'da eklenen, HotPDF'in THPDFPage.SetUserUnit olarak açtığı ayrı bir şeydir. TextOut rehberlerinden gelenleri yakalayan bir ayrıntı: sayfa koordinatları sol üst köşeden başlar ve Y aşağı doğru büyür, çünkü YProjection ölçeklenmiş Y'den MediaBox üstünü çıkarır; bu her Resolutionda geçerlidir
var
Pdf: THotPDF;
Page: THPDFPage;
Margin: Single;
Title: WideString;
begin
Pdf := THotPDF.Create(nil);
try
Pdf.FileName := 'invoice.pdf';
Pdf.Resolution := 144; // 1 çizim birimi = 1/144 inç
Pdf.BeginDoc;
Page := Pdf.CurrentPage; // A4: Width = 595, UserWidth = 1190
Margin := 144; // çizim birimlerinde bir inç
Page.SetFont('Arial', [fsBold], 28); // 28/144 inç, 14 pt'lik bir font
Title := 'INVOICE 2026-0417';
// Sayfa kenarına aynı birimle ölçerek sağa hizala
Page.TextOut(Page.UserWidth - Margin - Page.GetWideTextWidth(Title),
Margin, 0, Title);
Page.SetLineWidth(2); // 1 pt'lik çizgi
Page.MoveTo(Margin, Margin + 48);
Page.LineTo(Page.UserWidth - Margin, Margin + 48);
Page.Stroke;
Pdf.EndDoc;
finally
Pdf.Free;
end;
end;
Resolution 144'te Page.Width koordinatlarımla neden uyuşmaz?
THPDFPage.Width ile Height, belge Resolution'ı ne olursa olsun sayfayı puantoda bildirir; sizin koordinatlarınız ise 1/Resolution inçtedir, dolayısıyla 144'te sayfa gerçekte olduğunun yarısı kadar geniş görünür. Bir A4 sayfası, Resolution 72'de Width = 595 ve Height = 842 okur ve 144'te hâlâ 595 ve 842 okur; oysa sağ kenar gerçekte X = 1190'dadır. v2.766.0'dan itibaren mevcut olan UserWidth ve UserHeight ise çizim yaptığınız birimdeki sayfa boyutu olan Width * DocScale'i döndürür. İkisini karıştırın ve Resolution 144'teki belirtiler dramatiktir: paragraflar her karakterden sonra sarılır, bir tablo her satırı yeni bir sayfaya iter, içe aktarılan ya da düzleştirilmiş içerik yarım boyutta çizilir ve sol üst köşeye sıkışır. Bu yüzden paragraf düzeni, tablo render etme, HTML içe aktarma, EMF ortalama, WMF sayfa kırpması ve düzen tanılamalarının tümü kullanıcı-birim boyutunu okur. Kendi düzen kodunuz da okumalı: bir çizim koordinatıyla karşılaştıran her şey (sağ kenar boşluğu, sayfa sonu testi, ortalama hesabı) UserWidth ve UserHeight'e aittir; asla Width ve Height'e değil
Tuzak bir: Width ya da Height atamak sayfayı puntoya çevirir
Page.Width ya da Page.Height atamak sayfayı sessizce UserDefined'a çevirir ve bir UserDefined sayfa DocScale'i tümüyle yok sayar; dolayısıyla ondan sonra üzerine çizdiğiniz her şey puantodadır, 1/Resolution inçte değil. Setter, tasarımı gereği punto alır. Bir UserDefined sayfanın izdüşümü düz X + MinX'tir ve SetFont boyutu değiştirmeden saklar. Resolution 144'te sonuç, içeriği aniden bir önceki sayfanınkinin iki katı büyük çıkan bir sayfadır. Aynı tuzak, bir sayfayı klonlayan her kodu bekler: önceki sayfanın boyutunu Width üzerinden kopyalayın, her kopya punto sayfası olur. HotPDF'in paragraf devam sayfaları, bunun yerine Size, Orientation ve sayfa Resolution'ını kopyalar ve yalnızca özgün sayfa zaten UserDefined olduğunda Width ve Height'e düşer
İhtiyacınıza göre iki çıkış yolu var. Standart bir kâğıt işinizi görüyorsa Page.Size ve Page.Orientation'ı ayarlayın ve çiziminizi Resolution biriminizde sürdürün. Gerçekten özel bir sayfa boyutu gerekiyorsa bunun bir punto sayfası olduğunu kabullenin ve puantoda çizin; orada UserWidth Width'e eşittir, dolayısıyla her zaman UserWidth okuyan düzen kodu iki sayfa türünde de çalışmaya devam eder. Hızlı bir kontrol gösterir: Resolution 144'te bir A4 sayfası 1190'lık bir UserWidth bildirir ama Width := 500 ve Height := 400'den sonra 500 ve 400 bildirir. Yüklenen sayfalar da aynı davranır; çünkü var olan bir PDF'den yeniden kurulan bir sayfa yalnızca puantodaki MediaBox'ını bilir ve puantoda çizer. Bu belgenin oluşturduğu sayfalar, CurrentPageNumber üzerinden uzaklaşıp geri döndüğünüzde kendi birimlerini korur
Tuzak iki: font boyutları neden yarı boyutta çıkar?
Punto olarak başlayan bir font boyutu, Resolution 144'te yarı boyutta çıkar; çünkü SetFont, boyut argümanını çizim birimi sayar ve saklamadan önce puantoya çevirir. Dahili olarak SetFont, geçerli font nesnesine ASize / DocScale * DPI saklar; dolayısıyla saklanan değer her zaman puantodur. O saklanan punto değerini SetFont'a geri verirseniz ikinci kez ölçeklenir ve metin yarıya iner; bir font yedeklemesi ya da bir devam sayfası gibi fontu yeniden uygulayan her yolun kaçınması gereken tam olarak budur. Kodunuz saklanan boyutu okuyamaz ama aynı tuzak, başka yerden gelen bir punto değeri SetFont'a ulaştığında da belirir: bir VCL formundan TFont.Size, bir rapor tanımındaki boyut, bir CSS pt uzunluğu. Önce çevirin ve çarpana sayfanın kendi Resolution'ını ile UserDefined durumunu dâhil edin; metafile oynatma, sayfa Canvas'ını yeniden oynatırken bunu yapar (o yol için HotPDF'in EMF ve WMF vektör grafiklerini içe aktarması yazısına bakın):
// Mevcut sayfada punto başına çizim birimi. HotPDFin izdüşümünü
// yansıtır: Width/Height ile boyutlanmış sayfada 1, aksi hâlde
// (document Resolution / 72) * (page Resolution / 72)
function UnitsPerPoint(Pdf: THotPDF): Single;
begin
if Pdf.CurrentPage.Size = UserDefined then
Result := 1
else
Result := (Pdf.Resolution / 72) * (Pdf.CurrentPage.Resolution / 72);
end;
procedure SetFontFromVcl(Pdf: THotPDF; Font: TFont);
begin
// TFont.Size puantodadır; SetFont çizim birimi bekler
Pdf.CurrentPage.SetFont(AnsiString(Font.Name), Font.Style,
Font.Size * UnitsPerPoint(Pdf));
end;
Kütüphane aynı kuralı kendi punto sabitlerine de uygular. Her yeni sayfanın başladığı 12 punto font, dâhili punto-başına-birim çarpanıyla çarpılır; dolayısıyla her Resolution'da 12 puntodur. Kenar boşlukları, etiket boyutları ve çizgi genişliklerinin tümü sabitlenmiş punto olan DrawChart, ölçek geçici olarak 1'e ayarlanarak koşar. Bilinçli olarak çizim birimlerinde kalanlar, DrawQRCode modül boyutu ve varsayılan tablo font boyutu gibi kamuya açık parametre varsayılanlarıdır: onlar API sözleşmesinin parçasıdır, dolayısıyla Resolution 144'te 72'de anlamlarının yarısını taşır. Raporları bir şablondan boyutlandırıyorsanız, HotPDF'te yazı tipleri ve görüntülerle rapor çıktısı rehberi o değerlerin genellikle nereden geldiğini kapsar
Bir düzenin Resolution'dan bağımsızlığını nasıl doğrularsınız?
En güvenilir kontrol bir bayt karşılaştırmasıdır: aynı sayfayı önce Resolution 72'de, sonra her koordinat ve boyutu iki katına çıkararak 144'te render edin; sıkıştırılmamış content streamler özdeş olmalıdır. İki koşu da izdüşüm sonrasında aynı punto değerlerine ulaşır; dolayısıyla her fark, çevrimi atlanmış bir değerdir. Teknik, neredeyse hiç birleştirici olmadan kendi rapor kodunuz için de çalışır:
procedure RenderPage(const FileName: string; Res: Integer; K: Single);
var
Pdf: THotPDF;
begin
Pdf := THotPDF.Create(nil);
try
Pdf.AutoLaunch := False;
Pdf.Compression := cmNone; // okunabilir content streamler
Pdf.FileName := FileName;
Pdf.Resolution := Res;
Pdf.BeginDoc;
Pdf.CurrentPage.SetFont('Arial', [], 10 * K);
Pdf.CurrentPage.TextOut(36 * K, 36 * K, 0, 'Line 1');
Pdf.CurrentPage.Rectangle(36 * K, 60 * K, 200 * K, 40 * K);
Pdf.CurrentPage.Stroke;
Pdf.EndDoc;
finally
Pdf.Free;
end;
end;
// RenderPage('r72.pdf', 72, 1) ve RenderPage('r144.pdf', 144, 2)
// bayt olarak özdeş sayfa content streamleri üretmeli
Sayı taşıyan operatörleri kontrol edin: Td, Tm, Tf, re, w ve TJ dizileri. Dosya düzeyi baytlar yine de oluşturma tarihiyle /IDde farklılaşır; bu yüzden bütün dosyaları değil streamleri karşılaştırın. Bir uyuşmazlık neredeyse her zaman yukarıdaki iki tuzağın birine işaret eder: Width üzerinden yeniden boyutlanmış bir sayfa ya da doğrudan SetFonta geçilen bir punto değeri. Çizim çağrılarının kendisinde yeniyseniz boyut, stil ve rotasyon için HotPDF TextOut rehberiyle başlayın; düzeniniz UserWidth okumaya başlayınca geri gelip Resolution'ı bir kez değiştirin. Tam API ayrıntıları ve deneme indirmeleri HotPDF Delphi PDF component sayfasındadır