Convert Presentation Slides to Images on Android

What this page is about

Convert slides from PPT, PPTX, and ODP presentations to PNG, JPEG, GIF, TIFF, EMF, and other image formats on Android with Aspose.Slides.

Introduction

Aspose.Slides for Android via Java can render individual slides from PowerPoint and OpenDocument presentations as PNG, JPEG, GIF, TIFF, and other image formats.

To convert a slide into an image, follow these steps:

Load the presentation with the Presentation class.
Select the slide that you want to render.
If necessary, configure rendering with the RenderingOptions or TiffOptions class.
Call the ISlide.getImage method. It returns an IImage object.
Call the IImage.save method and specify the output format with an ImageFormat value.

Convert a Slide to a PNG Image

The simplest conversion uses the default rendering settings. The resulting IImage object can be processed in memory or saved to a file.

The following Java example renders the first slide and saves it as a PNG image:

import com.aspose.slides.IImage;
import com.aspose.slides.ISlide;
import com.aspose.slides.ImageFormat;
import com.aspose.slides.Presentation;

Presentation presentation = new Presentation("Presentation.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IImage image = slide.getImage();
    try {
        image.save("Slide_0.png", ImageFormat.Png);
    } finally {
        image.dispose();
    }
} finally {
    presentation.dispose();
}

Convert Slides to Images with Custom Sizes

Use the ISlide.getImage overload that accepts a Size value to render a slide with exact pixel dimensions.

The following example creates a 1820 × 1040 JPEG image:

import com.aspose.slides.IImage;
import com.aspose.slides.ISlide;
import com.aspose.slides.ImageFormat;
import com.aspose.slides.Presentation;
import com.aspose.slides.android.Size;

Size imageSize = new Size(1820, 1040);

Presentation presentation = new Presentation("Presentation.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IImage image = slide.getImage(imageSize);
    try {
        image.save("Slide_0.jpg", ImageFormat.Jpeg);
    } finally {
        image.dispose();
    }
} finally {
    presentation.dispose();
}

Convert Slides with Notes and Comments to Images

By default, slide images do not include notes or comments. Pass a NotesCommentsLayoutingOptions object to the RenderingOptions.setSlidesLayoutOptions method to control where notes and comments appear.

The following example places truncated notes below the slide and comments to its right:

import android.graphics.Color;
import com.aspose.slides.CommentsPositions;
import com.aspose.slides.IImage;
import com.aspose.slides.ISlide;
import com.aspose.slides.ImageFormat;
import com.aspose.slides.NotesCommentsLayoutingOptions;
import com.aspose.slides.NotesPositions;
import com.aspose.slides.Presentation;
import com.aspose.slides.RenderingOptions;

float scaleX = 2f;
float scaleY = scaleX;

int commentsAreaColor = Color.rgb(250, 235, 215);

NotesCommentsLayoutingOptions layoutOptions = new NotesCommentsLayoutingOptions();
layoutOptions.setNotesPosition(NotesPositions.BottomTruncated);
layoutOptions.setCommentsPosition(CommentsPositions.Right);
layoutOptions.setCommentsAreaWidth(500);
layoutOptions.setCommentsAreaColor(commentsAreaColor);

RenderingOptions renderingOptions = new RenderingOptions();
renderingOptions.setSlidesLayoutOptions(layoutOptions);

Presentation presentation = new Presentation("Presentation_with_notes_and_comments.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IImage image = slide.getImage(renderingOptions, scaleX, scaleY);
    try {
        image.save("Image_with_notes_and_comments_0.gif", ImageFormat.Gif);
    } finally {
        image.dispose();
    }
} finally {
    presentation.dispose();
}

Warning

For slide-to-image conversion, do not pass BottomFull to the NotesCommentsLayoutingOptions.setNotesPosition method. Notes can contain more text than the fixed image size can accommodate. Use BottomTruncated instead.

Convert Slides to Images Using TIFF Options

The TiffOptions class lets you control the size, resolution, and other properties of the rendered TIFF image.

The following example renders the first slide as a 2160 × 2880 TIFF image at 300 DPI:

import com.aspose.slides.IImage;
import com.aspose.slides.ISlide;
import com.aspose.slides.ImageFormat;
import com.aspose.slides.Presentation;
import com.aspose.slides.TiffOptions;
import com.aspose.slides.android.Size;

Size imageSize = new Size(2160, 2880);

TiffOptions tiffOptions = new TiffOptions();
tiffOptions.setImageSize(imageSize);
tiffOptions.setDpiX(300);
tiffOptions.setDpiY(300);

Presentation presentation = new Presentation("sample.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IImage image = slide.getImage(tiffOptions);
    try {
        image.save("output.tiff", ImageFormat.Tiff);
    } finally {
        image.dispose();
    }
} finally {
    presentation.dispose();
}

