Teknik Makale

PDFlibPas EMF: PolyDraw, Polyline ve Bezier kuralları

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ıtBaşlangıçKapalı mı?Geçerli konum
EMR_POLYBEZIER0. noktaHayırKullanılmaz, güncellenmez
EMR_POLYLINE0. noktaHayır (yalnızca kalem)Kullanılmaz, güncellenmez
EMR_POLYLINETOGeçerli konumHayır (yalnızca kalem)Kullanılır ve güncellenir
EMR_POLYPOLYLINEHer polyline'ın ilk noktasıHayır (yalnızca kalem)Kullanılmaz, güncellenmez
EMR_POLYDRAWİlk PT_MOVETO ya da geçerli konumYalnızca PT_CLOSEFIGURE setli yerlerdeKullanı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

Yedi noktalı bir EMR_POLYBEZIER kaydının PDFlibPas şeması: 0. nokta pathi m ile açar, 1-3 ve 4-6 noktaları da birer kübik c segmenti oluşturur; doğru gruplama, başlangıç noktasını kontrol noktası olarak tüketen gruplamayla karşılaştırılır
0. nokta başlangıç noktasıdır ve yalnızca ardından gelen tam üçlüler kübik segmente dönüşür; yedi noktalı bir PolyBezier m artı iki c operatörü olarak render edilir

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_MOVETO pathi başlatır; sonraki hareketler yeni subpath açar. Üç şekil taşıyan 16 bitlik bir EMR_POLYDRAW16 üç subpath üretmelidir ve her harekette pathi yeniden başlatan bir işleyici yalnızca sonuncuyu tutar
  • PT_MOVETO ile başlamayan bir PolyDraw kaydı, kayıt tanımının söylediği gibi geçerli konumdan başlar. Önünde m olmayan bir l ya da c operatörü yazmak, her PDF görüntüleyicinin farklı çözdüğü bir content stream hatasıdır
Bir EMR_POLYDRAW tip baytının PDFlibPas anatomisi: PT_CLOSEFIGURE, PT_LINETO ya da PT_BEZIERTO içine OR'lanmış sıfır numaralı bayrak bittir; dolayısıyla geçerli 3 ve 5 tip baytları dağıtımdan önce and not PT_CLOSEFIGURE ile maskelenmelidir. Düz bir case deyimi her iki baytı da atlar ve kapanan şekiller son kenarlarını kaybeder
Kapatma bayrağını dağıtımdan önce maskeyin ve kapatmayı yalnızca tamamlanmış bir çizginin ya da Bezier üçlüsünün ardından üretin, yoksa PolyDraw noktaları sessizce düşürü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

EMR_POLYLINE'dan dışa aktarılan açık bir V polyline'ının PDFlibPas karşılaştırması: doğru dönüştürücü pathi stroke operatörü S ile bitirir ve seçili fırçayı yok sayar; f ya da B üretmek ise ISO 32000-1 8.5.3 uyarınca açık subpath'i dolaylı olarak kapatır ve dolu dilimi grafik çizgisinin altına boyar
Bir fill operatörü boyamadan önce her açık subpath'i kapatır; dolayısıyla polyline'lar S ile bitmeli ve subpath'te h, f ya da B bulunmamalıdır

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_PEN ve WHITE_BRUSH seçilidir. Tek bir EMR_SELECTOBJECT olmadan ç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çin n yazar (pathi bitir, hiçbir şey boyamaz)
  • Bir BeginPath / EndPath parantezi içinde bir Polyline geç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