Slide

Inheritance: java.lang.Object, com.aspose.slides.BaseSlide

All Implemented Interfaces: com.aspose.slides.ISlide

public final class Slide extends BaseSlide implements ISlide

Represents a slide in a presentation.

Methods

MethodDescription
getHeaderFooterManager()Returns HeaderFooter manager of the slide.
getThemeManager()Returns the overriding theme manager.
getSlideNumber()Returns a number of slide.
setSlideNumber(int value)Returns a number of slide.
getHidden()Determines whether the specified slide is hidden during a slide show.
setHidden(boolean value)Determines whether the specified slide is hidden during a slide show.
getShowMasterShapes()Specifies if shapes on the master slide should be shown on slides or not.
setShowMasterShapes(boolean value)Specifies if shapes on the master slide should be shown on slides or not.
getThumbnail(float scaleX, float scaleY)Returns a Thumbnail Bitmap object with custom scaling.
getThumbnail()Returns a Thumbnail Image object (20% of real size).
getThumbnail(Size imageSize)Returns a Thumbnail Bitmap object with specified size.
getThumbnail(ITiffOptions options)Returns a Thumbnail tiff android.graphics.Bitmap object with specified parameters.
getThumbnail(INotesCommentsLayoutingOptions notesCommentsLayouting)Returns a Thumbnail android.graphics.Bitmap object.
getThumbnail(INotesCommentsLayoutingOptions notesCommentsLayouting, float scaleX, float scaleY)Returns a Thumbnail android.graphics.Bitmap object with custom scaling.
getThumbnail(INotesCommentsLayoutingOptions notesCommentsLayouting, Size imageSize)Returns a Thumbnail android.graphics.Bitmap object with specified size.
getThumbnail(IRenderingOptions options)Returns a Thumbnail android.graphics.Bitmap object.
getThumbnail(IRenderingOptions options, float scaleX, float scaleY)Returns a Thumbnail android.graphics.Bitmap object with custom scaling.
getThumbnail(IRenderingOptions options, Size imageSize)Returns a Thumbnail android.graphics.Bitmap object with specified size.
renderToGraphics(INotesCommentsLayoutingOptions notesCommentsLayouting, Canvas graphics, int width, int height)Renders certain slide to a Graphics object using specified size.
renderToGraphics(INotesCommentsLayoutingOptions notesCommentsLayouting, Canvas graphics, float scale)Renders certain slide to a Graphics object using specified scale.
renderToGraphics(INotesCommentsLayoutingOptions notesCommentsLayouting, Canvas graphics)Renders certain slide to a Graphics object.
renderToGraphics(IRenderingOptions options, Canvas graphics)Renders certain slide to a Graphics object.
renderToGraphics(IRenderingOptions options, Canvas graphics, float scaleX, float scaleY)Renders certain slide to a Graphics object with custom scaling.
renderToGraphics(IRenderingOptions options, Canvas graphics, Size renderingSize)Renders certain slide to a Graphics object using specified size.
writeAsSvg(OutputStream stream)Saves content of slide as SVG file.
writeAsSvg(OutputStream stream, ISVGOptions svgOptions)Saves content of slide as SVG file.
remove()Removes slide from presentation.
getLayoutSlide()Returns or sets the layout slide for the current slide.
setLayoutSlide(ILayoutSlide value)Returns or sets the layout slide for the current slide.
reset()Resets position, size and formatting of every shape that has a prototype on LayoutSlide.
getNotesSlideManager()Allow to access notes slide, add and remove it.
getSlideComments(ICommentAuthor author)Returns all slide comments added by specific author.
joinPortionsWithSameFormatting()Joins runs with same formatting in all paragraphs in all acceptable shapes.

getHeaderFooterManager()

public final ISlideHeaderFooterManager getHeaderFooterManager()

Returns HeaderFooter manager of the slide. Read-only ISlideHeaderFooterManager.

Returns: ISlideHeaderFooterManager

getThemeManager()

public final IOverrideThemeManager getThemeManager()

Returns the overriding theme manager. Read-only IOverrideThemeManager.

Returns: IOverrideThemeManager

getSlideNumber()

public final int getSlideNumber()

Returns a number of slide. Index of slide in (Presentation.getSlides) collection is always equal to SlideNumber - Presentation.FirstSlideNumber. Read/write int.

