# Configurar Substituição de Fonte em Apresentações com Python

> Ative a substituição ideal de fontes no Aspose.Slides para Python via .NET ao converter apresentações PowerPoint e OpenDocument para outros formatos de arquivo.

Source: https://docs.aspose.com/slides/pt/python-net/font-substitution/
Updated: 2026-06-10

## **Visão geral**

A substituição de fontes permite que o Aspose.Slides use outra fonte quando a fonte original da apresentação não está disponível durante a renderização ou conversão. Você pode verificar quais fontes foram substituídas usando o método `get_substitutions` da classe `FontsManager`.

O Aspose.Slides também permite que você defina regras de substituição de fontes. Por exemplo, você pode especificar que uma fonte inacessível deve ser substituída por outra fonte disponível e então aplicar essas regras através do gerenciador de fontes da apresentação.

## **Definir regras de substituição**

O Aspose.Slides permite que você configure regras para fontes que determinam o que deve ser feito em certas condições (por exemplo, quando uma fonte não pode ser acessada) da seguinte forma:

1. Carregue a apresentação relevante.  
2. Carregue a fonte que será substituída.  
3. Carregue a nova fonte.  
4. Adicione uma regra para a substituição.  
5. Adicione a regra à coleção de regras de substituição de fontes da apresentação.  
6. Gere a imagem do slide para observar o efeito.

Este código Python demonstra o processo de substituição de fontes:

```python
import aspose.slides as slides

# Carrega uma apresentação
with slides.Presentation(path + "Fonts.pptx") as presentation:
    # Carrega a fonte de origem que será substituída
    sourceFont = slides.FontData("SomeRareFont")

    # Carrega a nova fonte
    destFont = slides.FontData("Arial")

    # Adiciona uma regra de fonte para substituição de fonte
    fontSubstRule = slides.FontSubstRule(sourceFont, destFont, slides.FontSubstCondition.WHEN_INACCESSIBLE)

    # Adiciona a regra à coleção de regras de substituição de fonte
    fontSubstRuleCollection = slides.FontSubstRuleCollection()
    fontSubstRuleCollection.add(fontSubstRule)

    # Adiciona a coleção de regras de fonte à lista de regras
    presentation.fonts_manager.font_subst_rule_list = fontSubstRuleCollection

    #Arial fonte será usada no lugar de SomeRareFont quando esta estiver inacessível
    with presentation.slides[0].get_image(1, 1) as bmp:
        # Salva a imagem no disco no formato JPEG
        bmp.save("Thumbnail_out.jpg", slides.ImageFormat.JPEG)
```

{{%  alert title="NOTA"  color="warning"   %}} 
Você pode querer ver [**Substituição de Fonte**](/slides/pt/python-net/font-replacement/). 
{{% /alert %}}

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

As regras de substituição de fontes participam do processo padrão de seleção de fontes usado durante a renderização e conversão. Elas são adequadas para cenários de texto regular em que o Aspose.Slides pode substituir uma fonte inacessível por outra fonte disponível de acordo com a regra configurada.

No entanto, as equações matemáticas do Office têm uma limitação importante. Se uma equação foi criada com **Cambria Math**, o Aspose.Slides ainda pode exigir a fonte original **Cambria Math** para calcular e renderizar o layout da equação corretamente. Por causa disso, substituir **Cambria Math** por outra fonte matemática, como **STIX Two Math**, não é suportado para renderização de equações e pode ainda resultar em uma exceção indicando que **Cambria Math** é necessária.

Para converter essas apresentações com sucesso, certifique‑se de que **Cambria Math** esteja disponível para o Aspose.Slides em tempo de execução. Você pode instalar a fonte no sistema operacional ou fornecê‑la como uma [fonte externa](/slides/pt/python-net/custom-font/) para que ela participe do processo normal de seleção de fontes durante a renderização e conversão.

Essa limitação é específica para a renderização de equações. As regras padrão de substituição de fontes descritas acima ainda se aplicam ao texto normal da apresentação quando a fonte original está inacessível.

## **Perguntas frequentes**

**Qual é a diferença entre substituição e substituição de fonte?**  
[Substituição](/slides/pt/python-net/font-replacement/) é uma sobrescrita forçada de uma fonte por outra em toda a apresentação. Substituição é uma regra que é acionada sob uma condição específica, por exemplo quando a fonte original não está disponível, e então uma fonte de reserva designada é usada.

**Quando exatamente as regras de substituição são aplicadas?**  
As regras participam da sequência padrão de [seleção de fontes](/slides/pt/python-net/font-selection-sequence/) que é avaliada durante o carregamento, renderização e conversão; se a fonte escolhida não estiver disponível, a substituição ou substituição é aplicada.

**Qual é o comportamento padrão se nem substituição nem substituição estiverem configuradas e a fonte estiver ausente no sistema?**  
A biblioteca tentará escolher a fonte do sistema mais próxima disponível, semelhante ao comportamento do PowerPoint.

**Posso anexar fontes externas personalizadas em tempo de execução para evitar substituição?**  
Sim. Você pode [adicionar fontes externas](/slides/pt/python-net/custom-font/) em tempo de execução para que a biblioteca as considere na seleção e renderização, inclusive para conversões subsequentes.

**A Aspose distribui alguma fonte com a biblioteca?**  
Não. A Aspose não distribui fontes pagas ou gratuitas; você adiciona e usa fontes por sua própria conta e risco.

**Existem diferenças no comportamento de substituição em Windows, Linux e macOS?**  
Sim. A descoberta de fontes começa a partir dos diretórios de fontes do sistema operacional. O conjunto de fontes disponíveis por padrão e os caminhos de pesquisa diferem entre as plataformas, o que afeta a disponibilidade e a necessidade de substituição.

**Como devo preparar o ambiente para minimizar substituições inesperadas durante conversões em lote?**  
Sincronize o conjunto de fontes entre máquinas ou contêineres, [adicione as fontes externas](/slides/pt/python-net/custom-font/) necessárias para os documentos de saída e [incorpore fontes](/slides/pt/python-net/embedded-font/) nas apresentações quando possível, para que as fontes escolhidas estejam disponíveis durante a renderização.