Criar miniaturas de formas de apresentação em Python via Java

Sobre o que é esta página

Gere miniaturas de forma de alta qualidade a partir de slides do PowerPoint com Aspose.Slides para Python via Java – crie e exporte miniaturas de apresentações facilmente.

Introdução

Aspose.Slides for Python via Java pode ser usado para criar arquivos de apresentação nos quais cada página corresponde a um slide. Os slides podem ser visualizados ao abrir os arquivos de apresentação com o Microsoft PowerPoint. Contudo, os desenvolvedores às vezes precisam visualizar as imagens das formas separadamente em um visualizador de imagens. Nesses casos, Aspose.Slides for Python via Java ajuda a gerar imagens em miniatura das formas do slide.

Este artigo explica como gerar miniaturas de formas de diferentes maneiras:

Gerar uma miniatura de forma dentro de um slide.
Gerar uma miniatura de forma para uma forma de slide com dimensões definidas pelo usuário.
Gerar uma miniatura de forma nos limites da aparência de uma forma.

Gerar uma Miniatura de Forma a partir de um Slide

Para gerar uma miniatura de forma a partir de qualquer slide usando Aspose.Slides for Python via Java, faça o seguinte:

Crie uma instância da classe Presentation.
Obtenha uma referência a um slide usando seu ID ou índice.
Obtenha a imagem em miniatura da forma de uma forma no slide referenciado na escala padrão.
Salve a imagem em miniatura no formato de imagem desejado.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import ImageFormat, Presentation

# Instancia uma classe Presentation que representa o arquivo de apresentação.
presentation = Presentation("Thumbnail.pptx")
try:
    # Crie uma imagem em escala completa.
    shape_image = presentation.getSlides().get_Item(0).getShapes().get_Item(0).getImage()
    try:
        # Salve a imagem no disco no formato PNG.
        shape_image.save("output.png", ImageFormat.Png)
    finally:
        shape_image.dispose()
finally:
    presentation.dispose()

Gerar uma Miniatura com um Fator de Escala Definido pelo Usuário

Para gerar a miniatura de forma de um slide usando Aspose.Slides for Python via Java, faça o seguinte:

Crie uma instância da classe Presentation.
Obtenha uma referência a um slide usando seu ID ou índice.
Obtenha a imagem em miniatura da forma de uma forma no slide referenciado com dimensões definidas pelo usuário.
Salve a imagem em miniatura no formato de imagem desejado.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import ImageFormat, Presentation, ShapeThumbnailBounds

# Instancia uma classe Presentation que representa o arquivo de apresentação.
presentation = Presentation("Thumbnail.pptx")
try:
    # Crie uma imagem escalada por um fator de 2 em ambas as direções.
    shape_image = presentation.getSlides().get_Item(0).getShapes().get_Item(0).getImage(ShapeThumbnailBounds.Shape, 2, 2)
    try:
        # Salve a imagem no disco no formato PNG.
        shape_image.save("output.png", ImageFormat.Png)
    finally:
        shape_image.dispose()
finally:
    presentation.dispose()

Criar uma Miniatura de Aparência de Forma Baseada em Limites

Este método de criação de miniaturas de formas permite que os desenvolvedores gerem uma miniatura dentro dos limites da aparência da forma. Ele leva em conta todos os efeitos da forma. A miniatura de forma gerada é limitada pelos limites do slide. Para gerar uma miniatura de uma forma de slide dentro dos limites de sua aparência, faça o seguinte:

Crie uma instância da classe Presentation.
Obtenha uma referência a um slide usando seu ID ou índice.
Obtenha a imagem em miniatura de uma forma no slide referenciado usando seus limites de aparência.
Salve a imagem em miniatura no formato de imagem desejado.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import ImageFormat, Presentation, ShapeThumbnailBounds

