Criar Miniaturas de Formas de Apresentação em .NET

Introdução

O Aspose.Slides for .NET é usado para criar arquivos de apresentação onde cada página é um slide. Esses slides podem ser visualizados abrindo os arquivos de apresentação usando o Microsoft PowerPoint. Mas às vezes, os desenvolvedores podem precisar ver as imagens das formas separadamente em um visualizador de imagens. Nesses casos, o Aspose.Slides for .NET ajuda a gerar imagens em miniatura das formas dos slides. Como usar esse recurso é descrito neste artigo.

Este artigo explica como gerar miniaturas de slides 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 o Aspose.Slides for .NET:

1. Crie uma instância da classe Presentation.
2. Obtenha a referência de qualquer slide usando seu ID ou índice.
3. Recupere a imagem da miniatura da forma do slide referenciado na escala padrão.
4. Salve a imagem da miniatura em qualquer formato de imagem desejado.

O exemplo abaixo gera a miniatura da forma.

using (Presentation presentation = new Presentation("HelloWorld.pptx"))
{
    IShape shape = presentation.Slides[0].Shapes[0];
    using (IImage image = shape.GetImage())
    {
        image.Save("Shape_thumbnail_out.png", ImageFormat.Png);
    }
}

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

Para gerar a miniatura da forma de qualquer forma de slide usando o Aspose.Slides for .NET:

1. Crie uma instância da classe Presentation.
2. Obtenha a referência de qualquer slide usando seu ID ou índice.
3. Recupere a imagem da miniatura do slide referenciado com os limites da forma.
4. Salve a imagem da miniatura em qualquer formato de imagem desejado.

O exemplo abaixo gera uma miniatura usando um fator de escala definido pelo usuário.

ShapeThumbnailBounds bounds = ShapeThumbnailBounds.Shape;
float scale = 1; // Escalonamento ao longo dos eixos X e Y.

using (Presentation presentation = new Presentation("HelloWorld.pptx"))
{
    IShape shape = presentation.Slides[0].Shapes[0];
    using (IImage image = shape.GetImage(bounds, scale, scale))
    {
        image.Save("Scaling Factor Thumbnail_out.png", ImageFormat.Png);
    }
}

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

Este método para criar miniaturas de formas permite que os desenvolvedores gerem uma miniatura dentro dos limites da aparência da forma. Ele leva em consideração todos os efeitos da forma. A miniatura da forma gerada é limitada pelos limites do slide. Para gerar uma miniatura de qualquer forma de slide dentro dos limites de sua aparência, use o código de exemplo a seguir:

1. Crie uma instância da classe Presentation.
2. Obtenha a referência de qualquer slide usando seu ID ou índice.
3. Recupere a imagem da miniatura do slide referenciado com os limites da forma como aparência.
4. Salve a imagem da miniatura em qualquer formato de imagem desejado.

O exemplo abaixo cria uma miniatura usando um fator de escala definido pelo usuário.

ShapeThumbnailBounds bounds = ShapeThumbnailBounds.Appearance;
float scale = 1; // Escalonamento ao longo dos eixos X e Y.

using (Presentation presentation = new Presentation("HelloWorld.pptx"))
{
    IShape shape = presentation.Slides[0].Shapes[0];
    using (IImage image = shape.GetImage(bounds, scale, scale))
    {
        image.Save("Shape_thumbnail_Bound_Shape_out.png", ImageFormat.Png);
    }
}

Perguntas Frequentes

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

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 leva em conta 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; a flag oculta afeta a exibição da apresentação, mas não impede a geração da imagem da forma.

Formas de grupo, 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 de formas de texto?

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