Operações de Apresentação Low-Code em PHP

Visão geral

O namespace aspose.slides fornece classes auxiliares estáticas para operações comuns de apresentações. Esses auxiliares encapsulam fluxos de trabalho frequentemente usados do modelo de objetos em métodos focados, de modo que você pode converter ou mesclar arquivos, processar elementos da apresentação, coletar formas e remover conteúdo não usado com menos código.

Os auxiliares de baixo código são mais úteis quando a operação se aplica a um arquivo ou apresentação inteira e o fluxo de trabalho padrão atende aos seus requisitos. Use o modelo de objetos completo da Aspose.Slides quando precisar de controle detalhado sobre slides individuais, mestres, layouts, formas, configurações de exportação ou relacionamentos entre elementos da apresentação.

A tabela a seguir resume os auxiliares disponíveis:

Assistente Use para
Convert Converter uma apresentação para outro formato com uma chamada direta de arquivo para arquivo.
Merger Combinar arquivos de apresentação completos do mesmo formato.
ForEach_ Executar um callback para cada slide, forma, parágrafo ou porção de texto.
Collect Recuperar formas de toda a apresentação para processamento ou análise repetidos.
Compress Remover mestres e layouts não usados e reduzir dados de fontes incorporadas.

Converter uma apresentação

Use Convert::autoByExtension quando a extensão do arquivo de saída for suficiente para selecionar o formato de exportação. O método abre a apresentação de origem, determina o formato necessário a partir do caminho de saída e grava o resultado.

use aspose\slides\Convert;

Convert::autoByExtension("input.pptx", "output.pdf");

A classe Convert também fornece métodos dedicados para saída PDF, SVG, JPEG, PNG e TIFF. Use o modelo de objetos completo quando precisar inspecionar ou modificar a apresentação antes da exportação ou configurar uma opção de exportação que não esteja exposta pelo auxiliar selecionado. Consulte Convert Presentation para fluxos de trabalho e opções específicas de formato.

Mesclar apresentações

Use Merger::process para combinar arquivos de apresentação completos em uma única chamada. As apresentações de entrada devem ter o mesmo formato de arquivo.

use aspose\slides\Merger;

$inputFiles = ["part-1.pptx", "part-2.pptx"];
Merger::process($inputFiles, "merged.pptx");

O auxiliar é apropriado quando todos os slides devem ser acrescentados a um resultado sem selecionar ou remapear individualmente. Use o modelo de objetos completo quando precisar mesclar slides selecionados, aplicar um mestre ou layout de destino, preservar seções explicitamente ou reconciliar tamanhos de slide diferentes. Consulte Merge Presentations para esses cenários.

Iterar pelos elementos da apresentação

A classe ForEach_ invoca um callback para cada tipo solicitado de elemento da apresentação. Ela evita loops de coleção aninhados e é conveniente para inspeção ou alterações de formatação em toda a apresentação.

O exemplo a seguir usa ForEach_::slide, ForEach_::shape, ForEach_::paragraph e ForEach_::portion para inspecionar os elementos correspondentes:

use aspose\slides\ForEach_;
use aspose\slides\Presentation;

class SlideCallback {
    public function invoke($slide, $index): void {
        $slideIndex = java_values($index);
        $shapeCount = java_values($slide->getShapes()->size());
        echo sprintf("Slide %d: %d shapes", $slideIndex, $shapeCount) . PHP_EOL;
    }
}

class ShapeCallback {
    public function invoke($shape, $slide, $index): void {
        $shapeIndex = java_values($index);
        $slideType = java_values($slide->getClass()->getSimpleName());
        $shapeName = java_values($shape->getName());
        echo sprintf("Shape %d on %s: %s", $shapeIndex, $slideType, $shapeName) . PHP_EOL;
    }
}

class ParagraphCallback {
    public function invoke($paragraph, $slide, $index): void {
        $paragraphIndex = java_values($index);
        $slideType = java_values($slide->getClass()->getSimpleName());
        $text = java_values($paragraph->getText());
        echo sprintf("Paragraph %d on %s: %s", $paragraphIndex, $slideType, $text) . PHP_EOL;
    }
}

class PortionCallback {
    public function invoke($portion, $paragraph, $slide, $index): void {
        $portionIndex = java_values($index);
        $slideType = java_values($slide->getClass()->getSimpleName());
        $text = java_values($portion->getText());
        echo sprintf("Portion %d on %s: %s", $portionIndex, $slideType, $text) . PHP_EOL;
    }
}