# Instancia uma classe Presentation que representa o arquivo de apresentação.
presentation = Presentation("Thumbnail.pptx")
try:
    # Crie uma imagem em escala completa.
    shape_image = presentation.getSlides().get_Item(0).getShapes().get_Item(0).getImage(ShapeThumbnailBounds.Appearance, 1, 1)
    try:
        # Salve a imagem no disco no formato PNG.
        shape_image.save("output.png", ImageFormat.Png)
    finally:
        shape_image.dispose()
finally:
    presentation.dispose()

Obter os Limites Visuais Reais de uma Forma

As propriedades de quadro de Shape — seus métodos getX, getY, getWidth e getHeight — descrevem o retângulo armazenado no modelo da apresentação. O conteúdo realmente renderizado pode se estender além desse quadro ou ocupar um retângulo alinhado a eixos diferente. Rotação, contornos, pontas de setas, layout e transbordamento de texto, geometria de SmartArt gerada e outros efeitos de renderização podem mudar a área ocupada.

Use Shape.getVisualBounds para calcular essa área ocupada sem criar uma imagem. O método retorna um Rectangle2D.Float nas coordenadas do slide. O retângulo retornado não é recortado ao slide, portanto suas coordenadas podem ser negativas quando o conteúdo se estende além da origem do slide.

O exemplo a seguir obtém e compara os limites de quadro e os limites visuais:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation
from java.awt.geom import Rectangle2D

presentation = Presentation("example.pptx")
try:
    slide = presentation.getSlides().get_Item(0)
    shape = slide.getShapes().get_Item(0)

    visual_bounds = shape.getVisualBounds()
    frame_bounds = Rectangle2D.Float(shape.getX(), shape.getY(), shape.getWidth(), shape.getHeight())

    print("Frame bounds:", frame_bounds)
    print("Visual bounds:", visual_bounds)
finally:
    presentation.dispose()

O mesmo Rectangle2D.Float pode ser usado para alinhar formas próximas à sua borda esquerda, direita, superior ou inferior; reservar espaço suficiente em um layout gerado; ou detectar conteúdo fora de uma região permitida. Os limites visuais são particularmente úteis para SmartArt, caixas de texto, setas, imagens, formas giradas e formas agrupadas, onde o quadro armazenado pode não representar o resultado renderizado completo.

Use Shape.getVisualBounds quando precisar de coordenadas para layout ou validação e não precisar de um bitmap. Use Shape.getImage quando precisar renderizar a forma. Com ShapeThumbnailBounds, ShapeThumbnailBounds.Shape dimensiona a imagem a partir dos limites da forma, incluindo configurações de contorno, enquanto ShapeThumbnailBounds.Appearance a dimensiona a partir da aparência da forma e restringe o resultado aos limites do slide. Em contraste, Shape.getVisualBounds retorna apenas o retângulo calculado e não o recorta ao slide.

Perguntas frequentes

Quais formatos de imagem podem ser usados ao salvar miniaturas de formas?

PNG, JPEG, BMP, GIF, TIFF, e outros. As formas também podem ser exportadas como SVG vetorial salvando o conteúdo da forma como SVG.

Qual é a diferença entre os limites Shape e Appearance ao renderizar uma miniatura?

Shape usa a geometria da forma; Appearance considera os efeitos visuais (sombras, brilhos, etc.).

O que acontece se uma forma for marcada como oculta? Ela ainda será renderizada como miniatura?

Uma forma oculta continua fazendo parte do modelo e pode ser renderizada; o sinalizador oculto afeta a exibição da apresentação, mas não impede a geração da imagem da forma.

Formas agrupadas, gráficos, SmartArt e outros objetos complexos são suportados?

Sim. Qualquer objeto representado como Shape (incluindo GroupShape, Chart, e SmartArt) pode ser salvo como miniatura ou como SVG.

As fontes instaladas no sistema afetam a qualidade das miniaturas para formas de texto?

Sim. Você deve fornecer as fontes necessárias (ou configurar substituições de fontes) para evitar substituições indesejadas e o reflow do texto.

Aplicar Animações de Forma em Apresentações Usando Python via Java Gerenciar Controles ActiveX em Apresentações Usando Python