Sesuaikan Diagram 3D dalam Presentasi di Android
Gambaran Umum
Aspose.Slides for Android via Java memungkinkan Anda menyesuaikan tampilan diagram 3D melalui metode IChart.getRotation3D. Artikel ini menunjukkan cara menyesuaikan rotasi, proporsi tinggi, kedalaman, sumbu sudut kanan, dan jarak antar seri, kemudian menyimpan presentasi dalam format PPTX.
Atur Rotasi dan Kedalaman Diagram 3D
Contoh di bawah ini membuat sebuah Presentation dan menggunakan IShapeCollection.addChart untuk menambahkan diagram kolom 3D bertumpuk ke slide pertama. Ini menggantikan seri dan kategori default dengan dua seri yang masing‑masing berisi tiga nilai. Indeks lembar kerja 0 mengidentifikasi lembar data pertama diagram; baris 0 berisi nama seri, dan kolom 0 berisi label kategori.
Metode setRotationX dan setRotationY mengatur rotasi diagram menjadi 40 dan 270 derajat, masing‑masing. setDepthPercents mengatur kedalamannya menjadi 150 % dari lebar, sedangkan setRightAngleAxes mengaktifkan sumbu sudut kanan alih‑alih perspektif. Presentasi yang dihasilkan berisi diagram yang telah diisi dengan pengaturan tampilan 3D ini.
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();
}
Sesuaikan Proporsi Tinggi Diagram 3D
Gunakan IRotation3D.setHeightPercents untuk mengatur tinggi diagram 3D sebagai persentase dari lebarnya. Ini mengubah proporsi adegan 3D tanpa mengubah ukuran objek diagram pada slide.
Contoh berikut membuat diagram Column3D dengan data default: tiga seri dan empat kategori. Ia menyimpan tiga presentasi dengan proporsi tinggi 50 %, 100 %, dan 200 %. Posisi, lebar, dan tinggi diagram tetap tetap. Data, rotasi, kedalaman, jarak antar seri, dan format identik dalam ketiga file; hanya persentase tinggi yang berubah.
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();
}
Gambar berikut mengilustrasikan pengaturan tinggi yang sama dalam contoh .NET yang setara dan diekspor menggunakan Microsoft PowerPoint. Persentase yang lebih kecil menghasilkan adegan yang lebih datar, sementara persentase yang lebih besar menghasilkan adegan yang lebih tinggi dalam objek diagram yang sama. PowerPoint juga dapat menyesuaikan interval tanda sumbu dan penempatan label agar sesuai dengan adegan.
| Tinggi: 50% | Tinggi: 100% | Tinggi: 200% |
|---|---|---|
![]() |
![]() |
![]() |
Metode-metode ini mengontrol aspek berbeda dari diagram:
| Metode | Efek |
|---|---|
| IRotation3D.setHeightPercents | Tinggi adegan 3D sebagai persentase dari lebarnya. |
| IChart.setHeight | Tinggi objek diagram pada slide, dalam poin. |
| IRotation3D.setDepthPercents | Kedalaman adegan 3D sebagai persentase dari lebarnya. |
| IChartSeriesGroup.setGapDepth | Jarak antar seri sepanjang sumbu kedalaman, sebagai persentase lebar penanda. |
Pengaturan tinggi memengaruhi diagram kolom dan batang 3D, termasuk varian silinder, kerucut, dan piramida, serta diagram garis, area, pai, dan permukaan 3D. Perbandingan di atas menggunakan tipe Column3D yang terverifikasi. Pengaturan ini tidak mengubah tampilan diagram 2D ClusteredColumn atau diagram BubbleWith3D; nama‑nama tersebut merupakan anggota kelas ChartType. Untuk pengaturan tampilan diagram lainnya, lihat Chart Formatting.
Sesuaikan Celah Antar Seri
Gunakan IChartSeriesGroup.setGapDepth untuk mengontrol jarak antara seri data sepanjang sumbu kedalaman diagram 3D, yang dinyatakan sebagai persentase lebar penanda. Gunakan nilai dari 0 hingga 500, termasuk: 0 menghilangkan celah, sementara nilai yang lebih besar meningkatkan jarak. Dengan kedalaman diagram yang tetap, meningkatkan celah membuat penanda menjadi lebih tipis sepanjang sumbu kedalaman.
Akses grup melalui IChartSeries.getParentSeriesGroup. Pengaturan ini berlaku untuk setiap seri dalam grup tersebut, bukan hanya seri yang digunakan untuk mengaksesnya. IChartSeries.getGapDepth mengembalikan celah kedalaman dan mencerminkan pengaturan grup induk.
Pengaturan ini memengaruhi diagram kolom dan batang 3D, termasuk varian silinder, kerucut, dan piramida, serta diagram garis dan area 3D. Penampilan bergantung pada apakah seri diatur dalam kedalaman, berkelompok, atau bertumpuk. Untuk perbandingan jelas tentang celah antar seri terpisah, gunakan ChartType.Column3D dari kelas ChartType.
Metode-metode ini mengontrol aspek berbeda dari diagram:
| Metode | Efek |
|---|---|
| IChartSeriesGroup.setGapDepth | Jarak antar seri sepanjang sumbu kedalaman, sebagai persentase lebar penanda. |
| IChartSeriesGroup.setGapWidth | Jarak antar kelompok batang atau kolom yang berdekatan, sebagai persentase lebar batang atau kolom. |
| setDepthPercents | Kedalaman total diagram, sebagai persentase lebar diagram. |
Contoh mandiri berikut menggunakan data diagram default, yang berisi tiga seri dan empat kategori. Ia menyimpan dua presentasi dengan data, rotasi, lebar celah, dan kedalaman diagram yang identik; hanya celah kedalaman yang berubah.
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();
}
Gambar berikut mengilustrasikan pengaturan celah kedalaman yang sama dalam contoh .NET yang setara dan diekspor menggunakan Microsoft PowerPoint.
| Celah kedalaman: 0% | Celah kedalaman: 500% |
|---|---|
![]() |
![]() |
Ubah Tipe Seri 3D dan Bentuk Batang
Dalam diagram silinder berkelompok, seri pertama dimulai dengan bentuk batang silinder. Contoh mencetak nilai integer yang dikembalikan oleh IChartSeries.getType dan IChartSeries.getBar3DShape sebelum dan sesudah setiap perubahan. Tabel memberikan nama konstanta yang bersesuaian.
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();
}
| Perubahan pada seri pertama | Tipe seri | Bentuk batang |
|---|---|---|
| Buat diagram | ClusteredCylinder |
Cylinder |
Atur tipe seri ke ClusteredCone |
ClusteredCone |
Cone |
Atur bentuk batang ke Box |
ClusteredColumn3D |
Box |
Mengatur bentuk ke Box juga mengubah tipe seri menjadi ClusteredColumn3D. Jika kode Anda membuat percabangan berdasarkan tipe seri, panggil series.getType() setelah mengubah bentuk. Nilai yang disimpan sebelumnya sebelum penugasan masih akan memilih cabang ClusteredCone.

