Vierta una ficha de producto alemana en tres columnas de 148 puntos y dos cosas salen mal a la vez. La línea delante de una palabra como Rechnungsprüfungsausschuss puede terminar un tercio vacía, porque el espacio antes de ese compuesto de 26 letras era el único lugar para cortar. 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 que nunca cuenta lo que queda, produce exactamente esa página
El arreglo tiene dos mitades: partir dentro de las palabras usando reglas para el idioma del texto, y dimensionar las columnas finales a partir del número de líneas que todavía falta por colocar. Ambas mitades solo funcionan si el conteo de líneas usado para la decisión viene 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 tanto del texto restante como quepa en una a 64 columnas de ancho igual y hace avanzar el flujo. El ancho de columna es el ancho de la región menos las canaletas, dividido entre el número de columnas, así que una región de 480 puntos con tres columnas y canaletas 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 nada cupo, y en ese caso el flujo se queda donde estaba, así que no se pierde texto; la trampa es un ciclo de páginas que sigue llamando 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 ciclo 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, vea 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 varada al pie de una columna
repeat
// Left 66, Top 72, región de 480 x 620 pt, 3 columnas, canaletas 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 superior izquierda de la página sin importar el origen que usted haya fijado, porque la llamada de columnas acomoda sus líneas hacia abajo desde Top. Con la alineación izquierda predeterminada, cada línea arranca 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 vuelve ríos
¿De dónde sale el idioma del guionado?
Un flujo nuevo toma su idioma de la entrada /Lang del Catálogo del documento en el momento en que NewTextFlow corre. Ese 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 la salida etiquetada de etiquetado automático para PDF accesibles, obtiene el guionado gratis. El momento importa, eso sí. Llame 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 el tag 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 sueltan antes de la búsqueda, así que de-CH, de-AT y de todos guionizan como alemán. Un tag que las reglas no cubren, como ja, se acepta, y el corte automático simplemente se apaga para ese flujo
Tres valores de retorno le dicen qué pasó, y valen la pena revisarlos en código que recibe el idioma de datos del usuario:
SetTextFlowLanguagedevuelve 0 solo para un tag malformado; un tag bien formado para un idioma no cubierto 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 inventar puntos de corte sin ningún idioma detrásGetTextFlowHyphenationreporta si el corte automático está activado en este momento, que es el valor que hay que registrar en el log cuando un layout se ve mal
El orden importa aquí también. SetTextFlowLanguage recalcula el estado on/off a partir del idioma nuevo, así que llamarla después de SetTextFlowHyphenation(Flow, 0, …) vuelve a encender el guionado para un idioma soportado. Fije el idioma, después las opciones de guionado
MinPrefix y MinSuffix son un ajuste de estilo de casa
Los dos enteros después del 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 1 a 16. Cuando el guionado se activa solo por el idioma, ambos valen 2, y una palabra solo se considera para cortarse cuando tiene al menos MinPrefix + MinSuffix + 1 letras
Dos y dos es el ajuste que cambiaríamos en casi cualquier documento. Produce más oportunidades de corte, pero un fragmento de dos letras al final de una línea se lee como un error de tipeo, y en alemán o neerlandés desprende cosas como un prefijo de dos letras que el lector luego tiene que volver a unir. Tres y tres cuesta unas cuantas líneas dentadas más y parece tipografía. Suba los mínimos aún más para tipografía grande, donde cada fragmento es prominente; baje a dos solo para una columna genuinamente angosta donde usted haya decidido que una medida apretada vence a una limpia
Qué palabras pueden partirse, y qué pasa con una URL
Las líneas se cortan en espacios y tabs, y un line feed fuerza una línea nueva. Dentro de una palabra, el guionado automático mira solo palabras hechas por completo de letras (latinas, incluidos los rangos Latin Extended acentuados, y cirílicas), con cualquier puntuación inicial o final apartada. Las reglas son combinaciones conservadoras de vocales, grupos de consonantes legales y afijos comunes, así que colocan menos puntos de corte que 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 suaves (U+00AD) son la sobrescritura. Si una palabra contiene alguno, esas posiciones se vuelven sus únicos puntos de corte: las reglas automáticas se saltan para esa palabra, y los guiones suaves funcionan incluso con el guionado automático apagado o cuando el idioma no tiene reglas. Úselos para nombres de marca, códigos de producto y términos que las reglas parten mal; en el siguiente ejemplo, Rechnungs y prüfungs son los únicos dos lugares donde el compuesto puede partirse
var
Flow: Integer;
Body, Rest: WideString;
begin
// U+00AD marca los únicos lugares 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 su propia rutina de logging
Lib.DrawTextFlow(Flow, 72, 72, 148, 240);
// Lo que no cupo regresa exactamente como se pasó,
// guiones suaves incluidos
Rest := Lib.GetTextFlowRemaining(Flow);
finally
Lib.ReleaseTextFlow(Flow);
end;
end;
Un guion-minus solo se dibuja en el corte que de verdad se elige. Los guiones suaves 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 cual GetTextFlowRemaining devuelve los guiones suaves intactos. El diseño ingenuo se equivoca aquí de una forma reconocible: escribe el guion en la cadena mientras prueba una candidata, el corte luego se mueve, y un guion suelto termina en medio de una línea
Un token que no cabe en ninguna línea, una URL larga o un número de acceso sin corte legal, se corta en el prefijo más largo que quepa, sin agregar guion. El corte jamás aterriza 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 parte 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 conteo de líneas restante entre el conteo de columnas, redondea hacia arriba, y usa eso como la 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 cargue todo lo que pueda y el resto continúe en la siguiente página
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 queda 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. Una cola corta al final mismo del pasaje siempre se coloca, ya que no tiene ningún otro lugar a donde ir. Para mantener al menos dos líneas juntas arriba de la siguiente columna también, SetTextFlowPaginationLines toma los mínimos de huérfanas y viudas en una sola llamada
Para artículos continuos, pase 1 cada vez. 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 tipo formulario, donde un resto de 52 líneas en columnas de 43 líneas debería aterrizar como 43, 9 y 0 en lugar de 18, 18 y 16
Cuando el layout mismo depende de qué tan largo es el pasaje, mida 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 de texto seleccionada
LinePitch := Lib.GetTextHeight * 1.2;
LinesPerColumn := Trunc(620 / LinePitch);
Needed := Lib.MeasureTextFlow(Flow, (480 - 2 * 18) / 3);
if Needed > 3 * LinesPerColumn then
UseTwoPageSpread // su propia decisión de layout
else
UseSinglePage; // Balance=1 emparejará las columnas
Lib.DrawTextFlowColumns(Flow, 66, 72, 480, 620, 3, 18, 1);
if Lib.TextFlowFinished(Flow) <> 1 then
CarryOver(Lib.GetTextFlowRemaining(Flow)); // también suyo
finally
Lib.ReleaseTextFlow(Flow);
end;
end;
Mantenga la fuente y el tamaño idénticos de caja a caja
DrawTextFlow, DrawTextFlowColumns y MeasureTextFlow todos cortan líneas con la fuente y el tamaño seleccionados al momento en que se les llama. Cambie cualquiera entre dos cajas del mismo flujo y la segunda caja corta distinto a lo que la primera midió. El paso de línea se mueve con ello, ya que es 1.2 veces la altura de texto seleccionada. Suponga que GetTextHeight reporta 12 puntos para su fuente: el paso es de 14.4 puntos y una columna de 620 puntos carga 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 entonces a 12 puntos desde la página dos en adelante salvo que el ciclo llame SetTextSize otra vez: 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 coincide. El síntoma parece intermitente porque la página uno siempre está bien. Reselecciona la fuente y luego el tamaño después de cada NewPage, en ese orden, como hace el primer ejemplo
Los pasajes que mezclan escrituras pasan por la misma ruta de fuente seleccionada en medición y dibujo, así que las caras sustitutas que elige el respaldo automático de fuentes para texto CJK y emoji no abren una brecha entre ambos. En layouts de reportes donde el flujo comparte la página con encabezados, pies y bloques dirigidos por datos, el orden de el motor de reportes de conjunto de datos aplica igual: mida primero, coloque los elementos fijos, y luego entréguele al flujo la región que quede
Las llamadas de flujo de texto cubiertas aquí, de la creación y la medición al rewind y la liberación, son 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