$presentation = new Presentation("input.pptx");
try {
    $slideCallback = java_closure(new SlideCallback(), null, java('com.aspose.slides.ForEach_$ForEachSlideCallback'));
    $shapeCallback = java_closure(new ShapeCallback(), null, java('com.aspose.slides.ForEach_$ForEachShapeCallback'));
    $paragraphCallback = java_closure(new ParagraphCallback(), null, java('com.aspose.slides.ForEach_$ForEachParagraphCallback'));
    $portionCallback = java_closure(new PortionCallback(), null, java('com.aspose.slides.ForEach_$ForEachPortionCallback'));

    ForEach_::slide($presentation, $slideCallback);
    ForEach_::shape($presentation, $shapeCallback);
    ForEach_::paragraph($presentation, $paragraphCallback);
    ForEach_::portion($presentation, $portionCallback);
} finally {
    $presentation->dispose();
}

Por padrão, a travessia de formas e texto em toda a apresentação inclui slides normais, mestres e layouts. Sobrecargas com um parâmetro includeNotes também podem processar slides de anotações. Use loops de coleção diretos quando a ordem de travessia, saída antecipada, filtragem antes da invocação do callback ou controle detalhado hierárquico for importante.

Coletar formas

Use Collect::shapes quando precisar de uma coleção de todas as formas em uma apresentação em vez de um callback para cada forma. Isso é útil quando o mesmo conjunto será filtrado, contado ou processado mais de uma vez.

use aspose\slides\Collect;
use aspose\slides\Presentation;

$presentation = new Presentation("input.pptx");
try {
    $shapes = Collect::shapes($presentation);

    foreach ($shapes as $shape) {
        $shapeName = java_values($shape->getName());
        $shapeType = java_values($shape->getClass()->getSimpleName());
        echo sprintf("%s: %s", $shapeName, $shapeType) . PHP_EOL;
    }
} finally {
    $presentation->dispose();
}

Use ForEach_::shape em vez disso quando cada forma puder ser manipulada imediatamente e você não precisar reter o resultado coletado.

Comprimir conteúdo da apresentação

A classe Compress pode remover elementos estruturais não usados e reduzir dados de fontes incorporadas:

use aspose\slides\Compress;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation("input.pptx");
try {
    Compress::removeUnusedLayoutSlides($presentation);
    Compress::removeUnusedMasterSlides($presentation);
    Compress::compressEmbeddedFonts($presentation);

    $presentation->save("compressed.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

Remova layouts não usados antes dos mestres não usados, de modo que um mestre que se torne sem referência após a limpeza de layouts também possa ser removido. Salve a apresentação otimizada em um novo arquivo se precisar dos mestres, layouts ou dados completos de fontes incorporadas originais posteriormente. Para mais detalhes, consulte Slide Master e Embedded Font.

FAQ

Quando devo usar a API de baixo código em vez do modelo de objetos completo?

Use os auxiliares de baixo código quando uma operação padrão se aplica a um arquivo ou apresentação completa e não requer controle detalhado sobre elementos individuais. Use o modelo de objetos completo quando precisar selecionar slides específicos, controlar relacionamentos de mestres e layouts, inspecionar o estado intermediário ou configurar comportamentos que o auxiliar não expõe.

O Merger pode combinar apresentações em formatos de arquivo diferentes?

Não. Merger::process requer apresentações de entrada no mesmo formato. Converta os arquivos de entrada para um formato comum primeiro, por exemplo com Convert::autoByExtension, e então mescle os arquivos convertidos.

**O ForEach_ processa slides de mestre, layout e anotações?**

ForEach_::slide itera pelos slides normais da apresentação. As operações de ForEach_::shape, ForEach_::paragraph e ForEach_::portion em toda a apresentação incluem slides normais, de mestre e de layout por padrão. Use suas sobrecargas com includeNotes definido como true para incluir slides de anotações.

**Qual a diferença entre ForEach_::shape e Collect::shapes?**

Use ForEach_::shape para processar cada forma imediatamente por meio de um callback. Use Collect::shapes quando precisar de um resultado iterável que possa ser retido, filtrado, contado ou percorrido várias vezes.

O Compress sempre reduz o tamanho do arquivo da apresentação?

Não necessariamente. O resultado depende de a apresentação conter layouts não usados, mestres não usados ou fontes incorporadas com caracteres não usados. Se nenhum desses itens estiver presente, as operações correspondentes de Compress podem não reduzir o tamanho do arquivo.

**As alterações feitas por ForEach_ ou Compress são salvas automaticamente?**

Não. Esses auxiliares operam no objeto Presentation carregado na memória. Após modificar elementos em um callback de ForEach_ ou executar Compress, chame Presentation::save para gravar o resultado.

Artigos relacionados

Mesclar apresentações de forma eficiente em PHP Importar apresentações de PDF ou HTML em PHP