使用 Java 自定义演示文稿中的 3D 图表

概述

Aspose.Slides for Java 允许您通过 IChart.getRotation3D 方法自定义 3D 图表的视图。本文演示如何调整旋转、高度比例、深度、直角坐标轴以及系列之间的间距,然后将演示文稿保存为 PPTX 格式。

设置 3D 图表的旋转和深度

下面的示例创建一个 Presentation 并使用 IShapeCollection.addChart 在其第一张幻灯片上添加一个堆叠的 3D 柱形图。它用两个每个包含三个值的系列替换默认的系列和类别。工作表索引 0 标识图表的第一个数据工作表;第 0 行保存系列名称,第 0 列保存类别标签。

The setRotationX 和 setRotationY 方法分别将图表的旋转设置为 40° 和 270°。setDepthPercents 将其深度设置为宽度的 150%,而 setRightAngleAxes 则启用直角坐标轴而不是透视。生成的演示文稿包含已填充数据的图表,并应用这些 3D 视图设置。

import com.aspose.slides.*;

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

    IChart chart = slide.getShapes().addChart(ChartType.StackedColumn3D, 0, 0, 500, 500);

    chart.getChartData().getSeries().clear();
    chart.getChartData().getCategories().clear();

    IChartDataWorkbook workbook = chart.getChartData().getChartDataWorkbook();
    int worksheetIndex = 0;

    double[][] values = { { 20, 50, 30 }, { 30, 10, 60 } };

    for (int categoryIndex = 0; categoryIndex < 3; categoryIndex++) {
        IChartDataCell categoryCell = workbook.getCell(worksheetIndex, categoryIndex + 1, 0, "Category " + (categoryIndex + 1));
        chart.getChartData().getCategories().add(categoryCell);
    }

    for (int seriesIndex = 0; seriesIndex < 2; seriesIndex++) {
        IChartDataCell seriesCell = workbook.getCell(worksheetIndex, 0, seriesIndex + 1, "Series " + (seriesIndex + 1));
        IChartSeries series = chart.getChartData().getSeries().add(seriesCell, chart.getType());

        for (int categoryIndex = 0; categoryIndex < 3; categoryIndex++) {
            IChartDataCell valueCell = workbook.getCell(worksheetIndex, categoryIndex + 1, seriesIndex + 1, values[seriesIndex][categoryIndex]);
            series.getDataPoints().addDataPointForBarSeries(valueCell);
        }
    }

    chart.getRotation3D().setRightAngleAxes(true);
    chart.getRotation3D().setRotationX((byte) 40);
    chart.getRotation3D().setRotationY(270);
    chart.getRotation3D().setDepthPercents(150);

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

调整 3D 图表的高度比例

使用 IRotation3D.setHeightPercents 可以将 3D 图表的高度设置为其宽度的百分比。这会在不调整幻灯片上图表对象大小的情况下改变 3D 场景的比例。

下面的示例创建一个带有默认数据(3 个系列和 4 个类别)的 Column3D 图表。它保存了三个演示文稿,分别使用 50%、100% 和 200% 的高度比例。图表的位置、宽度和高度保持不变。所有三个文件中的数据、旋转、深度、系列间距和格式均相同;唯一变化的是高度百分比。

import com.aspose.slides.*;

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

    IChart chart = slide.getShapes().addChart(ChartType.Column3D, 40, 30, 620, 460);
    chart.getRotation3D().setRotationX((byte) 20);
    chart.getRotation3D().setRotationY(30);
    chart.getRotation3D().setRightAngleAxes(true);
    chart.getRotation3D().setDepthPercents(100);
    chart.getChartData().getSeries().get_Item(0).getParentSeriesGroup().setGapDepth(150);

    for (int heightPercent : new int[] { 50, 100, 200 }) {
        chart.getRotation3D().setHeightPercents(heightPercent);
        presentation.save("chart_height_" + heightPercent + ".pptx", SaveFormat.Pptx);
    }
} finally {
    presentation.dispose();
}

下图展示了在对应的 .NET 示例中相同的高度设置,并使用 Microsoft PowerPoint 导出。较小的百分比会产生更平坦的场景,而较大的百分比会在相同的图表对象内产生更高的场景。PowerPoint 还可能调整坐标轴刻度间隔和标签位置以适应场景。

高度:50% 高度:100% 高度:200%
高度设为其宽度 50% 的 3D 柱形图 高度设为其宽度 100% 的 3D 柱形图 高度设为其宽度 200% 的 3D 柱形图

这些方法控制图表的不同方面:

方法 效果
IRotation3D.setHeightPercents 以宽度的百分比设置 3D 场景的高度。
IChart.setHeight 幻灯片上图表对象的高度(单位:点)。
IRotation3D.setDepthPercents 以宽度的百分比设置 3D 场景的深度。
IChartSeriesGroup.setGapDepth 沿深度轴的系列间距,以标记宽度的百分比表示。

高度设置会影响 3D 柱形图和条形图,包括圆柱体、圆锥体和金字塔变体,以及 3D 折线图、面积图、饼图和曲面图。上面的比较使用了已验证的 Column3D 类型。此设置不会更改 2D ClusteredColumn 图表或 BubbleWith3D 图表的外观;这些名称是 ChartType 类的成员。有关其他图表外观设置,请参阅 Chart Formatting。