Returns: int

setSlideNumber(int value)

public final void setSlideNumber(int value)

Returns a number of slide. Index of slide in (Presentation.getSlides) collection is always equal to SlideNumber - Presentation.FirstSlideNumber. Read/write int.

Parameters:

ParameterTypeDescription
valueint

getHidden()

public final boolean getHidden()

Determines whether the specified slide is hidden during a slide show. Read/write boolean.

Returns: boolean

setHidden(boolean value)

public final void setHidden(boolean value)

Determines whether the specified slide is hidden during a slide show. Read/write boolean.

Parameters:

ParameterTypeDescription
valueboolean

getShowMasterShapes()

public boolean getShowMasterShapes()

Specifies if shapes on the master slide should be shown on slides or not. Read/write boolean.

Returns: boolean

setShowMasterShapes(boolean value)

public void setShowMasterShapes(boolean value)

Specifies if shapes on the master slide should be shown on slides or not. Read/write boolean.

Parameters:

ParameterTypeDescription
valueboolean

getThumbnail(float scaleX, float scaleY)

public final Bitmap getThumbnail(float scaleX, float scaleY)

Returns a Thumbnail Bitmap object with custom scaling.


The following example shows how to generate thumbnails from PowerPoint Presentation.
 
 // Instantiate a Presentation class that represents the presentation file
 Presentation pres = new Presentation("ThumbnailFromSlide.pptx");
 try {
     // Access the first slide
     ISlide sld = pres.getSlides().get_Item(0);
     // Create a full scale image
     android.graphics.Bitmap bmp = sld.getThumbnail(1f, 1f);
     // Save the image to disk in PNG format
     FileOutputStream fos = null;
     try {
         fos = new FileOutputStream("Thumbnail_out.png");
         bmp.compress(android.graphics.Bitmap.CompressFormat.PNG, 100, fos);
     } finally {
         if (fos != null) fos.close();
     }
 } catch(IOException e) {
 } finally {
     if (pres != null) pres.dispose();
 }
 
 The following example shows how to converting slides to bitmap and saving the images in PNG.
 
 Presentation pres = new Presentation("Presentation.pptx");
 try
 {
     for (ISlide slide : pres.getSlides())
     {
         // Converts the slide in the presentation to a Bitmap object
         android.graphics.Bitmap bmp = slide.getThumbnail();
         // Saves the image in the PNG format
         FileOutputStream fos = null;
         try {
             fos = new FileOutputStream("Thumbnail_out_" + slide.getSlideNumber() + ".png");
             bmp.compress(android.graphics.Bitmap.CompressFormat.PNG, 100, fos);
         } finally {
             if (fos != null) fos.close();
         }
     }
 } catch(IOException e) {
 } finally {
     if (pres != null) pres.dispose();
 }
 
 The following example shows how to convert PowerPoint PPT/PPTX to JPG.
 
 Presentation pres = new Presentation("Presentation.pptx");
 try
 {
     for (ISlide slide : pres.getSlides())
     {
         // Converts the slide in the presentation to a Bitmap object
         android.graphics.Bitmap bmp = slide.getThumbnail();
         // Saves the image in the JPG format
         FileOutputStream fos = null;
         try {
             fos = new FileOutputStream("Thumbnail_out" + slide.getSlideNumber() + ".jpg");
             bmp.compress(android.graphics.Bitmap.CompressFormat.JPEG, 100, fos);
         } finally {
             if (fos != null) fos.close();
         }
     }
 } catch(IOException e) {
 } finally {
     if (pres != null) pres.dispose();
 }
 
 The following example shows how to convert PowerPoint PPT/PPTX to JPG with customized dimensions.
 
 Presentation pres = new Presentation("Presentation.pptx");
 try
 {
     // Define dimensions
     int desiredX = 1200;
     int desiredY = 800;
     // Get scaled values of X and Y
     float ScaleX = (float)(1.0 / pres.getSlideSize().getSize().getWidth()) * desiredX;
     float ScaleY = (float)(1.0 / pres.getSlideSize().getSize().getHeight()) * desiredY;
     for (ISlide slide : pres.getSlides())
     {
         // Converts the first slide in the presentation to a Bitmap object
         android.graphics.Bitmap bmp = slide.getThumbnail(ScaleX, ScaleY);
         // Saves the image in the JPG format
         FileOutputStream fos = null;
         try {
             fos = new FileOutputStream("Slide_" + slide.getSlideNumber() + ".jpg");
             bmp.compress(android.graphics.Bitmap.CompressFormat.JPEG, 100, fos);
         } finally {
             if (fos != null) fos.close();
         }
     }
 } catch(IOException e) {
 } finally {
     if (pres != null) pres.dispose();
 }

