Personalizar fontes do PowerPoint em .NET

Sobre o que é esta página

Personalize fontes em slides do PowerPoint com Aspose.Slides para .NET para manter suas apresentações nítidas e consistentes em qualquer dispositivo.

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 de 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.

O registro de fontes personalizadas para renderização é separado da incorporação de 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.

Um tema de apresentação pode referenciar diferentes famílias de fontes para sistemas de escrita individuais. Esses mapeamentos armazenam nomes de fontes, mas não instalam nem carregam os arquivos de fonte. Consulte Script-Specific Theme Fonts para gerenciar os mapeamentos e use as opções de carregamento abaixo para disponibilizar as fontes referenciadas para renderização consistente.

Observação

Aspose Slides permite carregar essas fontes usando o método FontsLoader.LoadExternalFonts:

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

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 — para que os documentos resultantes tenham aparência consistente entre 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:

using Aspose.Slides;
using Aspose.Slides.Export;

// Defina pastas que contêm arquivos de fontes personalizadas.
string[] fontFolders = { @"C:\MyFonts", @"D:\Fonts" };

// Carregue fontes personalizadas das pastas especificadas.
FontsLoader.LoadExternalFonts(fontFolders);

using Presentation 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);

// Limpe o cache de fontes após a finalização do trabalho.
FontsLoader.ClearCache();

Observação

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 fonte padrão do sistema operacional.
Os caminhos carregados via FontsLoader.

Obter pastas de fontes personalizadas

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

Este código C# mostra como usar GetFontFolders:

using Aspose.Slides;

// Esta linha exibe as pastas que são verificadas para arquivos de fontes.
// 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 em uma apresentação

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

Este código C# mostra como usar a propriedade DocumentLevelFontSources:

using Aspose.Slides;

byte[] memoryFont1 = File.ReadAllBytes("customfonts\\CustomFont1.ttf");
byte[] memoryFont2 = File.ReadAllBytes("customfonts\\CustomFont2.ttf");

LoadOptions loadOptions = new LoadOptions();
loadOptions.DocumentLevelFontSources.FontFolders = new string[] { "assets\\fonts", "global\\fonts" };
loadOptions.DocumentLevelFontSources.MemoryFonts = new byte[][] { memoryFont1, memoryFont2 };
using (IPresentation presentation = new Presentation("MyPresentation.pptx", loadOptions))
{
    // Trabalhe com a apresentação
    // CustomFont1, CustomFont2 e fontes das pastas assets\fonts & global\fonts e suas subpastas estão disponíveis para a apresentação
}

Gerenciar fontes externamente

Aspose.Slides fornece o método LoadExternalFont(byte[] data) para permitir que você carregue fontes externas a partir de dados binários.

Este código C# demonstra o processo de carregamento de fonte a partir de array de bytes:

using Aspose.Slides;

FontsLoader.LoadExternalFont(File.ReadAllBytes("ARIALN.TTF"));
FontsLoader.LoadExternalFont(File.ReadAllBytes("ARIALNBI.TTF"));
FontsLoader.LoadExternalFont(File.ReadAllBytes("ARIALNI.TTF"));

try
{
    using (Presentation pres = new Presentation(""))
    {
        // fonte externa carregada durante a vida útil da apresentação
    }
}
finally
{
    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 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 transportada dentro do arquivo de apresentação, use os recursos de incorporação.

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

Sim. Configure a substituição de fontes, as regras de substituição e os 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.

Nota para Linux/Docker: Ao chamar FontsLoader.LoadExternalFonts, certifique‑se de que cada entrada no array directories contenha um caminho não vazio para um diretório existente. Se uma variável de ambiente usada para construir o caminho da fonte estiver indefinida ou vazia, o Aspose.Slides pode tentar resolver o valor vazio como um caminho completo, resultando em System.ArgumentException.

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

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

Especificar fontes padrão de apresentação no .NET