Personalizar fuentes de PowerPoint en JavaScript

Cargar fuentes personalizadas

Aspose.Slides permite cargar las fuentes utilizadas en una presentación sin instalarlas en el sistema. Esto afecta la salida de exportación —como PDF, imágenes y otros formatos compatibles— de modo que los documentos resultantes tengan un aspecto coherente en todos los entornos. Las fuentes se cargan desde directorios personalizados.

  1. Especifique una o varias carpetas que contengan los archivos de fuentes.
  2. Llame al método estático FontsLoader.loadExternalFonts para cargar fuentes desde esas carpetas.
  3. Cargue y renderice/exporte la presentación.
  4. Llame a FontsLoader.clearCache para vaciar la caché de fuentes.

El siguiente ejemplo de código muestra el proceso de carga de fuentes:

// Definir carpetas que contienen archivos de fuentes personalizadas.
let fontFolders = java.newArray("java.lang.String", [externalFontFolder1, externalFontFolder2]);

// Cargar fuentes personalizadas de las carpetas especificadas.
aspose.slides.FontsLoader.loadExternalFonts(fontFolders);

let presentation = null;
try {
    presentation = new aspose.slides.Presentation("sample.pptx");
    
    // Renderizar/exportar la presentación (p.ej., a PDF, imágenes u otros formatos) usando las fuentes cargadas.
    presentation.save("output.pdf", aspose.slides.SaveFormat.Pdf);
} finally {
    if (presentation != null) presentation.dispose();

    // Vaciar la caché de fuentes después de que el trabajo haya finalizado.
    aspose.slides.FontsLoader.clearCache();
}

Obtener la carpeta de fuentes personalizadas

Aspose.Slides proporciona el método getFontFolders para permitirle localizar carpetas de fuentes. Este método devuelve las carpetas añadidas a través del método LoadExternalFonts y las carpetas de fuentes del sistema.

Este código JavaScript muestra cómo usar getFontFolders:

// Esta línea muestra las carpetas donde se buscan los archivos de fuentes.
// Estas son carpetas añadidas mediante el método LoadExternalFonts y las carpetas de fuentes del sistema.
var fontFolders = aspose.slides.FontsLoader.getFontFolders();

Especificar fuentes personalizadas usadas con la presentación

Aspose.Slides proporciona la propiedad setDocumentLevelFontSources para permitirle especificar fuentes externas que se utilizarán con la presentación.

Este código JavaScript muestra cómo usar la propiedad setDocumentLevelFontSources:

var memoryFont1 = java.newInstanceSync("java.io.FileInputStream", java.newInstanceSync("java.io.File", "customfonts/CustomFont1.ttf"));
var memoryFont2 = java.newInstanceSync("java.io.FileInputStream", java.newInstanceSync("java.io.File", "customfonts/CustomFont2.ttf"));
var loadOptions = new aspose.slides.LoadOptions();
loadOptions.getDocumentLevelFontSources().setFontFolders(java.newArray("java.lang.String", ["assets/fonts", "global/fonts"]));
loadOptions.getDocumentLevelFontSources().setMemoryFonts(java.newArray("[B", [java.newArray("byte", ["item1", "item2", "item3"])]));
var pres = new aspose.slides.Presentation("MyPresentation.pptx", loadOptions);
try {
    // Trabajar con la presentación
    // CustomFont1, CustomFont2, y las fuentes de las carpetas assets\fonts & global\fonts y sus subcarpetas están disponibles para la presentación
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Gestionar fuentes externamente

Aspose.Slides proporciona el método loadExternalFont(byte[] data) para permitirle cargar fuentes externas a partir de datos binarios.

Este código JavaScript demuestra el proceso de carga de fuentes a partir de una matriz de bytes:

java.callStaticMethodSync("com.aspose.slides.FontsLoader", "loadExternalFonts", java.newInstanceSync("java.io.FileInputStream", java.newInstanceSync("java.io.File", "ARIALN.TTF")));
java.callStaticMethodSync("com.aspose.slides.FontsLoader", "loadExternalFonts", java.newInstanceSync("java.io.FileInputStream", java.newInstanceSync("java.io.File", "ARIALNBI.TTF")));
java.callStaticMethodSync("com.aspose.slides.FontsLoader", "loadExternalFonts", java.newInstanceSync("java.io.FileInputStream", java.newInstanceSync("java.io.File", "ARIALNI.TTF")));
try {
    var pres = new aspose.slides.Presentation("");
    try {
        //        fuente externa cargada durante la vida útil de la presentación
    } finally {
    }
} finally {
    java.callStaticMethodSync("com.aspose.slides.FontsLoader", "clearCache");
}

Preguntas frecuentes

¿Las fuentes personalizadas afectan la exportación a todos los formatos (PDF, PNG, SVG, HTML)?

Sí. Las fuentes conectadas son utilizadas por el motor de renderizado en todos los formatos de exportación.

¿Las fuentes personalizadas se incrustan automáticamente en el PPTX resultante?

No. Registrar una fuente para el renderizado no es lo mismo que incrustarla en un PPTX. Si necesita que la fuente forme parte del archivo de la presentación, debe usar las funciones de incrustación.

¿Puedo controlar el comportamiento de sustitución cuando una fuente personalizada carece de ciertos glifos?

Sí. Configure la sustitución de fuentes, las reglas de reemplazo y los conjuntos de sustitución para definir exactamente qué fuente se usa cuando falta el glifo solicitado.

¿Puedo usar fuentes en contenedores Linux/Docker sin instalarlas a nivel del sistema?

Sí. Apunte a sus propias carpetas de fuentes o cargue fuentes desde matrices de bytes. Esto elimina cualquier dependencia de los directorios de fuentes del sistema en la imagen del contenedor.

¿Qué pasa con la licencia: puedo incrustar cualquier fuente personalizada sin restricciones?

Usted es responsable del cumplimiento de la licencia de la fuente. Los términos varían; algunas licencias prohíben la incrustación o el uso comercial. Siempre revise el EULA de la fuente antes de distribuir los resultados.

Visor de presentaciones