Parameters:

ParameterTypeDescription
scaleXfloatThe value by which to scale this Thumbnail in the x-axis direction.
scaleYfloatThe value by which to scale this Thumbnail in the y-axis direction.

Returns: android.graphics.Bitmap - Bitmap object.

getThumbnail()

public final Bitmap getThumbnail()

Returns a Thumbnail Image object (20% of real size).

Returns: android.graphics.Bitmap

getThumbnail(Size imageSize)

public final Bitmap getThumbnail(Size imageSize)

Returns a Thumbnail Bitmap object with specified size.


The following example shows how to converting slides to images with custom sizes using Java.
 
 Presentation pres = new Presentation("Presentation.pptx");
 try {
     // Converts the first slide in the presentation to a Bitmap with the specified size
     android.graphics.Bitmap bmp = pres.getSlides().get_Item(0).getThumbnail(new com.aspose.slides.android.Size(1820, 1040));
     // Saves the image in the JPEG format
     FileOutputStream fos = null;
     try {
         fos = new FileOutputStream("Slide_0.jpg");
         bmp.compress(android.graphics.Bitmap.CompressFormat.JPEG, 100, fos);
     } finally {
         if (fos != null) fos.close();
     }
 } catch(IOException e) {
 } finally {
     if (pres != null) pres.dispose();
 }

Parameters:

ParameterTypeDescription
imageSizeSizeSize of the image to create.

Returns: android.graphics.Bitmap - Bitmap object.

getThumbnail(ITiffOptions options)

public final Bitmap getThumbnail(ITiffOptions options)

Returns a Thumbnail tiff android.graphics.Bitmap object with specified parameters.

Parameters:

ParameterTypeDescription
optionsITiffOptionsTiff options.

Returns: android.graphics.Bitmap - android.graphics.Bitmap object.

getThumbnail(INotesCommentsLayoutingOptions notesCommentsLayouting)

public final Bitmap getThumbnail(INotesCommentsLayoutingOptions notesCommentsLayouting)

Returns a Thumbnail android.graphics.Bitmap object.

Parameters:

ParameterTypeDescription
notesCommentsLayoutingINotesCommentsLayoutingOptionsOptions for notes and comments layouting.

Returns: android.graphics.Bitmap - android.graphics.Bitmap objects.

getThumbnail(INotesCommentsLayoutingOptions notesCommentsLayouting, float scaleX, float scaleY)

public final Bitmap getThumbnail(INotesCommentsLayoutingOptions notesCommentsLayouting, float scaleX, float scaleY)

Returns a Thumbnail android.graphics.Bitmap object with custom scaling.

Parameters:

ParameterTypeDescription
notesCommentsLayoutingINotesCommentsLayoutingOptionsOptions for notes and comments layouting.
scaleXfloatThe value by which to scale this Thumbnail in the x-axis direction.
scaleYfloatThe value by which to scale this Thumbnail in the y-axis direction.

Returns: android.graphics.Bitmap - android.graphics.Bitmap objects.

getThumbnail(INotesCommentsLayoutingOptions notesCommentsLayouting, Size imageSize)

public final Bitmap getThumbnail(INotesCommentsLayoutingOptions notesCommentsLayouting, Size imageSize)

Returns a Thumbnail android.graphics.Bitmap object with specified size.

Parameters:

ParameterTypeDescription
notesCommentsLayoutingINotesCommentsLayoutingOptionsOptions for notes and comments layouting.
imageSizeSizeSize of the image to create.

Returns: android.graphics.Bitmap - android.graphics.Bitmap objects.

getThumbnail(IRenderingOptions options)

public final Bitmap getThumbnail(IRenderingOptions options)

Returns a Thumbnail android.graphics.Bitmap object.

Parameters:

ParameterTypeDescription
optionsIRenderingOptionsRendering options.