FAQ
Jenis diagram apa yang mendukung mode 3D di Aspose.Slides?
Aspose.Slides mendukung varian 3D dari diagram kolom, termasuk Column 3D, Clustered Column 3D, Stacked Column 3D, dan 100 % Stacked Column 3D, serta tipe 3D terkait yang diekspos melalui kelas ChartType. Untuk daftar yang tepat dan terbaru, periksa anggota ChartType dalam referensi API versi yang Anda instal.
Apakah saya dapat memperoleh gambar raster dari diagram 3D untuk laporan atau web?
Ya. Anda dapat mengekspor diagram ke gambar dengan Shape.getImage atau render seluruh slide ke format seperti PNG atau JPEG. Ini berguna ketika Anda membutuhkan pratinjau raster atau ingin menyematkan diagram ke dalam dokumen, dasbor, atau halaman web tanpa memerlukan PowerPoint.
Seberapa baik kinerja pembangunan dan rendering diagram 3D yang besar?
Kinerja tergantung pada volume data dan kompleksitas visual. Untuk hasil terbaik, minimalkan efek 3D, hindari tekstur berat pada dinding dan area plot, batasi jumlah titik data per seri bila memungkinkan, dan render ke output dengan ukuran (resolusi dan dimensi) yang sesuai untuk mencocokkan kebutuhan tampilan atau pencetakan target.