Convert All Slides to Images

Iterate through the slide collection to convert the entire presentation into a series of images. Hidden slides are included unless you explicitly skip them.

The following example renders every slide as a JPEG image with horizontal and vertical scale factors of 2:

import com.aspose.slides.IImage;
import com.aspose.slides.ISlide;
import com.aspose.slides.ImageFormat;
import com.aspose.slides.Presentation;

float scaleX = 2f;
float scaleY = scaleX;

Presentation presentation = new Presentation("Presentation.pptx");
try {
    int slideCount = presentation.getSlides().size();
    for (int index = 0; index < slideCount; index++) {
        ISlide slide = presentation.getSlides().get_Item(index);
        IImage image = slide.getImage(scaleX, scaleY);
        try {
            image.save("Slide_" + index + ".jpg", ImageFormat.Jpeg);
        } finally {
            image.dispose();
        }
    }
} finally {
    presentation.dispose();
}

Create Enhanced Metafile Output

Enhanced Metafile (EMF) is useful when vector-based graphics must be exchanged with Microsoft Office or other Windows applications that support Windows metafiles. Unlike a pixel-based image, an EMF can retain vector drawing operations that scale without the same loss of sharpness. However, EMF is primarily a compatibility format for applications with Windows metafile support, not a universal interchange format. In addition, complex slide content, such as bitmap images and some effects, may be stored as rasterized elements inside the vector metafile container.

Export a Slide to EMF

The ISlide.writeAsEmf method writes an ISlide to a target stream in EMF format. The following example loads a presentation, selects the first slide, and writes it to an EMF file stream:

import com.aspose.slides.ISlide;
import com.aspose.slides.Presentation;
import java.io.FileOutputStream;

Presentation presentation = new Presentation("Presentation.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    FileOutputStream emfStream = new FileOutputStream("Slide_0.emf");
    try {
        slide.writeAsEmf(emfStream);
    } finally {
        emfStream.close();
    }
} finally {
    presentation.dispose();
}

The caller owns the stream passed to ISlide.writeAsEmf and is responsible for closing it, as shown above.

Convert an SVG Image to EMF and Add It to a Presentation

Use ISvgImage.writeAsEmf to convert SVG content to EMF. The resulting bytes can be added to the presentation through IImageCollection.addImage and placed on a slide with IShapeCollection.addPictureFrame.

The following example creates an SvgImage from SVG markup, converts it to an in-memory EMF, inserts the metafile on the first slide, and saves the presentation:

import com.aspose.slides.IPPImage;
import com.aspose.slides.ISlide;
import com.aspose.slides.ISvgImage;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;
import com.aspose.slides.ShapeType;
import com.aspose.slides.SvgImage;
import java.io.ByteArrayOutputStream;

String svgContent = "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"200\" height=\"100\"><rect width=\"200\" height=\"100\" fill=\"#4472C4\"/></svg>";
ISvgImage svgImage = new SvgImage(svgContent);

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    ByteArrayOutputStream emfStream = new ByteArrayOutputStream();
    try {
        svgImage.writeAsEmf(emfStream);

        byte[] emfData = emfStream.toByteArray();
        IPPImage image = presentation.getImages().addImage(emfData);
        slide.getShapes().addPictureFrame(ShapeType.Rectangle, 20, 20, 200, 100, image);
    } finally {
        emfStream.close();
    }

    presentation.save("Presentation_with_emf.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

ISvgImage.writeAsEmf does not take ownership of the destination stream. A ByteArrayOutputStream stores all generated data in memory, so no position reset is required before calling toByteArray. The returned byte array remains valid after the stream is closed.

EMF generation is available on supported Android versions and device configurations, but rendering can differ when fonts or graphics dependencies are unavailable. Install the fonts used by the source content or configure suitable substitutions, follow the installation guide for Aspose.Slides for Android via Java, and validate the result in the target EMF-consuming application. Applications on non-Windows platforms often have limited or inconsistent support for displaying and editing Windows metafiles.

Color Emoji Rendering

Note

To render color emojis correctly when converting presentation slides to images, the emoji fonts used in the presentation must be installed and available on the system performing the conversion. For example, if the presentation uses Segoe UI Emoji and this font is missing, emojis may appear in monochrome in the output images.

FAQ

Does Aspose.Slides support rendering slides with animations?

No. The ISlide.getImage method renders a static image of the slide and does not export animations.

Can hidden slides be exported as images?

Yes. Hidden slides can be rendered like regular slides. Include them in the processing loop, as shown in the example above.

Are shadows and other effects preserved in slide images?

Yes. Aspose.Slides renders shadows, transparency, and other supported graphical effects in slide images.

Remove Slides from Presentations on Android Compare Presentation Slides on Android