Dibuje una V de tres puntos con Canvas.Polyline teniendo seleccionado un pincel amarillo, convierta el metafile a PDF, y un conversor ingenuo devuelve un triángulo amarillo relleno. El mismo conversor puede doblar una Bezier hacia el punto de control equivocado y dejar un rectángulo PolyDraw con tres lados. Cada caso se remonta a una regla de [MS-EMF]: EMR_POLYBEZIER empieza en el punto 0, las polylines quedan abiertas y solo se trazan, PT_CLOSEFIGURE es un bit de flag, y los recuentos de puntos deben caber en el tamaño del registro
Un device context tiene estado que un trazado PDF no tiene
Un enhanced metafile es una grabación de llamadas GDI hechas contra un device context, y la mitad de lo que significa un registro Poly* vive fuera de sus puntos: si la figura está abierta, si arranca en la posición actual, qué lápiz y qué pincel están seleccionados, y en qué offset de byte empiezan los puntos. PDF no tiene nada de eso. Tiene un trazado, un punto actual dentro de ese trazado, y un operador de pintado que elige stroke (S), fill (f) o ambos (B). El importador vectorial EMF de PDFlibPas, la biblioteca PDF de losLab para Delphi, reproduce ese estado del device context junto a las coordenadas, y las reglas de abajo describen cómo mapea cada registro
La familia Poly* existe además en dos anchos. Cada registro de 32 bits como EMR_POLYLINE tiene un gemelo de 16 bits como EMR_POLYLINE16 que guarda los puntos como pares SmallInt, y GDI graba la forma compacta siempre que toda coordenada quepa. Los dibujos cotidianos rara vez llegan por tanto a los manejadores de 32 bits de un conversor. Pase los mismos puntos por ambos anchos y compare los trazados; esa es la auditoría más barata que hay. Todos los registros tratados aquí pertenecen al grupo de registros de dibujo de [MS-EMF] 2.3.5
| Registro | Empieza en | ¿Cerrado? | Posición actual |
|---|---|---|---|
EMR_POLYBEZIER | Punto 0 | No | No se usa, no se actualiza |
EMR_POLYLINE | Punto 0 | No (solo lápiz) | No se usa, no se actualiza |
EMR_POLYLINETO | Posición actual | No (solo lápiz) | Se usa y se actualiza |
EMR_POLYPOLYLINE | Primer punto de cada polyline | No (solo lápiz) | No se usa, no se actualiza |
EMR_POLYDRAW | Primer PT_MOVETO, o posición actual | Solo donde PT_CLOSEFIGURE está activo | Se usa y se actualiza |
¿Dónde empieza realmente una curva EMR_POLYBEZIER?
Una curva EMR_POLYBEZIER empieza en el punto 0, y solo los puntos a partir del índice 1 se agrupan de tres en tres como punto de control, punto de control y punto final. Un registro de 7 puntos dibuja por tanto dos segmentos cúbicos: el punto 0 es el inicio, del 1 al 3 va el primer segmento y del 4 al 6 el segundo. Empezar a agrupar en el punto 0 consume el punto de inicio como primer punto de control. Todo segmento posterior se desplaza uno. La salida sigue siendo una curva suave, solo que equivocada. PDFlibPas abre el trazado con m en el punto 0, en ambos anchos de registro, y escribe una c por cada terna completa posterior
¿Y un recuento que no sea 1 más un múltiplo de 3? El registro está malformado. Nuestra posición es que los uno o dos puntos sobrantes deben descartarse. Coserlos a la curva inventando un punto de control que falta produce una forma que ningún dispositivo GDI dibujó jamás, y quien compare el PDF con el original no tiene forma de saber qué mitad de la curva es inventada
PolyDraw: PT_CLOSEFIGURE es un flag, no un tipo de punto
En EMR_POLYDRAW, PT_CLOSEFIGURE (valor 1) es un bit que se combina con OR en PT_LINETO (2) o en PT_BEZIERTO (4), de modo que un byte de tipo perfectamente válido puede ser 3 o 5. El tipo de punto es el byte con ese bit enmascarado; el flag significa «cierra la figura tras el segmento que termina en este punto». Un manejador que compare el byte con valores sueltos en un case de Pascal jamás ve coincidir un 3 o un 5. Esos puntos se saltan. Un rectángulo dibujado con PolyDraw pierde su lado de cierre, y a una terna Bezier cuyo último punto lleva el flag se le pierde ese punto, lo que desalinea todas las ternas posteriores en uno
PDFlibPas despacha sobre Types[i] and not PT_CLOSEFIGURE y cierra la figura solo una vez que el segmento está completo: justo tras la línea en un PT_LINETO cerrado, y tras el tercer punto de un grupo Bezier. Un archivo malformado que ponga el flag en el primer o segundo punto de una terna no cierra por tanto la figura a mitad de una curva. Dos reglas más pertenecen al mismo manejador:
- Solo el primer
PT_MOVETOde un registro arranca el trazado; los moves posteriores abren subtrazados nuevos. UnEMR_POLYDRAW16de 16 bits que contenga tres figuras debe producir tres subtrazados, y un manejador que reinicie el trazado en cada move conserva solo el último - Un registro PolyDraw que no empiece con
PT_MOVETOarranca en la posición actual, como dice la definición del registro. Escribir un operadorlocsin ningúnmprevio es un error de content stream que cada visor de PDF resuelve a su manera
¿Por qué una polyline EMF nunca debe rellenarse en PDF?
EMR_POLYLINE y EMR_POLYPOLYLINE son figuras abiertas dibujadas solo con el lápiz, y en PDF un operador de relleno cierra cualquier subtrazado abierto antes de pintarlo (ISO 32000-1 §8.5.3). Emita B o f para una polyline de tres puntos y el visor pinta un triángulo relleno con el color de pincel en vigor. Esa es la V amarilla del párrafo inicial, o el sector bajo la línea de tendencia de un gráfico. PDFlibPas termina ambos anchos de polyline con S y nunca toca el pincel, lo que conserva la semántica GDI: Polygon cierra y rellena, Polyline no hace ninguna de las dos cosas
PolylineTo empieza en la posición actual
EMR_POLYLINETO dibuja desde la posición actual por cada punto del registro, queda abierta, y deja la posición actual en el último punto. El estado del lápiz pertenece a EMR_SELECTOBJECT y EMR_CREATEPEN, nunca al manejador de un registro de dibujo. Un caso especial que apague el lápiz dentro de un registro no tiene nada que lo vuelva a encender, así que todos los registros posteriores pierden su contorno. Para la forma de un solo punto, lea exactamente los puntos que el registro contiene y pare
Los puntos de PolyPolyline empiezan tras el array de recuentos
El EMR_POLYPOLYLINE de 32 bits guarda nPolys recuentos y luego cptl puntos, así que los puntos empiezan en el offset de byte 32 + nPolys * 4. La trampa está en la RTL de Delphi. La unidad Windows declara TEMRPolyPolyline con aPolyCounts y aptl como arrays de un elemento, lo que significa que aptl[0] es el primer punto solo cuando nPolys es 1. Indexe aptl directamente y cada registro multilínea lee valores de recuento como coordenadas. Peor aún, una comprobación de tamaño construida sobre esa disposición rechaza de plano los registros multilínea válidos. PDFlibPas calcula el offset igual que para PolyPolygon y dibuja cada polyline como su propio subtrazado abierto, con un único stroke al final. El gemelo de 16 bits sigue el mismo patrón; dibujarlo segmento a segmento rompería las uniones de línea e ignoraría un NULL_PEN seleccionado
El lápiz y el pincel por defecto, y los corchetes de trazado
- Un device context GDI recién creado ya tiene
BLACK_PENyWHITE_BRUSHseleccionados. Un metafile que dibuje sin un soloEMR_SELECTOBJECTes legal y aun así recibe contornos negros; un conversor que arranque sin lápiz escriben(fin de trazado, nada pintado) para esos registros - Dentro de un corchete
BeginPath/EndPath, unaPolylineni usa ni actualiza la posición actual, así que abre un subtrazado nuevo en su primer punto en lugar de unirse a la figura anterior. Nada se pinta hasta que el corchete se traza o se rellena
Construir un archivo EMF de prueba con TMetafileCanvas
La forma más rápida de pasar un conversor por estas reglas es grabar las tres llamadas de riesgo en un solo enhanced metafile con TMetafileCanvas. El procedimiento de abajo dibuja las curvas con un pincel vacío y luego selecciona deliberadamente un pincel amarillo sólido antes de la polyline. Un conversor correcto ignora ese pincel. Cualquier amarillo en el PDF de salida significa que la polyline se rellenó. PolyDraw no tiene wrapper en TCanvas, así que va por la API de Windows sobre el handle del canvas, con bytes de tipo 3 y 5 ejercitando el flag de cierre
uses
Winapi.Windows, System.Types, Vcl.Graphics;
procedure BuildPolyTestEmf(const FileName: string);
const
// Un cuadrado cerrado (3 = LINETO + CLOSEFIGURE) y luego una
// figura Bezier cerrada cuya última terna termina en 5 = BEZIERTO + CLOSEFIGURE
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; // solo contornos para las curvas
// El punto 0 es el inicio; 1..3 y 4..6 son dos segmentos cúbicos
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));
// V abierta con un pincel sólido seleccionado: se traza y nunca
// se cierra en un triángulo amarillo
Canvas.Brush.Style := bsSolid;
Canvas.Brush.Color := clYellow;
Canvas.Polyline([Point(20, 240), Point(120, 160), Point(220, 240)]);
finally
Canvas.Free; // termina la grabación
end;
Mf.SaveToFile(FileName);
finally
Mf.Free;
end;
end;
Toda coordenada de aquí cabe en un SmallInt, así que GDI normalmente guardará las variantes de 16 bits. Llegar a los manejadores de 32 bits exige un productor que los escriba, o registros ensamblados a mano. Los archivos hechos a mano traen su propia trampa, y aflora como un error de la VCL «Metafile is not valid»: TMetafile.LoadFromStream solo trata el stream como un EMF cuando la longitud restante es estrictamente mayor que los 108 bytes del TEnhMetaHeader. Una cabecera corta, o un EMF vacío de exactamente 108 bytes, se toma por un WMF y se rechaza. Escriba la cabecera completa de 108 bytes, campos de extensión incluidos, antes del primer registro de prueba
Importar el EMF a un PDF con PDFlibPas
PDFlibPas importa un EMF con ImportEMFFromFile o ImportEMFFromStream. Ambos devuelven un ID de imagen distinto de cero en caso de éxito y 0 en caso de fallo. GeneralOptions = 0 conserva el trazado vectorial del que trata este artículo, mientras que 1 rasteriza el metafile a un bitmap. FontOptions = 1 añade las fuentes que usa el metafile y las incrusta como subconjuntos. La variante de stream rebobina a la posición 0 antes de cargar, así que pásale un stream que contenga el metafile y nada más
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); // origen arriba a la izquierda para DrawImage
PDF.SetMeasurementUnits(0); // puntos
// FontOptions 1 = añade las fuentes del metafile como subconjuntos incrustados
// GeneralOptions 0 = importación vectorial, 1 = bitmap
ImageID := PDF.ImportEMFFromFile(EmfFile, 1, 0);
if ImageID = 0 then
raise Exception.Create('The metafile could not be imported');
PDF.SelectImage(ImageID);
// En un EMF, ImageWidth / ImageHeight son el tamaño del marco en puntos
PDF.DrawImage(36, 36, PDF.ImageWidth, PDF.ImageHeight);
// La página solo invoca el formulario importado: q ... cm /Name Do Q
// (una comprobación de sanidad opcional que puede añadir a su propio código)
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;
Una importación vectorial de EMF se convierte en un form XObject, así que GetPageContentToString devuelve solo la secuencia save, transform, Do y restore. Los operadores m, l, c, h y S generados a partir de los registros Poly* viven en el stream del form XObject comprimido. Abra el archivo guardado en un inspector de objetos PDF, descomprima ese stream, y compruebe tres cosas en el archivo de prueba de arriba: la polyline termina en S sin ningún h delante, cada flag de cierre de las figuras PolyDraw produjo un h, y no aparece ningún f ni B sobre esos subtrazados. DrawImage escala un EMF importado de forma uniforme por el menor de Width y Height, así que el dibujo conserva su proporción aunque la caja que usted pase no la respete
Los usuarios de Free Pascal pueden leer cómo compila el importador vectorial EMF de PDFlibPas bajo Free Pascal; la semántica de los registros es idéntica dondequiera que compile el importador
¿Cómo debe tratar un parser EMF los recuentos de puntos del archivo?
Cada recuento de puntos de un metafile debería comprobarse contra el tamaño del registro antes de copiar un solo punto. EnumEnhMetaFile garantiza solo que el nSize de cada registro se quede dentro del archivo. Nunca comprueba que cptl concuerde con nSize. Un manejador que copie cptl puntos con Move leerá encantado los registros siguientes, o pasará del final del metafile, en cuanto el recuento esté falsificado o corrompido. PDFlibPas compara cabecera fija más recuento por bytes por punto contra nSize para PolyDraw, PolyBezier, PolyBezierTo, Polyline, PolylineTo y Polygon en ambos anchos, añadiendo un byte por punto para el array de tipos de PolyDraw. En los registros PolyPoly los recuentos por figura deben además sumar como mucho el total declarado, y las figuras de cero puntos se saltan
Preferimos saltarnos un registro que falle esta prueba antes que recortar el recuento a lo que quepa. Un registro recortado aún dibuja, y una figura dibujada a medias en un informe es más difícil de spot que una ausente. La comprobación es lo bastante corta para soltarla en su propio parser; esta versión valida un EMR_POLYPOLYLINE de 32 bits y devuelve un puntero a su array real de puntos:
uses
Winapi.Windows;
// Una comprobación que añade a su propio parser EMF (no es una rutina de la
// librería). Devuelve nil salvo que el registro contenga de verdad los puntos
// que declara. Los puntos empiezan tras el array de recuentos: 32 + nPolys * 4
// bytes hacia dentro, no en aptl[0], que la RTL declara como array de un elemento
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; // recuento falsificado o truncado
Total := 0;
Count := @P^.aPolyCounts[0]; // recorrer por puntero: [0..0] dispara range checks
for I := 1 to P^.nPolys do
begin
Inc(Total, Count^);
Inc(Count);
end;
if Total > P^.cptl then
Exit; // las figuras reclaman más puntos de los que hay
Result := PPoint(NativeUInt(Rec) + NativeUInt(PointsOffset));
end;
El orden importa aquí. La prueba de cabida de los puntos corre primero, lo que prueba que el array de recuentos está dentro del registro antes de que el bucle lo recorra. La aritmética usa Int64 porque nPolys * 4 y cptl * 8 calculados en 32 bits pueden dar la vuelta a un número pequeño y pasar la comparación
La misma semántica de registros aplica sea cual sea el componente que renderice sus informes. La importación vectorial EMF y WMF de HotPDF cubre cómo ese componente convierte pinceles de gradiente y de tramado en patterns de PDF, y vector graphics, shaders y gradients en PDFlibPas muestra cómo dibujar las mismas formas directo con la API de la librería, saltándose el metafile por completo
Para pasar sus propios metafiles de informes por este importador, la página de PDFlibPas, la biblioteca PDF Delphi tiene los detalles del producto y la descarga de prueba