Configurar sustitución de fuentes en presentaciones en .NET

Visión general

La sustitución de fuentes permite a Aspose.Slides utilizar una fuente disponible en lugar de una fuente que no se puede acceder cuando una presentación se renderiza o convierte. La sustitución afecta a la salida renderizada; no cambia la fuente asignada al contenido de la presentación.

Puede definir la fuente a utilizar cuando una fuente concreta no está disponible, y puede inspeccionar las sustituciones que Aspose.Slides realizará durante la renderización. Esto ayuda a mantener la salida coherente entre entornos con fuentes instaladas diferentes.

Si una fuente está disponible pero no tiene un estilo negrita dedicado, consulte Manejo de fuentes sin un estilo negrita dedicado. Esa sección explica cómo rasterizar el texto afectado durante la exportación a PDF y las consecuencias para la selección de texto, la búsqueda y el escalado.

Obtener sustituciones de fuentes

Utilice el método IFontsManager.GetSubstitutions para determinar qué fuentes serán sustituidas cuando la presentación se renderice. El método devuelve objetos FontSubstitutionInfo que identifican los nombres de la fuente original y la sustituta.

El siguiente ejemplo en C# enumera todas las sustituciones de fuentes para una presentación:

using System;
using Aspose.Slides;

using var presentation = new Presentation("Presentation.pptx");

foreach (var substitution in presentation.FontsManager.GetSubstitutions())
{
    Console.WriteLine($"{substitution.OriginalFontName} -> {substitution.SubstitutedFontName}");
}

Obtener sustituciones de fuentes para diapositivas seleccionadas

Utilice la sobrecarga del método IFontsManager.GetSubstitutions con un argumento int[] slides para inspeccionar solo las sustituciones necesarias para renderizar diapositivas específicas. Esto resulta útil cuando está renderizando o exportando parte de una presentación, revisando incrementalmente una presentación grande, localizando diapositivas que dependen de fuentes no disponibles, preparando un paquete mínimo de fuentes para un servidor o contenedor, o diagnosticando diferencias de renderizado sin procesar diapositivas no relacionadas.

La matriz slides contiene índices de diapositivas basados en uno: 1 identifica la primera diapositiva. En cambio, el indexador de la colección Presentation.Slides está basado en cero, de modo que la misma diapositiva se accede como presentation.Slides[0]. Tenga presente esta diferencia al construir la matriz para evitar errores de desplazamiento.

Llame a la sobrecarga mediante la propiedad Presentation.FontsManager. Devuelve solo las sustituciones determinadas al renderizar las diapositivas seleccionadas. Cada resultado es un objeto FontSubstitutionInfo que contiene los nombres de la fuente original y la sustituta. El resultado refleja el entorno de fuentes actual y fuentes cargadas externamente. Las reglas de sustitución almacenadas en una IFontSubstRuleCollection modifican la salida renderizada pero no se reflejan en el resultado.

La misma sustitución puede ser requerida por más de una diapositiva seleccionada. Desduplicar los resultados cuando cree un inventario de fuentes o un informe de pre‑vuelo. El siguiente ejemplo muestra cada sustitución devuelta y luego crea una lista ordenada de asignaciones de fuentes únicas:

using System;
using System.Linq;
using Aspose.Slides;

using var presentation = new Presentation("Presentation.pptx");

int[] selectedSlides = { 1, 3, 5 };
var substitutions = presentation.FontsManager.GetSubstitutions(selectedSlides).ToList();

Console.WriteLine("Substitutions for the selected slides:");
foreach (var substitution in substitutions)
{
    Console.WriteLine($"{substitution.OriginalFontName} -> {substitution.SubstitutedFontName}");
}

var preflightEntries = substitutions.Select(substitution => $"{substitution.OriginalFontName} -> {substitution.SubstitutedFontName}");
var uniquePreflightEntries = preflightEntries.Distinct(StringComparer.OrdinalIgnoreCase);
var sortedPreflightEntries = uniquePreflightEntries.OrderBy(entry => entry, StringComparer.OrdinalIgnoreCase).ToList();

Console.WriteLine("Deduplicated font preflight report:");
foreach (var entry in sortedPreflightEntries)
{
    Console.WriteLine(entry);
}

La interfaz IFontsManager proporciona ambas sobrecargas. Elija una según el alcance de la operación de renderizado:

Sobrecarga Cuándo usarla
GetSubstitutions with no arguments Necesita sustituciones para toda la presentación.
GetSubstitutions with int[] slides Necesita sustituciones para un rango seleccionado, una comprobación incremental o una exportación parcial.

Establecer reglas de sustitución de fuentes

Para especificar la fuente que Aspose.Slides debe usar cuando una fuente origen no está disponible:

  1. Cargue la presentación.
  2. Cree definiciones de fuentes para la fuente origen y la sustituta.
  3. Cree una FontSubstRule con la condición WhenInaccessible.
  4. Añada la regla a una FontSubstRuleCollection.
  5. Asigne la colección a la propiedad FontsManager.FontSubstRuleList.
  6. Renderice o convierta la presentación.

El siguiente ejemplo en C# sustituye Arial por SomeRareFont cuando SomeRareFont no está disponible, y luego renderiza la primera diapositiva para verificar el resultado. La fuente sustituta debe estar disponible para Aspose.Slides.

using Aspose.Slides;

using var presentation = new Presentation("Fonts.pptx");

var sourceFont = new FontData("SomeRareFont");
var substituteFont = new FontData("Arial");
var substitutionRule = new FontSubstRule(sourceFont, substituteFont, FontSubstCondition.WhenInaccessible);

var substitutionRules = new FontSubstRuleCollection();
substitutionRules.Add(substitutionRule);
presentation.FontsManager.FontSubstRuleList = substitutionRules;

using var image = presentation.Slides[0].GetImage(1f, 1f);
image.Save("slide.jpg", ImageFormat.Jpeg);

Limitaciones para fuentes de ecuaciones matemáticas

Las reglas de sustitución de fuentes forman parte del proceso estándar de selección de fuentes utilizado durante la renderización y conversión. Funcionan para texto normal cuando Aspose.Slides puede reemplazar una fuente inaccesible por la fuente disponible especificada en una regla.

Las ecuaciones de Office Math tienen un requisito adicional. Si una ecuación utiliza Cambria Math, Aspose.Slides puede necesitar esa fuente exacta para calcular y renderizar la disposición de la ecuación. Una regla que sustituya otra fuente matemática, como STIX Two Math, no puede reemplazar Cambria Math para este fin, y la renderización puede seguir indicando que Cambria Math es necesaria.

Para renderizar o convertir una presentación de este tipo, haga que Cambria Math esté disponible para Aspose.Slides. Instálela en el sistema operativo o cárguela como una fuente externa.

Esta limitación se aplica a la disposición de ecuaciones. Las reglas de sustitución descritas arriba siguen aplicándose al texto regular de la presentación.

Preguntas frecuentes

¿Cuál es la diferencia entre reemplazo de fuentes y sustitución de fuentes?

Reemplazo de fuentes cambia intencionalmente una fuente por otra en toda la presentación. La sustitución de fuentes selecciona una fuente para la salida renderizada cuando se cumple la condición configurada, como cuando la fuente original no está disponible.

¿Cuándo se aplican las reglas de sustitución?

Las reglas participan en la secuencia de selección de fuentes durante la renderización y conversión. Con WhenInaccessible, una regla se usa solo cuando Aspose.Slides no puede acceder a la fuente origen.

¿Qué ocurre cuando falta una fuente y no hay una regla de sustitución configurada?

Aspose.Slides selecciona la fuente disponible más cercana según su proceso de selección de fuentes. El resultado depende de las fuentes disponibles en el entorno de ejecución.

¿Puedo cargar fuentes externas para evitar la sustitución?

Sí. Puede cargar fuentes externas para que Aspose.Slides pueda utilizarlas durante la renderización y conversión.

¿Aspose distribuye fuentes con la biblioteca?

No. Usted es responsable de proporcionar las fuentes y de cumplir con sus licencias.

¿Pueden los resultados de la sustitución diferir entre Windows, Linux y macOS?

Sí. Las fuentes instaladas y las ubicaciones de búsqueda de fuentes difieren según el sistema operativo, por lo que una fuente disponible en una máquina puede requerir sustitución en otra.

¿Cómo puedo mantener la selección de fuentes coherente en conversiones por lotes?

Utilice los mismos archivos de fuentes y versiones en cada máquina o contenedor, cargue las fuentes externas requeridas y incorpore fuentes cuando la licencia lo permita. También puede llamar a IFontsManager.GetSubstitutions antes de la exportación para identificar sustituciones inesperadas.