Incorporar fontes em apresentações usando PHP

Introdução

Fontes incorporadas no PowerPoint são úteis quando você deseja que sua apresentação apareça corretamente ao ser aberta em qualquer sistema ou dispositivo. Se você usou uma fonte de terceiros ou não padrão porque foi criativo no seu trabalho, então tem ainda mais motivos para incorporar sua fonte. Caso contrário (sem fontes incorporadas), os textos ou números em seus slides, o layout, o estilo, etc. podem mudar ou se transformar em retângulos confusos.

A classe FontsManager , a classe FontData e a classe Compress contêm a maioria dos métodos de que você precisa para trabalhar com fontes incorporadas em apresentações do PowerPoint.

Obter e remover fontes incorporadas

Aspose.Slides fornece o método getEmbeddedFonts (exposto pela classe FontsManager) para permitir que você obtenha (ou descubra) as fontes incorporadas em uma apresentação. Para remover fontes, utiliza-se o método removeEmbeddedFont (exposto pela mesma classe).

Este código PHP mostra como obter e remover fontes incorporadas de uma apresentação:

  # Instancia um objeto Presentation que representa um arquivo de apresentação
  $pres = new Presentation("EmbeddedFonts.pptx");
  try {
    # Renderiza um slide contendo um quadro de texto que usa a fonte incorporada "FunSized"
    $slideImage = $pres->getSlides()->get_Item(0)->getImage(new Java("java.awt.Dimension", 960, 720));
    # Salva a imagem no disco no formato JPEG
    try {
      $slideImage->save("picture1_out.jpg", ImageFormat::Jpeg);
    } finally {
      if (!java_is_null($slideImage)) {
        $slideImage->dispose();
      }
    }
    $fontsManager = $pres->getFontsManager();
    # Obtém todas as fontes incorporadas
    $embeddedFonts = $fontsManager->getEmbeddedFonts();
    # Encontra a fonte "Calibri"
    $calibriEmbeddedFont = null;
    $Array = new java_class("java.lang.reflect.Array");
    for($i = 0; $i < java_values($Array->getLength($embeddedFonts)) ; $i++) {
      echo("" . $embeddedFonts[$i]->getFontName());
      if ("Calibri"->equals($embeddedFonts[$i]->getFontName())) {
        $calibriEmbeddedFont = $embeddedFonts[$i];
        break;
      }
    }
    # Remove a fonte "Calibri"
    $fontsManager->removeEmbeddedFont($calibriEmbeddedFont);
    # Renderiza a apresentação; a fonte "Calibri" é substituída por uma existente
    $slideImage = $pres->getSlides()->get_Item(0)->getImage(new Java("java.awt.Dimension", 960, 720));
    # Salva a imagem no disco no formato JPEG
    try {
      $slideImage->save("picture2_out.jpg", ImageFormat::Jpeg);
    } finally {
      if (!java_is_null($slideImage)) {
        $slideImage->dispose();
      }
    }
    # Salva a apresentação sem a fonte "Calibri" incorporada no disco
    $pres->save("WithoutManageEmbeddedFonts_out.ppt", SaveFormat::Ppt);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Adicionar fontes incorporadas

Usando a classe EmbedFontCharacters e duas sobrecargas do método addEmbeddedFont, você pode selecionar a regra de incorporação que preferir para incorporar as fontes em uma apresentação. Este código PHP mostra como incorporar e adicionar fontes a uma apresentação:

  # Carrega a apresentação
  $pres = new Presentation("Fonts.pptx");
  try {
    $allFonts = $pres->getFontsManager()->getFonts();
    $embeddedFonts = $pres->getFontsManager()->getEmbeddedFonts();
    $Array = new java_class("java.lang.reflect.Array");
    foreach($allFonts as $font) {
      $embeddedFontsContainsFont = false;
      for($i = 0; $i < java_values($Array->getLength($embeddedFonts)) ; $i++) {
        if ($embeddedFonts[$i]->equals($font)) {
          $embeddedFontsContainsFont = true;
          break;
        }
      }
      if (!$embeddedFontsContainsFont) {
        $pres->getFontsManager()->addEmbeddedFont($font, EmbedFontCharacters->All);
        $embeddedFonts = $pres->getFontsManager()->getEmbeddedFonts();
      }
    }
    # Salva a apresentação no disco
    $pres->save("AddEmbeddedFont_out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Compactar fontes incorporadas

Para permitir que você compacte as fontes incorporadas em uma apresentação e reduza o tamanho do arquivo, Aspose.Slides fornece o método compressEmbeddedFonts (exposto pela classe Compress).

Este código PHP mostra como compactar fontes incorporadas do PowerPoint:

  $pres = new Presentation("pres.pptx");
  try {
    Compress->compressEmbeddedFonts($pres);
    $pres->save("pres-out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

FAQ

Como posso saber se uma fonte específica na apresentação ainda será substituída durante a renderização, apesar de estar incorporada?

Verifique as informações de substituição no gerenciador de fontes e as regras de fallback/substituição: se a fonte estiver indisponível ou restrita, um fallback será usado.

Vale a pena incorporar fontes “do sistema” como Arial/Calibri?

Normalmente não — elas estão quase sempre disponíveis. Mas para total portabilidade em ambientes “leves” (Docker, um servidor Linux sem fontes pré‑instaladas), incorporar fontes do sistema pode eliminar o risco de substituições inesperadas.