Personalizar fontes do PowerPoint em Java
Visão geral
Aspose.Slides permite usar 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 é diferente 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.
O Aspose Slides permite carregar essas fontes usando o método loadExternalFonts:
Carregar fontes personalizadas
Aspose.Slides permite carregar fontes usadas em uma apresentação sem instalá‑las no sistema. Isso afeta a saída de exportação — como PDF, imagens e outros formatos suportados — de modo que os documentos resultantes tenham aparência consistente em diferentes ambientes. As fontes são carregadas a partir de diretórios personalizados.
- Especifique uma ou mais pastas que contenham os arquivos de fonte.
- Chame o método estático FontsLoader.loadExternalFonts para carregar 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 personalizados.
String[] fontFolders = new String[] { externalFontFolder1, externalFontFolder2 };
// Carregue fontes personalizadas das pastas especificadas.
FontsLoader.loadExternalFonts(fontFolders);
Presentation presentation = null;
try {
presentation = new Presentation("sample.pptx");
// Renderize/exporte a apresentação (por exemplo, para PDF, imagens ou outros formatos) usando as fontes carregadas.
presentation.save("output.pdf", SaveFormat.Pdf);
} finally {
if (presentation != null) presentation.dispose();
// Limpe o cache de fontes após a conclusão do trabalho.
FontsLoader.clearCache();
}
Note
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 nesta ordem:
- O caminho de fontes padrão do sistema operacional.
- Os caminhos carregados via FontsLoader.
Obter pastas de fontes personalizadas
Aspose.Slides oferece o método getFontFolders que permite localizar pastas de fontes. Este método retorna as pastas adicionadas através do método LoadExternalFonts e as pastas de fontes do sistema.
Este código Java mostra como usar getFontFolders:
// Esta linha exibe pastas onde os arquivos de fonte são pesquisados.
// Essas são pastas adicionadas através do método LoadExternalFonts e pastas de fontes do sistema.
String[] fontFolders = FontsLoader.getFontFolders();
Especificar fontes personalizadas usadas com uma apresentação
Aspose.Slides fornece a propriedade setDocumentLevelFontSources que permite especificar fontes externas que serão usadas com a apresentação.
Este código Java mostra como usar a propriedade setDocumentLevelFontSources:
byte[] memoryFont1 = Files.readAllBytes("customfonts/CustomFont1.ttf");
byte[] memoryFont2 = Files.readAllBytes("customfonts/CustomFont2.ttf");
LoadOptions loadOptions = new LoadOptions();
loadOptions.getDocumentLevelFontSources().setFontFolders(new String[] { "assets/fonts", "global/fonts" });
loadOptions.getDocumentLevelFontSources().setMemoryFonts(new byte[][] { memoryFont1, memoryFont2 });
Presentation pres = new Presentation("MyPresentation.pptx", loadOptions);
try {
// Trabalhe com a apresentação
// CustomFont1, CustomFont2, e fontes das pastas assets\fonts & global\fonts e de suas subpastas 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) que permite carregar fontes externas a partir de dados binários.
Este código Java demonstra o processo de carregamento de fonte a partir de array de bytes:
FontsLoader.loadExternalFont(Files.readAllBytes(Paths.get("ARIALN.TTF")));
FontsLoader.loadExternalFont(Files.readAllBytes(Paths.get("ARIALNBI.TTF")));
FontsLoader.loadExternalFont(Files.readAllBytes(Paths.get("ARIALNI.TTF")));
try
{
Presentation pres = new Presentation("");
try {
// fonte externa carregada durante a vida útil da apresentação
} finally {
}
}
finally
{
FontsLoader.clearCache();
}
Perguntas frequentes
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 ao 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 mantida dentro do arquivo da apresentação, deve usar os embedding features.
Posso controlar o comportamento de fallback quando uma fonte personalizada não possui determinados glifos?
Sim. Configure font substitution, replacement rules e fallback sets para definir exatamente qual fonte será usada quando o glifo solicitado estiver ausente.
Posso usar fontes em contêineres Linux/Docker sem instalá‑las em todo o sistema?
Sim. Aponte para suas próprias pastas de fontes ou carregue fontes a partir de arrays de bytes. Isso elimina qualquer dependência dos 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 com a licença da fonte. Os termos variam; algumas licenças proíbem a incorporação ou uso comercial. Sempre reveja o EULA da fonte antes de distribuir os resultados.