调整系列之间的间隙

使用 IChartSeriesGroup.setGapDepth 可控制 3D 图表中数据系列沿深度轴的距离,以标记宽度的百分比表示。取值范围为 0 到 500(含),0 表示取消间隙,较大的值会增加间距。在固定的图表深度下,增大间隙会使标记在深度轴上更细。

通过 IChartSeries.getParentSeriesGroup 访问该组。此设置适用于该组中的所有系列,而不仅是用于访问的系列。IChartSeries.getGapDepth 返回深度间隙并反映父组的设置。

此设置会影响 3D 柱形图和条形图,包括其圆柱体、圆锥体和金字塔变体,以及 3D 折线图和面积图。外观取决于系列是按深度、聚类还是堆叠排列。要清晰比较不同系列之间的间隙,请使用 ChartType.Column3D(来自 ChartType 类)。

这些方法控制图表的不同方面:

方法 效果
IChartSeriesGroup.setGapDepth 沿深度轴的系列间距,以标记宽度的百分比表示。
IChartSeriesGroup.setGapWidth 相邻条形或柱形簇之间的间距,以条形或柱形宽度的百分比表示。
setDepthPercents 整体图表深度,以图表宽度的百分比表示。

以下独立示例使用默认的图表数据(包含三个系列和四个类别)。它保存了两个演示文稿,数据、旋转、间隙宽度和图表深度均相同,唯一变化的是间隙深度。

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    
    IChart chart = slide.getShapes().addChart(ChartType.Column3D, 40, 30, 620, 230);

    chart.getRotation3D().setRotationX((byte) 20);
    chart.getRotation3D().setRotationY(30);
    chart.getRotation3D().setDepthPercents(100);

    IChartSeries series = chart.getChartData().getSeries().get_Item(0);
    IChartSeriesGroup group = series.getParentSeriesGroup();
    group.setGapWidth(150);

    for (int gapDepth : new int[] { 0, 500 }) {
        group.setGapDepth(gapDepth);

        String fileName = "series_gap_depth_" + gapDepth + ".pptx";
        presentation.save(fileName, SaveFormat.Pptx);
    }
} finally {
    presentation.dispose();
}

下图展示了在对应的 .NET 示例中相同的间隙深度设置,并使用 Microsoft PowerPoint 导出。

间隙深度:0% 间隙深度:500%
沿深度轴系列之间没有间隙的 3D 柱形图 沿深度轴系列之间间隙为 500% 的 3D 柱形图

更改 3D 系列类型和条形形状

在聚类圆柱体图表中,第一系列的条形形状默认是圆柱体。示例在每次更改前后打印 IChartSeries.getType 和 IChartSeries.getBar3DShape 返回的整数值。下表给出了相应的常量名称。

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    
    IChart chart = slide.getShapes().addChart(ChartType.ClusteredCylinder, 20, 20, 500, 300);
    IChartSeries series = chart.getChartData().getSeries().get_Item(0);

    System.out.println(series.getType() + " | " + series.getBar3DShape());

    series.setType(ChartType.ClusteredCone);
    System.out.println(series.getType() + " | " + series.getBar3DShape());

    series.setBar3DShape(ChartShapeType.Box);
    System.out.println(series.getType() + " | " + series.getBar3DShape());

    presentation.save("series_shape.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}
对第一系列的更改 系列类型 条形形状
创建图表 ClusteredCylinder Cylinder
将系列类型设置为 ClusteredCone ClusteredCone Cone
将条形形状设置为 Box ClusteredColumn3D Box

将形状设置为 Box 也会将系列类型更改为 ClusteredColumn3D。如果您的代码根据系列类型分支,请在更改形状后调用 series.getType()。在赋值前缓存的值仍会选择 ClusteredCone 分支。

PowerPoint comparison showing the first series as cylinders, cones, and rectangular columns from left to right

常见问题

Aspose.Slides 支持哪些图表类型的 3D 模式?

Aspose.Slides 支持柱形图的 3D 变体,包括 Column 3D、Clustered Column 3D、Stacked Column 3D 和 100% Stacked Column 3D,以及通过 ChartType 类公开的相关 3D 类型。要获取完整、最新的列表,请查看已安装版本 API 参考中的 ChartType 成员。

我可以获取 3D 图表的栅格图像用于报告或网页吗?

是的。您可以使用 Shape.getImage 将图表导出为图像,或使用 渲染整个幻灯片 将整个幻灯片渲染为 PNG 或 JPEG 等格式。当您需要栅格预览或想在文档、仪表盘或网页中嵌入图表而无需 PowerPoint 时,这非常有用。

构建和渲染大型 3D 图表的性能如何?

性能取决于数据量和视觉复杂度。为获得最佳效果,请尽量保持 3D 效果最小化,避免在墙面和绘图区域使用大量纹理,尽可能限制每个系列的数据点数量,并将渲染输出设置为适当的分辨率和尺寸,以匹配目标显示或打印需求。