Sarı bir fırça seçiliyken Canvas.Polyline ile üç noktalı bir V çizin, metafile'ı PDF'e çevirin ve ağdası bir dönüştürücü size dolu sarı bir üçgen geri versin. Aynı dönüştürücü bir Bezier'i yanlış kontrol noktasına doğru bükebilir ve bir PolyDraw dikdörtgenini üç kenarla bırakabilir. Her durum tek bir [MS-EMF] kuralına dayanır: EMR_POLYBEZIER 0. noktadan başlar, polyline'lar açıktır ve yalnızca stroke edilir, PT_CLOSEFIGURE bir bayrak bitidir ve nokta sayıları kayıt boyutuna sığmalıdır
Bir device context'in PDF path'inde olmayan bir durumu vardır
Bir enhanced metafile, bir device context'e karşı yapılan GDI çağrılarının kaydıdır ve bir Poly* kaydının anlamının yarısı noktalarının dışında yaşar: şeklin açık olup olmadığı, geçerli konumdan başlayıp başlamadığı, hangi kalem ve fırçanın seçili olduğu ve noktaların hangi bayt ofsetinde başladığı. PDF'in bunların hiçbiri yoktur. Elinde bir path, o pathin içinde bir current point ve stroke (S), fill (f) ile ikisi (B) arasından seçim yapan bir boyama operatörü vardır. Delphi için losLab PDF kütüphanesi olan PDFlibPas'taki vector EMF içe aktarıcısı, o device context durumunu koordinatların yanında yeniden oynatır ve aşağıdaki kurallar her kaydı nasıl eşlediğini anlatır
Poly* ailesi iki genişlikte de gelir. EMR_POLYLINE gibi her 32 bitlik kaydın, noktaları SmallInt çiftleri olarak saklayan EMR_POLYLINE16 gibi 16 bitlik bir ikizi vardır ve GDI, tüm koordinatlar sığar sığmaz kompakt biçimi kaydeder. Günlük çizimler bu yüzden bir dönüştürücünün 32 bitlik işleyicilerine nadiren ulaşır. Aynı noktaları iki genişlikten geçirin ve yolları karşılaştırın; en ucuz denetim odur. Burada ele alınan kayıtların hepsi [MS-EMF] 2.3.5'teki çizim kayıt grubuna aittir
| Kayıt | Başlangıç | Kapalı mı? | Geçerli konum |
|---|---|---|---|
EMR_POLYBEZIER | 0. nokta | Hayır | Kullanılmaz, güncellenmez |
EMR_POLYLINE | 0. nokta | Hayır (yalnızca kalem) | Kullanılmaz, güncellenmez |
EMR_POLYLINETO | Geçerli konum | Hayır (yalnızca kalem) | Kullanılır ve güncellenir |
EMR_POLYPOLYLINE | Her polyline'ın ilk noktası | Hayır (yalnızca kalem) | Kullanılmaz, güncellenmez |
EMR_POLYDRAW | İlk PT_MOVETO ya da geçerli konum | Yalnızca PT_CLOSEFIGURE setli yerlerde | Kullanılır ve güncellenir |
Bir EMR_POLYBEZIER eğrisi aslında nereden başlar?
Bir EMR_POLYBEZIER eğrisi 0. noktadan başlar ve yalnızca 1. indeksten itibaren noktalar kontrol noktası, kontrol noktası, bitiş noktası biçiminde üçlü gruplanır. 7 noktalı bir kayıt iki kübik segment çizer: 0 başlangıçtır, 1-3 ilk segmenti, 4-6 ikinciyi oluşturur. Gruplamaya 0. noktadan başlarsanız bu kez başlangıç noktası ilk kontrol noktası olarak tüketilir ve sonraki her segment bir kayar. Çıktı yine de pürüzsüz bir eğridir; yanlış olanı. PDFlibPas her iki kayıt genişliğinde de pathi 0. noktada m ile açar ve ardından her tam üçlü için bir c yazar
Peki 1 artı 3'ün katı olmayan bir sayı? Kayıt bozuktur. Bizim tutumumuz, sondaki bir ya da iki noktanın düşürülmesi gerektiğidir. Eksik bir kontrol noktası uydurup onları bir eğriye dikmek, hiçbir GDI aygıtının çizmediği bir biçim üretir ve PDF'i orijinalle karşılaştıran okuyucunun eğrinin hangi yarısının uydurma olduğunu söylemesi imkânsızdır
PolyDraw tip baytları 3 ve 5
EMR_POLYDRAW'da PT_CLOSEFIGURE (değeri 1), PT_LINETO (2) ya da PT_BEZIERTO (4) içine OR'lanan bir bittir; dolayısıyla kusursuz geçerli bir tip baytı 3 ya da 5 olabilir. Nokta tipi, o bit maskelenmiş hâliyle baytın kendisidir; bayrağın kendisi ise bu noktada biten segmentin ardından şekli kapat anlamına gelir. Baytı bir Pascal case deyiminde tek değerlerle eşleyen bir işleyici, 3'ün ya da 5'in hiçbir şeyle eşleştiğini hiç görmez. O noktalar atlanır. PolyDraw ile çizilen bir dikdörtgen kapanış kenarını kaybeder ve son noktası bayrağı taşıyan bir Bezier üçlüsü o noktayı kaybeder; bu da sonraki her üçlüyü bir adım kaydırır
PDFlibPas, Types[i] and not PT_CLOSEFIGURE ile dağıtım yapar ve şekli yalnızca bir segment tamamlandığında kapatır: kapanan bir PT_LINETO için çizginin hemen ardından, bir Bezier grubunun üçüncü noktasının ardından. Bir üçlünün ilk ya da ikinci noktasına bayrak set eden bozuk bir dosya bu yüzden bir eğrinin ortasında şekli kapatmaz. Aynı işleyiciye ait iki kural daha vardır:
- Bir kayıtta yalnızca ilk
PT_MOVETOpathi başlatır; sonraki hareketler yeni subpath açar. Üç şekil taşıyan 16 bitlik birEMR_POLYDRAW16üç subpath üretmelidir ve her harekette pathi yeniden başlatan bir işleyici yalnızca sonuncuyu tutar PT_MOVETOile başlamayan bir PolyDraw kaydı, kayıt tanımının söylediği gibi geçerli konumdan başlar. Önündemolmayan birlya dacoperatörü yazmak, her PDF görüntüleyicinin farklı çözdüğü bir content stream hatasıdır
Sarı üçgen: bir polyline neden asla doldurulmaz
EMR_POLYLINE ile EMR_POLYPOLYLINE yalnızca kalemle çizilen açık şekillerdir ve PDF'te bir fill operatörü boyamadan önce her açık subpath'i kapatır (ISO 32000-1 §8.5.3). Üç noktalı bir polyline için B ya da f üretin ve görüntüleyici, o an geçerli olan fırça rengiyle dolu bir üçgen boyar. Açılış paragrafındaki sarı V ya da bir grafik trend çizgisi altındaki dilim budur. PDFlibPas her iki polyline genişliğini de S ile bitirir ve fırçaya hiç dokunmaz; böylece GDI semantiği sapasağlam kalır: Polygon kapatır ve doldurur, Polyline ikisini de yapmaz
PolylineTo ve dokunmaması gereken kalem
EMR_POLYLINETO geçerli konumdan kayıttaki her noktaya doğru çizer, açık kalır ve geçerli konumu son noktada bırakır. Kalem durumu EMR_SELECTOBJECT ve EMR_CREATEPEN'e aittir; asla bir çizim kaydı işleyicisine değil. Tek bir kaydın içinde kalemi kapatan bir özel durumun onu geri açan hiçbir şeyi yoktur; böylece sonraki her kayıt konturunu kaybeder. Tek noktalı biçim için kaydın tuttuğu noktaları aynen okuyun ve durun
PolyPolyline noktaları counts dizisinin ardından durur
32 bitlik EMR_POLYPOLYLINE önce nPolys adet sayı sonra cptl nokta saklar; noktalar 32 + nPolys * 4 bayt ofsetinde başlar. Tuzak Delphi RTL'sindedir. Windows uniti, TEMRPolyPolyline'ı aPolyCounts ile aptl'i tek elemanlı diziler olarak bildirir; dolayısıyla aptl[0], yalnızca nPolys 1 olduğunda ilk noktadır. aptl'i doğrudan indeksleyin ve her çoklu çizgi kaydı sayı değerlerini koordinat olarak okusun. Daha da kötüsü, o düzene göre kurulan bir boyut denetimi geçerli çoklu çizgi kayıtlarını baştan reddeder. PDFlibPas ofseti PolyPolygon için yaptığı gibi hesaplar ve her polyline'ı sonunda tek bir stroke ile kendi açık subpath'i olarak çizer. 16 bitlik ikiz aynı örüntüyü izler; onu segment segment çizmek line join'leri bozar ve seçili bir NULL_PEN'i yok sayar
Varsayılan nesneler ve path parantezleri
- Yeni bir GDI device context'inde zaten
BLACK_PENveWHITE_BRUSHseçilidir. Tek birEMR_SELECTOBJECTolmadan çizen bir metafile kurallara uygundur ve yine de siyah konturlar alır; kalemsiz başlayan bir dönüştürücü bu kayıtlar içinnyazar (pathi bitir, hiçbir şey boyamaz) - Bir
BeginPath/EndPathparantezi içinde birPolylinegeçerli konumu ne kullanır ne günceller; dolayısıyla önceki şekle bağlanmak yerine ilk noktasında yeni bir subpath açar. Parantez stroke edilene ya da doldurulana dek hiçbir şey boyanmaz
TMetafileCanvas ile bir test metafile'ı kaydetmek
Bir dönüştürücüyü bu kurallara karşı denemenin en hızlı yolu, üç riskli çağrıyı TMetafileCanvas ile tek bir enhanced metafile içine kaydetmektir. Aşağıdaki prosedür eğrileri içi boş bir fırçayla çizer, sonra polyline'dan önce kasıtlı olarak dolu sarı bir fırça seçer. Doğru bir dönüştürücü o fırçayı yok sayar. Çıktı PDF'teki her sarı, polyline'ın doldurulduğu anlamına gelir. PolyDraw'un TCanvas sarmalayıcısı yoktur; canvas handle'ı üzerinden Windows API'siyle çağrılır ve tip baytları 3 ile 5, kapatma bayrağını yoklar
uses
Winapi.Windows, System.Types, Vcl.Graphics;
procedure BuildPolyTestEmf(const FileName: string);
const
// Kapalı bir kare (3 = LINETO + CLOSEFIGURE), ardından son kontrol üçlüsü
// 5 = BEZIERTO + CLOSEFIGURE ile biten kapalı bir Bezier şekli
DrawPts: array[0..7] of TPoint = (
(X: 300; Y: 40), (X: 380; Y: 40), (X: 380; Y: 120), (X: 300; Y: 120),
(X: 420; Y: 120), (X: 440; Y: 40), (X: 520; Y: 40), (X: 540; Y: 120));
DrawTypes: array[0..7] of Byte = (
PT_MOVETO, PT_LINETO, PT_LINETO, PT_LINETO or PT_CLOSEFIGURE,
PT_MOVETO, PT_BEZIERTO, PT_BEZIERTO, PT_BEZIERTO or PT_CLOSEFIGURE);
var
Mf: TMetafile;
Canvas: TMetafileCanvas;
begin
Mf := TMetafile.Create;
try
Mf.Enhanced := True;
Mf.Width := 600;
Mf.Height := 260;
Canvas := TMetafileCanvas.Create(Mf, 0);
try
Canvas.Pen.Color := clNavy;
Canvas.Pen.Width := 2;
Canvas.Brush.Style := bsClear; // eğriler için yalnızca konturlar
// 0. nokta başlangıçtır; 1..3 ve 4..6 iki kübik segmenttir
Canvas.PolyBezier([Point(20, 120), Point(60, 20), Point(100, 220),
Point(140, 120), Point(180, 20), Point(220, 220), Point(260, 120)]);
PolyDraw(Canvas.Handle, DrawPts[0], DrawTypes[0], Length(DrawPts));
// Dolu fırça seçiliyken açık V şekli: stroke edilir, asla sarı bir
// üçgene kapatılmaz
Canvas.Brush.Style := bsSolid;
Canvas.Brush.Color := clYellow;
Canvas.Polyline([Point(20, 240), Point(120, 160), Point(220, 240)]);
finally
Canvas.Free; // kaydı bitirir
end;
Mf.SaveToFile(FileName);
finally
Mf.Free;
end;
end;
Buradaki her koordinat bir SmallInt'e sığdığı için GDI normalde 16 bitlik varyantları saklar. 32 bitlik işleyicilere ulaşmak, onları yazan bir üretici ya da elle kurulan kayıtlar gerektirir. El yapımı dosyaların kendi tuzağı vardır ve VCL "Metafile is not valid" hatası olarak yüzeye çıkar: TMetafile.LoadFromStream, akışı yalnızca kalan uzunluk 108 baytlık TEnhMetaHeader'dan kesinlikle büyük olduğunda EMF sayar. Kısa bir başlık ya da tam 108 bayt olan boş bir EMF, WMF sanılır ve reddedilir. İlk test kaydından önce, uzantı alanları dahil tam 108 baytlık başlığı yazın
Metafile'ı ImportEMFFromFile ile içe aktarmak
PDFlibPas bir EMF'i ImportEMFFromFile ya da ImportEMFFromStream ile içe aktarır; ikisi de başarıda sıfır olmayan bir image ID, başarısızlıkta 0 döndürür. GeneralOptions = 0, bu yazının konusu olan vector pathi tutar; 1 ise metafile'ı bir bitmap'e rasterleştirir. FontOptions = 1, metafile'ın kullandığı fontları ekler ve subset olarak gömer. Stream varyantı yüklemeden önce 0 konumuna geri sarar; dolayısıyla metafile'dan başka bir şey içermeyen bir stream verin
uses
System.SysUtils, PDFlibrary;
procedure EmfToPdf(const EmfFile, PdfFile: WideString);
var
PDF: TPDFlib;
ImageID: Integer;
PageOps: AnsiString;
begin
PDF := TPDFlib.Create;
try
PDF.SetOrigin(1); // DrawImage için sol üst köken
PDF.SetMeasurementUnits(0); // point
// FontOptions 1 = metafile fontlarını gömülü subset olarak ekler
// GeneralOptions 0 = vector içe aktarma, 1 = bitmap
ImageID := PDF.ImportEMFFromFile(EmfFile, 1, 0);
if ImageID = 0 then
raise Exception.Create('The metafile could not be imported');
PDF.SelectImage(ImageID);
// Bir EMF için ImageWidth / ImageHeight point cinsinden çerçeve boyutudur
PDF.DrawImage(36, 36, PDF.ImageWidth, PDF.ImageHeight);
// Sayfa yalnızca içe aktarılan formu çağırır: q ... cm /Name Do Q
// (kendi kodunuza ekleyebileceğiniz isteğe bağlı bir akıl sağlığı denetimi)
PageOps := PDF.GetPageContentToString;
if Pos(AnsiString(' Do'), PageOps) = 0 then
raise Exception.Create('Expected a form XObject invocation');
if PDF.SaveToFile(PdfFile) <> 1 then
raise Exception.Create('The PDF could not be saved');
finally
PDF.Free;
end;
end;
Vector bir EMF içe aktarması bir form XObject'e dönüşür; dolayısıyla GetPageContentToString yalnızca save, transform, Do ve restore dizisini döndürür. Poly* kayıtlarından üretilen m, l, c, h ve S operatörleri sıkıştırılmış form XObject streaminde yaşar. Kaydedilen dosyayı bir PDF object inspector'da açın, o streami açın ve yukarıdaki test dosyası için üç şeye bakın: polyline'ın önünde h olmadan S ile bittiğini, PolyDraw şekillerindeki her kapatma bayrağının bir h ürettiğini ve o subpath'lerin hiçbirinde f ya da B bulunmadığını. DrawImage içe aktarılan bir EMF'i Width ile Height'ın küçüğü ölçüsünde tek düze ölçekler; yani geçirdiğiniz kutu orana uymasa bile çizim en-boy oranını korur
Free Pascal kullanıcıları PDFlibPas EMF vector içe aktarıcısının Free Pascal altında derlenişini okuyabilir; kayıt semantiği, içe aktarıcının derlendiği her yerde aynıdır
Bir EMF dosyasındaki nokta sayıları güvenilmeyen girdidir
Metafile'daki her nokta sayısı, tek bir nokta kopyalanmadan önce kayıt boyutuyla denetlenmelidir. EnumEnhMetaFile yalnızca her kaydın nSize'ının dosya içinde kaldığını garanti eder. cptl ile nSize'ın uyduğunu hiç denetlemez. cptl noktayı Move ile kopyalayan bir işleyici, sayı uydurulmuş ya da bozulmuş olduğunda gönül rahatlığıyla izleyen kayıtları, hatta metafile'ın sonunu okur. PDFlibPas, sabit başlık artı sayı çarpı nokta başına bayt toplamını her iki genişlikte PolyDraw, PolyBezier, PolyBezierTo, Polyline, PolylineTo ve Polygon için nSize ile karşılaştırır; PolyDraw tip dizisi için nokta başına bir bayt ekler. PolyPoly kayıtlarında şekil başına sayıların toplamı da bildirilen toplamı aşmamalıdır ve sıfır noktalı şekiller atlanır
Bu testi geçemeyen bir kaydı, sayıyı ne sığarsa ona kırpıp çizmek yerine atlamayı yeğleriz. Kırpılmış bir kayıt yine de çizer ve bir rapordaki yarım çizilmiş şekil, hiç olmayandan daha az fark edilir. Denetim kendi ayrıştırıcınıza bırakılacak kadar kısadır; bu sürüm 32 bitlik bir EMR_POLYPOLYLINE doğrular ve gerçek nokta dizisine bir işaretçi döndürür:
uses
Winapi.Windows;
// Kendi EMF ayrıştırıcınıza eklenecek bir denetim (kütüphane yordamı değil).
// Kayıt gerçekte bildirdiği noktaları tutmadıkça nil döndürür.
// Noktalar counts dizisinin ardından başlar: 32 + nPolys * 4 bayt içeride,
// RTL'nin tek elemanlı dizi olarak bildirdiği aptl[0]'da değil
function PolyPolylinePoints(Rec: PEnhMetaRecord): PPoint;
var
P: PEMRPolyPolyline;
Count: PDWORD;
PointsOffset, Total: Int64;
I: Cardinal;
begin
Result := nil;
if (Rec^.iType <> EMR_POLYPOLYLINE) or (Rec^.nSize < 32) then
Exit;
P := PEMRPolyPolyline(Rec);
if P^.nPolys = 0 then
Exit;
PointsOffset := 32 + Int64(P^.nPolys) * SizeOf(DWORD);
if PointsOffset + Int64(P^.cptl) * SizeOf(TPoint) > Rec^.nSize then
Exit; // sahte ya da kesilmiş sayı
Total := 0;
Count := @P^.aPolyCounts[0]; // işaretçiyle yürü: [0..0] aralık denetimini tetikler
for I := 1 to P^.nPolys do
begin
Inc(Total, Count^);
Inc(Count);
end;
if Total > P^.cptl then
Exit; // şekiller var olandan çok nokta iddia ediyor
Result := PPoint(NativeUInt(Rec) + NativeUInt(PointsOffset));
end;
Sıralama burada önemli. Nokta-sığma testi önce koşar; böylece döngü gezinmeden önce counts dizisinin kayıt içinde olduğu kanıtlanır. Aritmetik Int64 kullanır, çünkü 32 bitte hesaplanan nPolys * 4 ve cptl * 8 küçük bir sayıya taşıp karşılaştırmayı geçebilir
Aynı kayıt semantiği, raporlarınızı hangi bileşen render ederse etsin geçerlidir. HotPDF EMF ve WMF vector içe aktarma o bileşenin gradient ve hatch fırçalarını PDF pattern'lerine nasıl çevirdiğini kapsar; PDFlibPas'ta vector grafik, shader ve gradientler ise aynı şekilleri metafile'ı hiç kullanmadan doğrudan kütüphane API'siyle çizmeyi gösterir
Kendi rapor metafile'larınızı bu içe aktarıcıdan geçirmek istediğinizde PDFlibPas Delphi PDF library ürün sayfasında ürün ayrıntıları ve deneme sürümü indirmesi bulunur