Aspose.Slides for Java 26.11 Release Notes

/**
 * <p>
 * Represents a cached chart value (e.g., X, Y, bubble size, or the main value).
 * </p>
 */
public interface ICachedChartValue
{
    /**
     * <p>
     * Gets the cached data object.
     * Read-only {@code Object}.
     * </p>
     */
    public Object getData();

    /**
     * <p>
     * Converts the cached value to a double.
     * </p>
     * @return 
     * The numeric representation, or Double.NaN if Data ({@link #getData})
     * is null or cannot be converted to a double.
     */
    public double toDouble();
}

Presentation pres = new Presentation("Chart.pptx");
try {
    IChart chart = (IChart)pres.getSlides().get_Item(0).getShapes().get_Item(0);
    for (IChartSeries series : chart.getChartData().getSeries())
    {
        // Print all cached values of the chart series.
        for (IChartDataPoint point : series.getDataPoints())
        {
            printCachedValue(point.getCachedValue());
            printCachedValue(point.getCachedXValue());
            printCachedValue(point.getCachedYValue());
            printCachedValue(point.getCachedBubbleSize());
        }
    }
} finally {
    pres.dispose();
}

static void printCachedValue(ICachedChartValue cachedValue)
{
    if (cachedValue.getData() == null)
        System.out.println("No cached data");

    double value = cachedValue.toDouble();
    if (!Double.isNaN(value))
        System.out.println("Numeric cached data: " + value);

    System.out.println("String cached data: " + cachedValue.toString());
}

Presentation pres = new Presentation("Chart.pptx");
try {
    IChart chart = (IChart)pres.getSlides().get_Item(0).getShapes().get_Item(0);

    // Print all cached chart category values.
    for (IChartCategory category : chart.getChartData().getCategories())
        System.out.println(category.getCachedValue().getData() == null ? "No cached data" : category.getCachedValue().toString());
} finally {
    pres.dispose();
}

/**
 * <p>
 * Specifies whether registered fonts should be preferred over embedded fonts with the same font name and style.
 * When enabled, matching embedded fonts are temporarily replaced with corresponding registered fonts during export.
 * </p>
 */
public boolean getPreferRegisteredFontsOverEmbedded();
/**
 * <p>
 * Specifies whether registered fonts should be preferred over embedded fonts with the same font name and style.
 * When enabled, matching embedded fonts are temporarily replaced with corresponding registered fonts during export.
 * </p>
 */
public void setPreferRegisteredFontsOverEmbedded(boolean value);

Presentation pres = new Presentation("SomePresentation.pptx");
try {
    pres.getFontsManager().setPreferRegisteredFontsOverEmbedded(true);
    pres.save("presentation-out.pdf", SaveFormat.Pdf);
} finally {
    pres.dispose();
}

/**
 * <p>
 *  Gets or sets the shape type of the data label.
 *  Returns {@link ShapeType#NotDefined} if no shape is defined.
 *  </p>
 */
public int getLabelShapeType();
/**
 * <p>
 *  Gets or sets the shape type of the data label.
 *  Returns ShapeType#NotDefined if no shape is defined.
 *  </p>
 */
public void setLabelShapeType(int value);

Presentation pres = new Presentation("Chart.pptx");
try {
    IChart chart = (IChart)pres.getSlides().get_Item(0).getShapes().get_Item(1);
    IChartSeries firstSeries = chart.getChartData().getSeries().get_Item(0);

    // Set the shape type of the first data label to Ellipse.
    firstSeries.getLabels().get_Item(0).setLabelShapeType(ShapeType.Ellipse);

    pres.save("ChartWithEllipseLabel.pptx", SaveFormat.Pptx);
} finally {
    pres.dispose();
}

/**
 * <p>
 *  Gets or sets the default shape type for data labels.
 *  Returns {@link ShapeType#NotDefined} if no shape is defined.
 *  </p>
 */
public int getDefaultLabelShapeType();
/**
 * <p>
 *  Gets or sets the default shape type for data labels.
 *  Returns {@link ShapeType#NotDefined} if no shape is defined.
 *  </p>
 */
public void setDefaultLabelShapeType(int value);

