Configurar substituição de fonte em apresentações no .NET

Sobre o que é esta página

Configure regras de substituição de fontes e inspecione as fontes substituídas no Aspose.Slides para .NET ao renderizar ou converter apresentações PowerPoint e OpenDocument.

Visão geral

A substituição de fontes permite que o Aspose.Slides use uma fonte disponível no lugar de uma fonte que não pode ser acessada quando uma apresentação é renderizada ou convertida. A substituição afeta a saída renderizada; não altera a fonte atribuída ao conteúdo da apresentação.

Você pode definir a fonte a ser usada quando uma fonte específica não estiver disponível e pode inspecionar as substituições que o Aspose.Slides fará durante a renderização. Isso ajuda a manter a saída consistente em ambientes com fontes instaladas diferentes.

Se uma fonte estiver disponível, mas não houver um estilo negrito dedicado, veja Manipular fontes sem um estilo negrito dedicado. Essa seção explica como rasterizar o texto afetado durante a exportação para PDF e as consequências para seleção de texto, pesquisa e dimensionamento.

Obter substituições de fontes

Use o método IFontsManager.GetSubstitutions para determinar quais fontes serão substituídas quando a apresentação for renderizada. O método retorna objetos FontSubstitutionInfo que identificam os nomes das fontes originais e substituídas.

O exemplo C# a seguir lista todas as substituições de fontes para uma apresentação:

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}");
}

Obter substituições de fontes para slides selecionados

Use a sobrecarga IFontsManager.GetSubstitutions com um argumento int[] slides para inspecionar somente as substituições necessárias para renderizar slides específicos. Isso é útil quando você está renderizando ou exportando parte de uma apresentação, verificando uma apresentação grande de forma incremental, localizando slides que dependem de fontes indisponíveis, preparando um pacote de fontes mínimo para um servidor ou contêiner, ou diagnosticando diferenças de renderização sem processar slides não relacionados.

A matriz slides contém índices de slides baseados em 1: 1 identifica o primeiro slide. Em contraste, o indexador da coleção Presentation.Slides é baseado em zero, de modo que o mesmo slide é acessado como presentation.Slides[0]. Mantenha essa diferença em mente ao montar a matriz para evitar erros de deslocamento.

Chame a sobrecarga através da propriedade Presentation.FontsManager. Ela retorna apenas as substituições determinadas ao renderizar os slides selecionados. Cada resultado é um objeto FontSubstitutionInfo contendo os nomes da fonte original e substituída. O resultado reflete o ambiente de fontes atual e fontes carregadas externamente. As regras de substituição armazenadas em uma IFontSubstRuleCollection alteram a saída renderizada, mas não são refletidas no resultado.

A mesma substituição pode ser exigida por mais de um slide selecionado. Desduplicue os resultados ao criar um inventário de fontes ou um relatório de pré‑verificação. O exemplo a seguir relata cada substituição retornada e, em seguida, cria uma lista ordenada de mapeamentos de fontes exclusivos:

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);
}

A interface IFontsManager fornece ambas as sobrecargas. Escolha uma de acordo com o escopo da operação de renderização:

Sobrecarga	Use quando
GetSubstitutions sem argumentos	Você precisa de substituições para toda a apresentação.
GetSubstitutions com `int[] slides`	Você precisa de substituições para um intervalo selecionado, verificação incremental ou exportação parcial.

Definir regras de substituição de fontes

Para especificar a fonte que o Aspose.Slides deve usar quando uma fonte de origem estiver indisponível:

Carregue a apresentação.
Crie definições de fonte para as fontes de origem e substituta.
Crie uma FontSubstRule com a condição WhenInaccessible.
Adicione a regra a uma FontSubstRuleCollection.
Atribua a coleção à propriedade FontsManager.FontSubstRuleList.
Renderize ou converta a apresentação.

O exemplo C# a seguir substitui Arial por SomeRareFont quando SomeRareFont está indisponível e, em seguida, renderiza o primeiro slide para verificar o resultado. A fonte substituta deve estar disponível para o 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);

Note

Para uma alteração incondicional nas fontes usadas em toda a apresentação, veja Substituição de fontes.

Limitações para fontes de equações matemáticas

As regras de substituição de fontes fazem parte do processo padrão de seleção de fontes usado durante a renderização e conversão. Elas funcionam para texto comum quando o Aspose.Slides pode substituir uma fonte inacessível pela fonte disponível especificada em uma regra.

Equações do Office Math têm um requisito adicional. Se uma equação usar Cambria Math, o Aspose.Slides pode precisar dessa fonte exata para calcular e renderizar o layout da equação. Uma regra que substitui por outra fonte matemática, como STIX Two Math, não pode substituir Cambria Math para esse fim, e a renderização ainda pode relatar que Cambria Math é necessária.

Para renderizar ou converter essa apresentação, disponibilize Cambria Math ao Aspose.Slides. Instale-a no sistema operacional ou carregue-a como uma fonte externa.

Essa limitação se aplica ao layout da equação. As regras de substituição descritas acima ainda se aplicam ao texto regular da apresentação.

FAQ

Qual é a diferença entre substituição de fontes e substituição de fontes?

Substituição de fontes altera intencionalmente uma fonte por outra em toda a apresentação. A substituição de fontes seleciona uma fonte para a saída renderizada quando a condição configurada é atendida, como quando a fonte original está indisponível.

Quando as regras de substituição são aplicadas?

As regras participam da sequência de seleção de fontes durante a renderização e conversão. Com WhenInaccessible, uma regra é usada somente quando o Aspose.Slides não pode acessar a fonte de origem.

O que acontece quando uma fonte está ausente e nenhuma regra de substituição está configurada?

O Aspose.Slides seleciona a fonte disponível mais próxima de acordo com seu processo de seleção de fontes. O resultado depende das fontes disponíveis no ambiente de tempo de execução.

Posso carregar fontes externas para evitar substituição?

Sim. Você pode carregar fontes externas para que o Aspose.Slides as use durante a renderização e conversão.

A Aspose distribui fontes com a biblioteca?

Não. Você é responsável por fornecer as fontes e cumprir suas licenças.

Os resultados de substituição podem diferir entre Windows, Linux e macOS?

Sim. As fontes instaladas e os locais de pesquisa de fontes diferem por sistema operacional, de modo que uma fonte disponível em uma máquina pode exigir substituição em outra.

Como garantir que a seleção de fontes seja consistente em conversões em lote?

Use os mesmos arquivos e versões de fontes em todas as máquinas ou contêineres, carregue as fontes externas necessárias, e incorpore fontes quando as licenças permitirem. Você também pode chamar IFontsManager.GetSubstitutions antes da exportação para identificar substituições inesperadas.

Simplifique a substituição de fontes em apresentações no .NET Sequência de Seleção de Fontes no Aspose.Slides para .NET