Aspose.Slides for Java 19.6 Release Notes

Key Summary Category
SLIDESNET-41142 Support for setting lock Aspect Ratio for text box Feature
SLIDESNET-41092 IColorFormat.Color does not return effective color Feature
SLIDESNET-34681 Support for progress in percentage for PDF conversion Feature
SLIDESNET-41101 Implement a progress in percentage for PDF conversion Feature
SLIDESNET-40958 Option for making every page self-sufficient when saving presentation as HTML Feature
SLIDESNET-16733 Fusion Charts support in Aspose.Slides Feature
SLIDESNET-31569 Adding custom lines in PowerPoint charts Feature
SLIDESJAVA-40672 Support for extracting VBA macros from presentation Feature
SLIDESJAVA-30385 Auto-Refresh Chart with Editing data Feature
SLIDESJAVA-18215 Support for ComponentArt chart objects in Aspose.Slides Feature
SLIDESNET-41149 Generating Box and Whisker Chart Enhancement
SLIDESNET-12438 SmartArt and Chart Object implementation for PPTX -> PDF Enhancement
SLIDESJAVA-37603 Added video cannot be played in PowerPoint 2010 Bug
SLIDESJAVA-37665 Changing the Slide Size pushes text outside of the slide Bug
SLIDESJAVA-37639 Setting bubble chart value from cell Bug
SLIDESJAVA-37637 Thumbnails are not properly generated Bug
SLIDESJAVA-37663 Setting text properties not getting applied on Master SlideNumber field placholder Bug
SLIDESJAVA-37595 Formatting of speakernotes is incorrect Bug
SLIDESJAVA-37654 Image quality reduced in HTML Bug
SLIDESJAVA-37407 PPTX not properly converted to PDF Bug
SLIDESJAVA-37605 PPTX not properly converted to PDF Bug
SLIDESJAVA-37420 Generating Thumbnails took long time Bug
SLIDESJAVA-37474 ODP not properly converted to PPTX Bug
SLIDESJAVA-37599 Hyperlinks are not working in cloned presentation Bug
SLIDESJAVA-37624 Bad data returned for IShapeFrame Bug
SLIDESJAVA-34163 Equation failed to render PDF in Windows and Sles environments Bug
SLIDESJAVA-37484 ODP file not properly converted to PPTX Bug
SLIDESJAVA-37606 PPT not properly converted to JPG Bug

Public API Changes

BackgroundEffectiveData class and IBackgroundEffectiveData interface have been added

The com.aspose.slides.IBackgroundEffectiveData interface and it’s implementation by com.aspose.slides.BackgroundEffectiveData class have been added. They represent an effective background of a slide and contain information about effective fill format and effective effect format.

/**
 * <p>
 * Immutable object which contains background properties.
 * </p>
 */
public interface IBackgroundEffectiveData extends IFillParamSource
{
    /**
     * <p>
     * Returns effective fill format.
     * Read-only {@link IFillFormatEffectiveData}.
     * </p>
     */
    public IFillFormatEffectiveData getFillFormat();

    /**
     * <p>
     * Returns effective effect format.
     * Read-only {@link IEffectFormatEffectiveData}.
     * </p>
     */
    public IEffectFormatEffectiveData getEffectFormat();
    
}

IBaseSlide.createBackgroundEffective method has been added

The createBackgroundEffective method has been added to IBaseSlide interface and BaseSlide class. Using this method allows getting effective values for a slide’s background.

Sample code below outputs effective background fill:

Presentation pres = new Presentation("SamplePresentation.pptx");
IBackgroundEffectiveData effBackground = pres.getSlides().get_Item(0).createBackgroundEffective();
if (effBackground.getFillFormat().getFillType() == FillType.Solid)
    System.out.println("Fill color: " + effBackground.getFillFormat().getSolidFillColor());
else
    System.out.println("Fill type: " + effBackground.getFillFormat().getFillType());

New IProgressCallback interface has been added