Returns: android.graphics.Bitmap - android.graphics.Bitmap objects.

getThumbnail(IRenderingOptions options, float scaleX, float scaleY)

public final Bitmap getThumbnail(IRenderingOptions options, float scaleX, float scaleY)

Returns a Thumbnail android.graphics.Bitmap object with custom scaling.


The following example shows how to converting slides With notes and comments to Images using Java.
 
 Presentation pres = new Presentation("PresentationNotesComments.pptx");
 try {
     // Creates the rendering options
     IRenderingOptions options = new RenderingOptions();
     // Sets the position of the notes on the page
     options.getNotesCommentsLayouting().setNotesPosition(NotesPositions.BottomTruncated);
     // Sets the position of the comments on the page
     options.getNotesCommentsLayouting().setCommentsPosition(CommentsPositions.Right);
     // Sets the width of the comment output area
     options.getNotesCommentsLayouting().setCommentsAreaWidth(500);
     // Sets the color for the comments area
     options.getNotesCommentsLayouting().setCommentsAreaColor(Color.WHITE);
     // Converts the first slide of the presentation to a Bitmap object
     android.graphics.Bitmap bmp = pres.getSlides().get_Item(0).getThumbnail(options, 2f, 2f);
     // Saves the image in the PNG format
     FileOutputStream fos = null;
     try {
         fos = new FileOutputStream("Slide_Notes_Comments_0.png");
         bmp.compress(android.graphics.Bitmap.CompressFormat.PNG, 100, fos);
     } finally {
         if (fos != null) fos.close();
     }
 } catch(IOException e) {
 } finally {
     if (pres != null) pres.dispose();
 }

Parameters:

ParameterTypeDescription
optionsIRenderingOptionsRendering options.
scaleXfloatThe value by which to scale this Thumbnail in the x-axis direction.
scaleYfloatThe value by which to scale this Thumbnail in the y-axis direction.

Returns: android.graphics.Bitmap - android.graphics.Bitmap objects.

getThumbnail(IRenderingOptions options, Size imageSize)

public final Bitmap getThumbnail(IRenderingOptions options, Size imageSize)

Returns a Thumbnail android.graphics.Bitmap object with specified size.

Parameters:

ParameterTypeDescription
optionsIRenderingOptionsRendering options.
imageSizeSizeSize of the image to create.

Returns: android.graphics.Bitmap - android.graphics.Bitmap objects.

renderToGraphics(INotesCommentsLayoutingOptions notesCommentsLayouting, Canvas graphics, int width, int height)

public final void renderToGraphics(INotesCommentsLayoutingOptions notesCommentsLayouting, Canvas graphics, int width, int height)

Renders certain slide to a Graphics object using specified size.

Parameters:

ParameterTypeDescription
notesCommentsLayoutingINotesCommentsLayoutingOptionsOptions for notes and comments layouting.
graphicsandroid.graphics.CanvasThe object where to render to.
widthintThe maximum width (in pixels) that can be occupied by the rendered slide.
heightintThe maximum height (in pixels) that can be occupied by the rendered slide.

renderToGraphics(INotesCommentsLayoutingOptions notesCommentsLayouting, Canvas graphics, float scale)

public final void renderToGraphics(INotesCommentsLayoutingOptions notesCommentsLayouting, Canvas graphics, float scale)

Renders certain slide to a Graphics object using specified scale.

Parameters:

ParameterTypeDescription
notesCommentsLayoutingINotesCommentsLayoutingOptionsOptions for notes and comments layouting.
graphicsandroid.graphics.CanvasThe object where to render to.
scalefloatThe scale for rendering the slide (1.0 is 100%).

renderToGraphics(INotesCommentsLayoutingOptions notesCommentsLayouting, Canvas graphics)

public final void renderToGraphics(INotesCommentsLayoutingOptions notesCommentsLayouting, Canvas graphics)

Renders certain slide to a Graphics object.


