Echa una ficha de producto alemana en tres columnas de 148 puntos y dos cosas salen mal a la vez. La línea anterior a una palabra como Rechnungsprüfungsausschuss puede acabar un tercio vacía, porque el espacio antes de ese compuesto de 26 letras era el único sitio donde partir. Y en la última página el texto sobrante llena una columna, parte de una segunda, y deja la tercera en blanco. Un cortador de líneas que solo conoce espacios, y nunca cuenta lo que queda, produce exactamente esa página
El arreglo tiene dos mitades: partir dentro de las palabras usando reglas del idioma del texto, y dimensionar las columnas finales a partir del número de líneas que queda por colocar. Las dos mitades solo funcionan si el recuento de líneas usado para la decisión sale de los mismos cortes que se dibujan, guiones incluidos, a un ancho de columna de 148 puntos y no de la región de 480 puntos
Un flujo de tres columnas con guionado en PDF Library for Delphi
PDF Library for Delphi mantiene un pasaje como un flujo de texto: NewTextFlow devuelve un handle, SetTextFlowLanguage y SetTextFlowHyphenation controlan dónde pueden partirse las palabras, y DrawTextFlowColumns vierte en una a 64 columnas de igual ancho todo el texto restante que quepa y avanza el flujo. El ancho de columna es el ancho de la región menos los canales, dividido por el número de columnas, así que una región de 480 puntos con tres columnas y canales de 18 puntos da (480 − 2 × 18) / 3 = 148 puntos por columna
La llamada devuelve el número total de líneas que dibujó. Cero significa que no cupo nada, y en ese caso el flujo se queda donde estaba, así que no se pierde texto; la trampa es un bucle de páginas que sigue llamando a NewPage mientras la llamada sigue devolviendo cero. Eso pasa cuando la región es más corta que una línea, o cuando un ajuste de líneas mínimas no puede satisfacerse en el espacio ofrecido. El bucle de abajo trata el cero como un error en lugar de girar
var
Lib: TPDFlib;
FontID, Flow, Drawn: Integer;
begin
Lib := TPDFlib.Create;
try
Lib.SetDocumentLanguage('de-DE'); // antes de NewTextFlow, ver abajo
FontID := Lib.AddTrueTypeFont('Georgia', 1);
Lib.SetTextSize(10.5);
Flow := Lib.NewTextFlow(ArticleBody);
try
Lib.SetTextFlowHyphenation(Flow, 1, 3, 3);
Lib.SetTextFlowMinLines(Flow, 2); // ninguna línea sola abandonada al pie de una columna
repeat
// Left 66, Top 72, región de 480 x 620 pt, 3 columnas, canales de 18 pt, equilibrado
Drawn := Lib.DrawTextFlowColumns(Flow, 66, 72, 480, 620, 3, 18, 1);
if Lib.TextFlowFinished(Flow) = 1 then
Break;
if Drawn = 0 then
raise Exception.Create('Column region cannot take the next lines');
Lib.NewPage;
Lib.SelectFont(FontID);
Lib.SetTextSize(10.5); // NewPage trae la fuente de vuelta a 12 pt
until False;
finally
Lib.ReleaseTextFlow(Flow);
end;
Lib.SaveToFile('newsletter.pdf');
finally
Lib.Free;
end;
end;
Las coordenadas se miden desde la esquina arriba-izquierda de la página sea cual sea el origen que hayas fijado, porque la llamada de columnas dispone sus líneas hacia abajo desde Top. Con la alineación a la izquierda por defecto, cada línea empieza en el borde izquierdo de su columna, así que la holgura de un corte malo se ve como un borde derecho dentado; en texto justificado la misma holgura se convierte en ríos
¿De dónde viene el idioma del guionado?
Un flujo nuevo toma su idioma de la entrada /Lang del Catalog del documento en el momento en que NewTextFlow corre. Es el mismo valor que leen los lectores de pantalla y los indexadores de búsqueda, así que un documento que ya declara su idioma, como hace la salida etiquetada de el etiquetado automático para PDFs accesibles, recibe el guionado gratis. El momento importa, eso sí. Llama a SetDocumentLanguage después de que el flujo exista y ese flujo jamás lo verá; el primer ejemplo fija el idioma primero por exactamente esa razón
Cuando la etiqueta nombra un idioma soportado, el guionado automático se activa solo. Las reglas cubren inglés, alemán, neerlandés, francés, español, italiano, portugués, ruso, turco, danés, sueco, finés, polaco, checo y húngaro. Los subtags de región se descartan antes de la búsqueda, así que de-CH, de-AT y de guionan todos como alemán. Una etiqueta que las reglas no cubren, como ja, se acepta, y el corte automático simplemente se apaga para ese flujo
Tres valores de retorno te dicen qué pasó, y valen la pena comprobarlos en código que recibe el idioma de datos de usuario:
SetTextFlowLanguagedevuelve 0 solo para una etiqueta malformada; una etiqueta bien formada de un idioma sin cobertura devuelve 1 y deja el guionado automático apagadoSetTextFlowHyphenationconEnable = 1devuelve 0 cuando el idioma del flujo no tiene reglas, así que un cortador no puede inventarse puntos de corte sin idioma detrásGetTextFlowHyphenationreporta si el corte automático está activo ahora mismo, que es el valor que registrar cuando un layout se ve mal
El orden importa aquí también. SetTextFlowLanguage recalcula el estado de encendido/apagado desde el idioma nuevo, así que llamarla después de SetTextFlowHyphenation(Flow, 0, …) vuelve a encender el guionado para un idioma soportado. Fija el idioma, y después las opciones de guionado
MinPrefix y MinSuffix son un ajuste de estilo editorial
Los dos enteros tras el flag de activación son el número mínimo de letras que deben quedarse en la línea antes de un corte y pasar a la línea siguiente después de él. Ambos aceptan de 1 a 16. Cuando el guionado se enciende solo por el idioma, ambos valen 2, y una palabra solo se considera para partir cuando tiene al menos MinPrefix + MinSuffix + 1 letras
Dos y dos es el ajuste que cambiaríamos en casi todos los documentos. Produce más oportunidades de corte, pero un fragmento de dos letras al final de una línea se lee como una errata, y en alemán o neerlandés suelta cosas como un prefijo de dos letras que el lector luego tiene que volver a atar. Tres y tres cuesta unas cuantas líneas dentadas más y parece composición tipográfica. Sube los mínimos para cuerpo grande, donde cada fragmento resulta prominente; baja a dos solo para una columna genuinamente estrecha donde hayas decidido que una medida ajustada gana a una limpia
Qué palabras pueden partirse, y qué pasa con una URL
Las líneas se parten en espacios y tabuladores, y un salto de línea fuerza una línea nueva. Dentro de una palabra, el guionado automático mira solo palabras hechas enteramente de letras (latinas, incluidos los rangos de Latin Extended acentuado, y cirílicas), con cualquier puntuación inicial o final apartada. Las reglas son combinaciones conservadoras de vocales, grupos consonánticos legales y afijos comunes, así que colocan menos puntos de corte de los que colocaría un guionador de diccionario. Las palabras con dígitos o puntuación interna, como ISO-32000 o v2Beta, y las palabras de más de 128 letras no reciben puntos automáticos
Los guiones discrecionales (U+00AD) son la cancelación manual. Si una palabra contiene alguno, esas posiciones se convierten en sus únicos puntos de corte: las reglas automáticas se saltan para esa palabra, y los guiones discrecionales funcionan incluso con el guionado automático apagado o cuando el idioma no tiene reglas. Úsalos para nombres de marca, códigos de producto y términos que las reglas parten mal; en el ejemplo siguiente, Rechnungs y prüfungs son los dos únicos sitios donde el compuesto puede partirse
var
Flow: Integer;
Body, Rest: WideString;
begin
// U+00AD marca los únicos sitios donde este compuesto puede partirse
Body := 'Die Pr' + #$00FC + 'fung erfolgt durch den Rechnungs' + #$00AD +
'pr' + #$00FC + 'fungs' + #$00AD + 'ausschuss der Gesellschaft';
Flow := Lib.NewTextFlow(Body);
try
if Lib.SetTextFlowLanguage(Flow, CustomerLanguageTag) = 0 then
raise Exception.Create('Malformed language tag: ' + CustomerLanguageTag);
if Lib.SetTextFlowHyphenation(Flow, 1, 3, 3) = 0 then
LogWarning('No hyphenation rules; only soft hyphens will break words');
// LogWarning es tu propia rutina de registro
Lib.DrawTextFlow(Flow, 72, 72, 148, 240);
// Lo que no cupo vuelve exactamente como se pasó,
// guiones discrecionales incluidos
Rest := Lib.GetTextFlowRemaining(Flow);
finally
Lib.ReleaseTextFlow(Flow);
end;
end;
Un guion (hyphen-minus) solo se dibuja en el corte que de verdad se elige. Los guiones discrecionales no elegidos son invisibles tanto en la medición como en el dibujo, y el corte se registra contra el texto original, razón por la que GetTextFlowRemaining devuelve los guiones discrecionales intactos. El diseño ingenuo se equivoca aquí de forma reconocible: escribe el guion en la cadena mientras prueba un candidato, el corte luego se mueve, y un guion perdido acaba en mitad de una línea
Un token que no cabe en ninguna línea, una URL larga o un número de expediente sin corte legal, se corta en el prefijo más largo que quepa, sin añadir guion. El corte nunca cae entre las dos mitades de un par sustituto ni delante de una marca combinante, así que un emoji o una letra acentuada jamás se parten entre líneas
Qué cambia Balance=1 en la última página
El argumento Balance solo importa cuando todo lo que queda cabe dentro de la región. En ese caso DrawTextFlowColumns divide el número de líneas restantes por el número de columnas, redondea hacia arriba, y usa eso como altura de cada columna. Veintidós líneas restantes en tres columnas salen como 8, 8 y 6. Cuando el resto no cabe, cada columna conserva su altura completa para que la página lleve todo lo que pueda y el resto continúe en la página siguiente
Un ajuste de líneas mínimas puede elevar la altura equilibrada. Con SetTextFlowMinLines(Flow, 3) y cuatro líneas restantes, la altura equilibrada de dos está por debajo del mínimo, así que las columnas se llenan en orden: tres líneas en la primera columna, una en la segunda, la tercera vacía. Un rabo corto al final mismo del pasaje siempre se coloca, porque no hay otro sitio para él. Para mantener al menos dos líneas juntas también en lo alto de la columna siguiente, SetTextFlowPaginationLines toma los mínimos de huérfanas y viudas en una llamada
Para artículos continuos, pasa 1 siempre. A mitad de pasaje no cambia nada. Las columnas están llenas de todos modos. Solo pasaríamos 0 cuando la región de columnas es una caja fija en un layout de formulario, donde un resto de 52 líneas en columnas de 43 líneas debería caer como 43, 9 y 0 en lugar de 18, 18 y 16
Cuando el layout depende de lo largo que sea el pasaje, mide antes de dibujar. MeasureTextFlow devuelve cuántas líneas necesita el resto del flujo a un ancho dado, usando los mismos cortes, guionado incluido, sin mover el flujo
var
Flow, Needed, LinesPerColumn: Integer;
LinePitch: Double;
begin
Flow := Lib.NewTextFlow(ArticleBody);
try
Lib.SetTextFlowLanguage(Flow, 'fr');
Lib.SetTextFlowHyphenation(Flow, 1, 3, 3);
Lib.SelectFont(FontID);
Lib.SetTextSize(10.5);
// Paso de línea que usa la llamada de columnas: 1.2 x la altura del texto seleccionado
LinePitch := Lib.GetTextHeight * 1.2;
LinesPerColumn := Trunc(620 / LinePitch);
Needed := Lib.MeasureTextFlow(Flow, (480 - 2 * 18) / 3);
if Needed > 3 * LinesPerColumn then
UseTwoPageSpread // tu propia elección de layout
else
UseSinglePage; // Balance=1 nivelará las columnas
Lib.DrawTextFlowColumns(Flow, 66, 72, 480, 620, 3, 18, 1);
if Lib.TextFlowFinished(Flow) <> 1 then
CarryOver(Lib.GetTextFlowRemaining(Flow)); // también tuyo
finally
Lib.ReleaseTextFlow(Flow);
end;
end;
Mantén la fuente y el tamaño idénticos de caja a caja
DrawTextFlow, DrawTextFlowColumns y MeasureTextFlow parten todas las líneas con la fuente y el tamaño seleccionados en el momento en que se las llama. Cambia cualquiera de los dos entre dos cajas del mismo flujo y la segunda caja parte distinto de lo que midió la primera. El paso de línea se mueve con ello, ya que es 1,2 veces la altura del texto seleccionado. Supón que GetTextHeight reporta 12 puntos para tu fuente: el paso es 14,4 puntos y una columna de 620 puntos lleva 43 líneas
La forma fácil de tropezar con esto es una página nueva. NewPage reselecciona la fuente actual, pero a 12 puntos, y SelectFont hace lo mismo. Un flujo fijado a 10,5 puntos en la página uno corre por tanto a 12 puntos desde la página dos en adelante salvo que el bucle llame otra vez a SetTextSize: palabras más anchas, un paso más alto, menos líneas por columna, y un resultado de MeasureTextFlow de la página uno que ya no cuadra. El síntoma parece intermitente porque la página uno siempre está bien. Reselecciona la fuente y después el tamaño tras cada NewPage, en ese orden, como hace el primer ejemplo
Los pasajes que mezclan escrituras pasan por el mismo camino de fuente seleccionada en medición y dibujo, así que las fuentes sustitutas que elige la reserva automática de fuentes para texto CJK y emoji no abren una grieta entre ambas. En layouts de informe donde el flujo comparte página con cabeceras, pies y bloques con datos, el orden de el motor de informes basado en dataset se traslada igual: mide primero, coloca los elementos fijos, y luego dale al flujo la región que quede
Las llamadas de flujo de texto cubiertas aquí, de la creación y la medición al rebobinado y la liberación, forman parte de PDF Library for Delphi para Delphi, C++Builder y Lazarus. La referencia de funciones y la descarga están en la página de producto de PDF Library for Delphi