Un equipo de diseño especifica Inter con peso 620 y ancho 87,5 para los títulos de un informe, el generador de informes incrusta el archivo de fuente, y el PDF se abre con títulos en Regular sin más. Busque el 620 en el archivo y no lo encontrará por ningún lado. Es lo esperado: un diccionario de fuentes PDF (ISO 32000-1 §9.6 y §9.8) describe un programa de glifos fijo con anchos fijos, y no existe ninguna entrada donde puedan vivir coordenadas de eje, de modo que un lector que recibe una fuente variable dibuja los contornos almacenados en el archivo, que son la instancia predeterminada. Para llevar el peso 620 al papel, las coordenadas deben fijarse en los contornos antes de que la fuente llegue al PDF
Fijar valores es más que escribir un número en un encabezado. Significa producir una nueva fuente estática autocontenida cuyos contornos, avances, cajas delimitadoras y tablas de composición coincidan con la ubicación elegida en el espacio de diseño, y luego incrustar esa fuente en lugar de la original
Lo que una instancia estática debe reconstruir
HotPDF construye esa instancia estática durante el registro de la fuente, y en una fuente variable de sabor TrueType el trabajo toca casi todas las tablas del archivo. Una fuente variable OpenType almacena un contorno predeterminado por glifo más deltas en la tabla gvar, y cada conjunto de deltas está atado a una región del espacio de diseño. Para cada glifo la biblioteca calcula con qué intensidad aplica cada región en sus coordenadas, acumula los deltas ponderados en punto flotante a lo largo de todas las tuplas y redondea cada punto una sola vez al final. Redondear por tupla dejaría que los errores se acumularan en los glifos que caen en muchas regiones superpuestas
Luego se regenera todo lo derivado de los puntos movidos. La tabla glyf se reescribe y loca se emite en formato de desplazamientos largos; hmtx (y vmtx cuando existe) recibe una entrada completa por glifo; la caja delimitadora global de head y los campos resumen de hhea y vhea — avance máximo, mínimos laterales, extensión máxima — se recalculan a partir de las métricas finales; y las sumas de comprobación sfnt se reconstruyen. Los valores de toda la fuente también: los deltas de cvar van a la tabla cvt, MVAR ajusta ascendente, descendente y métricas similares, y los datos de variación de GDEF, GPOS y las variaciones de características de GSUB se resuelven en la ubicación elegida
Hasta los metadatos descriptivos se mueven. El usWeightClass de OS/2 toma el valor de wght, así que el peso 620 queda registrado como 620; usWidthClass se mapea desde el porcentaje de wdth, y 87,5 cae exactamente en la clase 4, semicondensada; un eje slnt escribe su ángulo en post.italicAngle. Finalmente salen las tablas de variación: fvar, avar, gvar, HVAR, VVAR, MVAR, STAT y cvar, además de DSIG, cuya firma cubría bytes que ya no existen. Una fuente que conservara fvar después de mover sus contornos invitaría a cualquier consumidor consciente de variaciones a aplicar los mismos deltas una segunda vez
Las fuentes variables de sabor CFF2 toman otra ruta. Sus charstrings llevan operadores blend que un programa de fuente estático no puede expresar, así que HotPDF convierte una fuente CFF2 en una instancia estática cada vez que se registra, aunque todos los ejes estén en sus valores predeterminados. Esa conversión y su incrustación como CFF con clave CID están cubiertas en incrustación de fuentes variables CFF2
Puntos fantasma y la trampa de la doble aplicación
La regla más sutil concierne a las métricas, y la especificación OpenType facilita equivocarse. En gvar, el conteo de puntos de un glifo son sus puntos de contorno (o sus componentes, en un glifo compuesto) más cuatro puntos fantasma que codifican el margen lateral izquierdo, el ancho de avance y sus equivalentes verticales. Esos puntos fantasma reciben deltas como cualquier otro punto
Una fuente que tiene gvar muy a menudo también trae HVAR, porque HVAR permite al renderizador hallar los avances sin decodificar contornos. Aplique ambas y cada avance se mueve dos veces; el texto justificado se desplaza un poco más hacia la derecha con cada glifo. Cuando hay gvar, HotPDF deriva las métricas horizontales y verticales de los puntos fantasma interpolados e ignora HVAR y VVAR. Solo una fuente sin gvar ve su almacén de variación de métricas fijado directamente en hmtx y vmtx. Esa precedencia es la más segura: gvar es la única tabla que mueve contornos y métricas en la misma operación, así que su respuesta nunca puede contradecir al glifo que describe
Dos reglas más mantienen la geometría honesta. Los puntos no listados en un conjunto de deltas disperso se infieren por contorno con IUP (interpolación de los puntos no tocados), y los puntos fantasma nunca participan en esa interpolación. En los glifos compuestos, los deltas mueven los desplazamientos de componente solo cuando el componente se posiciona con valores XY; los componentes emparejados por puntos toman su posición de los puntos de anclaje. Los límites de los hijos se recalculan entonces de forma recursiva, con el anidamiento limitado a 64 niveles, de modo que un grafo de componentes mal formado que se referencie a sí mismo termina en una fuente rechazada y no en una recursión infinita
Leer el espacio de diseño con InspectVariableFont
InspectVariableFont es la primera llamada que hay que hacer, porque le dice qué ejes existen y qué rango acepta cada uno. Devuelve False ante un archivo ausente o una fuente sin fvar; en una colección .ttc lee el primer miembro. Cada registro THPDFVariableFontAxis lleva la etiqueta Tag de cuatro bytes, MinimumValue, DefaultValue, MaximumValue, Flags y un NameID. Cada instancia con nombre lleva un SubfamilyNameID, Flags, un PostScriptNameID y una entrada en Coordinates por eje, en orden de eje
// ClampToAxis es una ayuda que usted agrega; HotPDF no acota por usted
function ClampToAxis(const Axis: THPDFVariableFontAxis; Value: Single): Single;
begin
Result := Value;
if Result < Axis.MinimumValue then Result := Axis.MinimumValue;
if Result > Axis.MaximumValue then Result := Axis.MaximumValue;
end;
procedure ListDesignSpace(Pdf: THotPDF; const FontPath: string);
var
Axes: THPDFVariableFontAxisArray;
Instances: THPDFVariableFontNamedInstanceArray;
I, J: Integer;
Coords: string;
begin
if not Pdf.InspectVariableFont(FontPath, Axes, Instances) then
begin
Writeln('static font: register it without axis selections');
Exit;
end;
for I := 0 to High(Axes) do
Writeln(Format('%s min=%.1f default=%.1f max=%.1f',
[string(Axes[I].Tag), Axes[I].MinimumValue,
Axes[I].DefaultValue, Axes[I].MaximumValue]));
for I := 0 to High(Instances) do
begin
Coords := '';
for J := 0 to High(Instances[I].Coordinates) do
Coords := Coords + Format('%s=%g ',
[string(Axes[J].Tag), Instances[I].Coordinates[J]]);
Writeln(Format('named instance %d: %s', [I, Coords]));
end;
end;
El rango importa porque HotPDF rechaza los valores fuera de rango. Seleccionar el peso 1000 en una fuente cuyo eje wght se detiene en 900 hace que el registro lance una excepción que nombra el eje, el valor pedido y el rango permitido. Acotar en silencio habría producido un PDF que no coincide con la vista previa en pantalla, así que la verificación pertenece a su interfaz, donde los límites del control deslizante pueden salir directo de MinimumValue y MaximumValue
¿Por qué las selecciones de eje deben preceder a RegisterUnicodeTTF?
Las selecciones de eje se leen una sola vez, cuando RegisterUnicodeTTF carga el archivo de fuente, así que hay que establecerlas de antemano. SetVariableFontAxis toma una etiqueta de cuatro bytes de ASCII imprimible y un valor finito; cualquier otra cosa lanza una excepción de inmediato, y establecer de nuevo la misma etiqueta reemplaza el valor anterior. GetVariableFontAxisSelections devuelve lo pendiente y ClearVariableFontAxes vacía la lista. Tras el registro, GetRegisteredVariableFontAxes reporta el conjunto completo de coordenadas que se congeló en la fuente registrada más recientemente, con los ejes no seleccionados rellenados con sus valores predeterminados
var
Pdf: THotPDF;
Frozen: THPDFVariableFontAxisValueArray;
I: Integer;
begin
Pdf := THotPDF.Create(nil);
try
Pdf.FileName := 'quarterly.pdf';
Pdf.BeginDoc;
Pdf.SetVariableFontAxis('wght', 620); // semibold, no una instancia con nombre
Pdf.SetVariableFontAxis('wdth', 87.5); // semicondensada
Pdf.RegisterUnicodeTTF('C:\Fonts\Inter.ttf');
Pdf.ClearVariableFontAxes; // nada pendiente para la siguiente fuente
Frozen := Pdf.GetRegisteredVariableFontAxes;
for I := 0 to High(Frozen) do
Writeln(Format('%s = %g', [string(Frozen[I].Tag), Frozen[I].Value]));
Pdf.CurrentPage.SetFont('Inter', [], 14, DEFAULT_CHARSET);
Pdf.CurrentPage.UnicodeTextOut(60, 70, 0, 'Quarterly results');
Pdf.EndDoc;
finally
Pdf.Free;
end;
end;
La llamada a ClearVariableFontAxes justo después del registro es la línea que la gente omite. Las selecciones siguen pendientes hasta que se limpian, así que si la siguiente llamada a RegisterUnicodeTTF carga una fuente estática, lanza una excepción porque se suministraron selecciones de eje para una fuente no variable; si carga otra familia variable sin eje wdth, lanza porque ese eje no existe. Ambos fallos aparecen lejos del código que estableció los ejes. Limpie después de cada registro y la selección queda atada a la única fuente para la que estaba pensada
Cuando cada valor resuelto iguala el predeterminado de su eje, una fuente variable TrueType se registra tal cual, porque sus contornos almacenados ya son la instancia predeterminada. La reconstrucción descrita arriba solo corre con coordenadas no predeterminadas o con contornos CFF2
Suministrar su propio instanciador mediante OnVariableFontInstance
OnVariableFontInstance se dispara durante el registro siempre que al menos un eje esté fuera de su valor predeterminado, y recibe los bytes originales de la fuente junto con las coordenadas resueltas. Un manejador puede dejar Handled en False y dejar que el instanciador integrado siga, o ponerlo en True y devolver su propia fuente estática en InstanceFontBytes. HotPDF verifica la fuente devuelta antes de usarla: menos de 12 bytes, o una fuente que aún contenga fvar, lanza una excepción en lugar de incrustarse
procedure TReportBuilder.VariableFontInstance(Sender: TObject;
const SourceFontBytes: TBytes;
const AxisValues: THPDFVariableFontAxisValueArray;
out InstanceFontBytes: TBytes; out Handled: Boolean);
var
I: Integer;
Coords: string;
begin
InstanceFontBytes := nil;
Handled := False; // conserva el instanciador integrado
Coords := '';
for I := 0 to High(AxisValues) do
Coords := Coords + Format('%s=%g ',
[string(AxisValues[I].Tag), AxisValues[I].Value]);
// FLog es su propio registrador; deje constancia de lo que contendrá este PDF
FLog.Add(Format('instancing %d-byte font at %s',
[Length(SourceFontBytes), Coords]));
end;
// cableado: Pdf.OnVariableFontInstance := VariableFontInstance;
La mayoría de las aplicaciones deberían usar el manejador únicamente para logging, como arriba. Reemplazar el instanciador tiene sentido cuando un pipeline de fuentes externo a la aplicación ya produce instancias estáticas aprobadas y el PDF debe coincidir con ellas byte a byte; de lo contrario, la ruta integrada mantiene métricas, tablas de composición y metadatos mutuamente consistentes, y esa consistencia es justamente el propósito de la instanciación
Cómo interactúa la instanciación con el subconjunto y la conformación
La instanciación corre antes del subconjunto, así que el subsetter ve una fuente estática ordinaria: calcula la clausura de glifos, conserva los glifos que el documento usa y descarta el resto, como se describe en clausura de subconjuntos de fuentes y glifos conformados. La identidad que HotPDF usa para cachear se deriva de los bytes de la instancia, así que dos conjuntos de coordenadas de la misma familia jamás comparten una entrada de caché
La conformación lee las tablas de composición instanciadas. GSUB y GPOS sobreviven a la instanciación con sus datos de variación ya resueltos, así que las ligaduras y los alternos descritos en alternos estilísticos GSUB de OpenType siguen funcionando, y una fuente que usa variaciones de características para cambiar un glifo por encima de cierto peso obtiene el cambio que corresponde al 620. El posicionamiento es donde el código de composición se equivoca. Una instancia semicondensada tiene avances más estrechos que la predeterminada, y GetWideTextWidth mide con los avances de la fuente realmente registrada. Mida después de RegisterUnicodeTTF y los saltos de línea que calcule serán los que se impriman
La instanciación de fuentes variables encaja en el mismo pipeline que la incrustación, el subconjunto y la conformación, y el conjunto completo de funciones tipográficas para Delphi y C++Builder aparece en la página del componente PDF HotPDF para Delphi