The following example shows how to convert the first slide of a PowerPoint presentation to a bitmap object using the RenderToGraphics method.
 
 Presentation pres = new Presentation("Presentation.pptx");
 try {
     // Gets the presentation slide size
     com.aspose.slides.android.SizeF slideSize = pres.getSlideSize().getSize();
     // Creates a Bitmap with the slide size
     android.graphics.Bitmap image = android.graphics.Bitmap.createBitmap((int)slideSize.getWidth(), (int)slideSize.getHeight(), Bitmap.Config.ARGB_8888);
     Canvas graphics = new Canvas(image);
     pres.getSlides().get_Item(0).renderToGraphics(new RenderingOptions(), graphics);
     FileOutputStream fos = null;
     try {
         fos = new FileOutputStream("Slide_0.png");
         image.compress(android.graphics.Bitmap.CompressFormat.PNG, 100, fos);
     } finally {
         if (fos != null) fos.close();
     }
 } catch(IOException e) {
 } finally {
     if (pres != null) pres.dispose();
 }

Parameters:

ParameterTypeDescription
notesCommentsLayoutingINotesCommentsLayoutingOptionsOptions for notes and comments layouting.
graphicsandroid.graphics.CanvasThe object where to render to.

renderToGraphics(IRenderingOptions options, Canvas graphics)

public final void renderToGraphics(IRenderingOptions options, Canvas graphics)

Renders certain slide to a Graphics object.

Parameters:

ParameterTypeDescription
optionsIRenderingOptionsRendering options.
graphicsandroid.graphics.CanvasThe object where to render to.

renderToGraphics(IRenderingOptions options, Canvas graphics, float scaleX, float scaleY)

public final void renderToGraphics(IRenderingOptions options, Canvas graphics, float scaleX, float scaleY)

Renders certain slide to a Graphics object with custom scaling.

Parameters:

ParameterTypeDescription
optionsIRenderingOptionsRendering options.
graphicsandroid.graphics.CanvasThe object where to render to.
scaleXfloatThe scale for rendering the slide (1.0 is 100%) in the x-axis direction.
scaleYfloatThe scale for rendering the slide (1.0 is 100%) in the y-axis direction.

renderToGraphics(IRenderingOptions options, Canvas graphics, Size renderingSize)

public final void renderToGraphics(IRenderingOptions options, Canvas graphics, Size renderingSize)

Renders certain slide to a Graphics object using specified size.


The following example shows how to convert the first slide to the framed image with the RenderToGraphics method.
 
 Presentation pres = new Presentation("Presentation.pptx");
 try {
     // Gets the presentation slide size
     com.aspose.slides.android.Size slideSize = new com.aspose.slides.android.Size(1820, 1040);
     // Creates a Bitmap with the slide size
     android.graphics.Bitmap image = android.graphics.Bitmap.createBitmap((int)slideSize.getWidth() + 50, (int)slideSize.getHeight() + 50, Bitmap.Config.ARGB_8888);
     Canvas graphics = new Canvas(image);
     Paint paint = new Paint();
     paint.setStyle(Paint.Style.FILL);
     paint.setColor(Color.RED);
     graphics.drawRect(0, 0, (int)pres.getSlideSize().getSize().getWidth(), (int)pres.getSlideSize().getSize().getHeight(), paint);
     graphics.translate(25, 25);
     pres.getSlides().get_Item(0).renderToGraphics(new RenderingOptions(), graphics);
     FileOutputStream fos = null;
     try {
         fos = new FileOutputStream("Slide_0.png");
         image.compress(android.graphics.Bitmap.CompressFormat.PNG, 100, fos);
     } finally {
         if (fos != null) fos.close();
     }
 } catch(IOException e) {
 } finally {
     if (pres != null) pres.dispose();
 }
 
 The following example shows how to conversion process for a slide with notes using the RenderToGraphics.
 
 Presentation pres = new Presentation("Presentation.pptx");
 try {
     // Gets the presentation slide size
     com.aspose.slides.android.Size notesSize = new com.aspose.slides.android.Size((int)pres.getNotesSize().getSize().getWidth(), (int)pres.getNotesSize().getSize().getHeight());
     IRenderingOptions options = new RenderingOptions();
     // Sets the position of the notes
     options.getNotesCommentsLayouting().setNotesPosition(NotesPositions.BottomTruncated);
     // Creates a Bitmap with the slide size
     android.graphics.Bitmap image = android.graphics.Bitmap.createBitmap((int)notesSize.getWidth(), (int)notesSize.getHeight(), Bitmap.Config.ARGB_8888);
     Canvas graphics = new Canvas(image);
     Paint paint = new Paint();
     paint.setStyle(Paint.Style.FILL);
     paint.setColor(Color.RED);
     graphics.drawRect(0, 0, (int)pres.getSlideSize().getSize().getWidth(), (int)pres.getSlideSize().getSize().getHeight(), paint);
     graphics.translate(25, 25);
     pres.getSlides().get_Item(0).renderToGraphics(options, graphics, notesSize);
     FileOutputStream fos = null;
     try {
         fos = new FileOutputStream("Slide_0.png");
         image.compress(android.graphics.Bitmap.CompressFormat.PNG, 100, fos);
     } finally {
         if (fos != null) fos.close();
     }
 } catch(IOException e) {
 } finally {
     if (pres != null) pres.dispose();
 }

