Personalizar fontes do PowerPoint em JavaScript

Visão geral

Aspose.Slides permite que você use fontes personalizadas em apresentações sem instalá‑las no sistema operacional. Você pode carregar fontes de pastas personalizadas, fornecer fontes para uma apresentação específica por meio de fontes em nível de documento ou carregar fontes externas diretamente a partir de dados binários.

As fontes carregadas são usadas quando uma apresentação é renderizada ou exportada, por exemplo para PDF, imagens e outros formatos suportados. Isso ajuda a manter a saída da apresentação consistente em diferentes ambientes. O artigo também explica como inspecionar as pastas de fontes usadas pelo Aspose.Slides e como limpar o cache de fontes após trabalhar com fontes externas.

Registrar fontes personalizadas para renderização é separado de incorporar fontes em um arquivo PPTX. Se uma fonte precisar ser armazenada dentro da própria apresentação, use os recursos de incorporação de fontes explicitamente.

Aspose Slides permite que você carregue essas fontes usando o método loadExternalFonts:

TrueType (.ttf) e TrueType Collection (.ttc). Veja TrueType.
OpenType (.otf). Veja OpenType.

Carregar fontes personalizadas

Aspose.Slides permite que você carregue fontes usadas em uma apresentação sem instalá‑las no sistema. Isso afeta a saída da exportação — como PDF, imagens e outros formatos suportados — para que os documentos resultantes pareçam consistentes em todos os ambientes. As fontes são carregadas de diretórios personalizados.

Especifique uma ou mais pastas que contêm os arquivos de fonte.
Chame o método estático FontsLoader.loadExternalFonts para carregar as fontes dessas pastas.
Carregue e renderize/exporte a apresentação.
Chame FontsLoader.clearCache para limpar o cache de fontes.

O exemplo de código a seguir demonstra o processo de carregamento de fontes:

// Defina pastas que contêm arquivos de fontes personalizadas.
let fontFolders = java.newArray("java.lang.String", [externalFontFolder1, externalFontFolder2]);

// Carregue fontes personalizadas das pastas especificadas.
aspose.slides.FontsLoader.loadExternalFonts(fontFolders);

let presentation = null;
try {
    presentation = new aspose.slides.Presentation("sample.pptx");
    
    // Renderize/exporte a apresentação (por exemplo, para PDF, imagens ou outros formatos) usando as fontes carregadas.
    presentation.save("output.pdf", aspose.slides.SaveFormat.Pdf);
} finally {
    if (presentation != null) presentation.dispose();

    // Limpe o cache de fontes após o trabalho ser concluído.
    aspose.slides.FontsLoader.clearCache();
}

Nota

FontsLoader.loadExternalFonts adiciona pastas adicionais aos caminhos de pesquisa de fontes, mas não altera a ordem de inicialização das fontes.
As fontes são inicializadas nessa ordem:

O caminho padrão de fontes do sistema operacional.
Os caminhos carregados via FontsLoader.

Obter pasta de fontes personalizadas

Aspose.Slides fornece o método getFontFolders para permitir que você encontre as pastas de fontes. Esse método retorna as pastas adicionadas pelo método LoadExternalFonts e as pastas de fontes do sistema.

Este código JavaScript mostra como usar getFontFolders:

// Esta linha exibe as pastas onde os arquivos de fonte são pesquisados.
// São pastas adicionadas através do método LoadExternalFonts e pastas de fontes do sistema.
var fontFolders = aspose.slides.FontsLoader.getFontFolders();

Especificar fontes personalizadas usadas com a apresentação

Aspose.Slides fornece a propriedade setDocumentLevelFontSources para permitir que você especifique fontes externas que serão usadas com a apresentação.

Este código JavaScript mostra como usar a propriedade 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 {
    // Trabalhe com a apresentação
    // CustomFont1, CustomFont2 e fontes das pastas assets\fonts e global\fonts e de seus subdiretórios estão disponíveis para a apresentação
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Gerenciar fontes externamente

Aspose.Slides fornece o método loadExternalFont(byte[] data) para permitir o carregamento de fontes externas a partir de dados binários.

Este código JavaScript demonstra o processo de carregamento de fonte a partir de um array 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 {
        // fonte externa carregada durante a vida útil da apresentação
    } finally {
    }
} finally {
    java.callStaticMethodSync("com.aspose.slides.FontsLoader", "clearCache");
}

FAQ

As fontes personalizadas afetam a exportação para todos os formatos (PDF, PNG, SVG, HTML)?

Sim. As fontes conectadas são usadas pelo renderizador em todos os formatos de exportação.

As fontes personalizadas são incorporadas automaticamente no PPTX resultante?

Não. Registrar uma fonte para renderização não é o mesmo que incorporá‑la em um PPTX. Se precisar que a fonte seja transportada dentro do arquivo da apresentação, você deve usar os recursos de incorporação.

Posso controlar o comportamento de fallback quando uma fonte personalizada não possui certos glifos?

Sim. Configure substituição de fonte, regras de substituição e conjuntos de fallback para definir exatamente qual fonte será usada quando o glifo solicitado estiver ausente.

Posso usar fontes em contêineres Linux/Docker sem instalá‑las no sistema?

Sim. Aponte para suas próprias pastas de fontes ou carregue fontes a partir de arrays de bytes. Isso elimina qualquer dependência de diretórios de fontes do sistema na imagem do contêiner.

E quanto à licença — posso incorporar qualquer fonte personalizada sem restrições?

Você é responsável pela conformidade de licenciamento das fontes. Os termos variam; algumas licenças proíbem a incorporação ou o uso comercial. Sempre revise o contrato de licença (EULA) da fonte antes de distribuir os resultados.

Gerenciar fontes em apresentações usando JavaScript Especificar Fontes Padrão de Apresentação em JavaScript