Presentation pres = new Presentation("Chart.pptx");
try {
    IChart chart = (IChart)pres.getSlides().get_Item(0).getShapes().get_Item(1);
    IChartSeries firstSeries = chart.getChartData().getSeries().get_Item(0);

    // Set the shape type of all data labels in the first series to Ellipse.
    firstSeries.getLabels().setDefaultLabelShapeType(ShapeType.Ellipse);

    pres.save("ChartWithEllipseLabels.pptx", SaveFormat.Pptx);
} finally {
    pres.dispose();
}

Presentation pres = new Presentation("ChartWithEllipseLabels.pptx");
try {
    IChart chart = (IChart)pres.getSlides().get_Item(0).getShapes().get_Item(1);
    IChartSeries firstSeries = chart.getChartData().getSeries().get_Item(0);

    // Reset the shape type of all data labels in the first series.
    firstSeries.getLabels().setDefaultLabelShapeType(ShapeType.NotDefined);

    pres.save("ChartWithoutLabelShapes.pptx", SaveFormat.Pptx);
} finally {
    pres.dispose();
}

Presentation presentation = new Presentation("PresentationWithChart.pptx");
try {
    IChart chart = (IChart)presentation.getSlides().get_Item(0).getShapes().get_Item(0);
    chart.getChartData().refreshData();
} finally {
    presentation.dispose();
}

Presentation presentation = new Presentation("PresentationWithCharts.pptx");
try {
    presentation.refreshChartsData();
    presentation.save("PresentationWithCharts-out.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Presentation pres = new Presentation();
try {
    byte[] videoData = Files.readAllBytes(Paths.get("video.mp4"));
    IVideo video = pres.getVideos().addVideo(videoData);
    IVideoFrame videoFrame = pres.getSlides().get_Item(0).getShapes().addVideoFrame(0, 0, 100, 100, video);

    videoFrame.setVolumeValue(75.5f);

    pres.save("video-out.pptx", SaveFormat.Pptx);
} catch(IOException e) {
} finally {
    pres.dispose();
}

Presentation presentation = new Presentation("pres.pptx");
try {
    IAutoShape shape = (IAutoShape)presentation.getSlides().get_Item(0).getShapes().get_Item(0);
    Rectangle2D.Float textRectangle = shape.getTextFrame().getTextRect();

    System.out.println(String.format(
            "X=%f, Y=%f, Width=%f, Height=%f",
            textRectangle.getX(),
            textRectangle.getY(),
            textRectangle.getWidth(),
            textRectangle.getHeight()));
} finally {
    presentation.dispose();
}

/**
 * <p>
 * Reduces the size of a presentation by applying all available compression steps:
 * <ul type="bullet">
 * <li><span>Removes unused master slides {@link #removeUnusedMasterSlides(Presentation)}.</span></li>
 * <li><span>Removes unused layout slides {@link #removeUnusedLayoutSlides(Presentation)}.</span></li>
 * <li><span>Keeps only the glyphs actually used in embedded fonts {@link #compressEmbeddedFonts(Presentation)}.</span></li>
 * <li><span>Reduces picture resolution to 150 DPI and deletes cropped areas of pictures {@link #compressImages(IPresentation,int)}.</span></li>
 * </ul>
 * </p>
 */
public static void compressPresentation(Presentation presentation)

Presentation pres = new Presentation("pres.pptx");
try {
    Compress.compressPresentation(pres);

    pres.save("pres-out.pptx", SaveFormat.Pptx);
} finally {
    pres.dispose();
}

/**
 * <p>
 * Reduces the resolution of pictures in the presentation and deletes their cropped areas,
 * similar to PowerPoint's "Compress Pictures" applied to all pictures.
 * Pictures on slides, layout slides and master slides are processed, including pictures inside group shapes
 * and picture fills of shapes.
 * </p>
 */
public static void compressImages(IPresentation presentation, int resolution)

Presentation pres = new Presentation("demo.pptx");
try {
    Compress.compressImages(pres, PicturesCompression.Dpi150);

    pres.save("pres-out.pptx", SaveFormat.Pptx);
} finally {
    pres.dispose();
}