New IProgressCallback interface has been added to ISaveOptions interface and SaveOptions abstract class.

IProgressCallback interface represents a callback object for saving progress updates in percentage.

/**
 * <p>
 * Represents a callback object for saving progress updates in percentage.
 * </p>
 */
public interface IProgressCallback
{
    /**
     * <p>
     * Reports a progress update.
     * </p>
     * @param progressValue The value of the updated progress.
     */
    public void reporting(double progressValue);
}

Code snippets below show how to use IProgressCallback interface:

Presentation presentation = new Presentation("fileName");
try
{
    ISaveOptions saveOptions = new PdfOptions();
    saveOptions.setProgressCallback(new ExportProgressHandler());
    presentation.save("pdfFileName", SaveFormat.Pdf, saveOptions);
}finally {
    presentation.dispose();
}

class ExportProgressHandler implements IProgressCallback {
    public void reporting(double progressValue) {
        // Use progress percentage value here
    }
}
Following methods of the INotesSlide interface have been removed:
  • public java.awt.image.BufferedImage getThumbnail(float scaleX, float scaleY);
  • public java.awt.image.BufferedImage getThumbnail(java.awt.Dimension imageSize);

Use ISlide.getThumbnail method with a parameter of type INotesCommentsLayoutingOptions instead.

Following methods of the ISlide interface have been removed:
  • public void renderToGraphics(boolean withNotes, java.awt.Graphics2D graphics, int width, int height);
  • public void renderToGraphics(boolean withNotes, java.awt.Graphics2D graphics, float scale);
  • public void renderToGraphics(boolean withNotes, java.awt.Graphics2D graphics);

Use renderToGraphics method with a parameter of type INotesCommentsLayoutingOptions instead.

Following methods have been removed from IHtmlOptions, IPdfOptions, ISwfOptions and ITiffOptions interfaces.
  • public boolean getIncludeComments();
  • public void setIncludeComments(boolean value);

Use INotesCommentsLayoutingOptions interface instead.

Named constants PdfNotes, TiffNotes, SwfNotes and HtmlNotes have been removed from the SaveFormat enumeration.

Use specific options with INotesCommentsLayoutingOptions element for saving presentation instead.

The Pot value has been added to LoadFormat and SaveFormat enumerations

The new Pot value has been added to com.aspose.slides.LoadFormat and com.aspose.slides.SaveFormat enumerations. This value represents the Microsoft PowerPoint 97-2003 Presentation template format.

Support of management images as BLOBs has been added

Since version 19.6 Aspose.Slides supports managing of presentation images as BLOB. The main article about BLOBs management is here.

Also, the new method has been added to IImageCollection interface and ImageCollection class to support adding large image as streams to treat them as BLOBs:

public IPPImage addImage(java.io.InputStream stream, int loadingStreamBehavior);
Adding a new image as BLOB to the presentation.

This example demonstrates how to include a large BLOB (image) and prevent high memory consumption.

static void addingNewBlobImageToPresentation()
{
    // supposed we have the large image file we want to include into the presentation
    String pathToLargeImage = "largeImage.png";

    // create a new presentation which will contain this image
    Presentation pres = new Presentation();
    try
    {
        FileInputStream fip = new FileInputStream(pathToLargeImage);
        try
        {
            // let's add the image to the presentation - we choose KeepLocked behavior, because we not
            // have an intent to access the "largeImage.png" file.
            IPPImage img = pres.getImages().addImage(fip, LoadingStreamBehavior.KeepLocked);
            pres.getSlides().get_Item(0).getShapes().addPictureFrame(ShapeType.Rectangle, 0, 0, 300, 200, img);

            // save the presentation. Despite that the output presentation will be
            // large, the memory consumption will be low the whole lifetime of the pres object
            pres.save("presentationWithLargeImage.pptx", SaveFormat.Pptx);
        }
        finally {
            fip.close();
        }
    } catch (java.io.IOException e) {
        e.printStackTrace();
    } finally {
        pres.dispose();
    }
}