Parameters:

ParameterTypeDescription
optionsIRenderingOptionsRendering options.
graphicsandroid.graphics.CanvasThe object where to render to.
renderingSizeSizeThe maximum dimensions (in pixels) that can be occupied by the rendered slide.

writeAsSvg(OutputStream stream)

public final void writeAsSvg(OutputStream stream)

Saves content of slide as SVG file.


The following example shows how to convert PowerPoint to PDF with custom options.
 
 // Presentation object can load PowerPoint formats like PPT, PPTX, ODP etc.
 Presentation pres = new Presentation("pres.pptx");
 try {
     for (int index = 0; index < pres.getSlides().size(); index++)
     {
         ISlide slide = pres.getSlides().get_Item(index);
         FileOutputStream fileStream = new FileOutputStream("slide-" + index + ".svg");
         try {
             slide.writeAsSvg(fileStream);
         } finally {
             if (fileStream != null) fileStream.close();
         }
     }
 } catch(IOException e) {
 } finally {
     if (pres != null) pres.dispose();
 }

Parameters:

ParameterTypeDescription
streamjava.io.OutputStreamTarget stream

writeAsSvg(OutputStream stream, ISVGOptions svgOptions)

public final void writeAsSvg(OutputStream stream, ISVGOptions svgOptions)

Saves content of slide as SVG file.


The following example code shows how to generate SVG image with Custom Shape IDS from PowerPoint Presentation.
 
 // Instantiate a Presentation class that represents the presentation file
 Presentation pres = new Presentation("CreateSlidesSVGImage.pptx");
 try {
     // Access the first slide
     ISlide sld = pres.getSlides().get_Item(0);
     // Create a memory stream object
     ByteArrayOutputStream svgStream = new ByteArrayOutputStream();
     // Generate SVG image of slide and save in memory stream
     sld.writeAsSvg(svgStream);
     // Save memory stream to file
     FileOutputStream fileStream = new FileOutputStream("Aspose_out.svg");
     try {
         svgStream.writeTo(fileStream);
     } finally {
         if (fileStream != null) fileStream.close();
     }
     svgStream.close();
 } catch(IOException e) { }
 finally
 {
     if (pres != null) pres.dispose();
 }

Parameters:

ParameterTypeDescription
streamjava.io.OutputStreamTarget stream
svgOptionsISVGOptionsSVG generation options

remove()

public final void remove()

Removes slide from presentation.

getLayoutSlide()

public final ILayoutSlide getLayoutSlide()

Returns or sets the layout slide for the current slide. Read/write ILayoutSlide.

Returns: ILayoutSlide

setLayoutSlide(ILayoutSlide value)

public final void setLayoutSlide(ILayoutSlide value)

Returns or sets the layout slide for the current slide. Read/write ILayoutSlide.

Parameters:

ParameterTypeDescription
valueILayoutSlide

reset()

public final void reset()

Resets position, size and formatting of every shape that has a prototype on LayoutSlide.

getNotesSlideManager()

public final INotesSlideManager getNotesSlideManager()

Allow to access notes slide, add and remove it. Read-only INotesSlideManager.

Returns: INotesSlideManager

getSlideComments(ICommentAuthor author)

public final IComment[] getSlideComments(ICommentAuthor author)

Returns all slide comments added by specific author.

Parameters:

ParameterTypeDescription
authorICommentAuthorAuthor of comments to find or null to return all comments.

Returns: com.aspose.slides.IComment[] - Array of Comment.

joinPortionsWithSameFormatting()

public void joinPortionsWithSameFormatting()

Joins runs with same formatting in all paragraphs in all acceptable shapes.