Dostosowywanie wykresów 3D w prezentacjach przy użyciu Javy
Przegląd
Aspose.Slides for Java pozwala dostosować widok wykresu 3D za pomocą metody IChart.getRotation3D . Ten artykuł pokazuje, jak dostosować obrót, proporcje wysokości, głębokość, osie pod kątem prostym oraz odstępy między seriami, a następnie zapisać prezentację w formacie PPTX.
Ustawienie obrotu i głębokości wykresu 3D
Poniższy przykład tworzy obiekt Presentation i używa metody IShapeCollection.addChart do dodania wykresu słupkowego 3D skumulowanego na pierwszym slajdzie. Zastępuje domyślne serie i kategorie dwoma seriami, z których każda zawiera po trzy wartości. Indeks arkusza kalkulacyjnego 0 identyfikuje pierwszy arkusz danych wykresu; wiersz 0 zawiera nazwy serii, a kolumna 0 – etykiety kategorii.
Metody setRotationX i setRotationY ustawiają obrót wykresu na 40 i 270 stopni. setDepthPercents ustawia jego głębokość na 150 % szerokości, natomiast setRightAngleAxes włącza osie pod kątem prostym zamiast perspektywy. Powstała prezentacja zawiera wykres z tymi ustawieniami widoku 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();
}
Dostosowanie proporcji wysokości wykresu 3D
Użyj IRotation3D.setHeightPercents aby ustawić wysokość wykresu 3D jako procent jego szerokości. Zmienia to proporcje sceny 3D bez zmiany rozmiaru obiektu wykresu na slajdzie.
Poniższy przykład tworzy wykres Column3D z domyślnymi danymi: trzy serie i cztery kategorie. Zapisuje trzy prezentacje z proporcjami wysokości 50 %, 100 % i 200 %. Pozycja, szerokość i wysokość wykresu pozostają niezmienione. Dane, obrót, głębokość, odstępy serii i formatowanie są identyczne w trzech plikach; zmienia się tylko procent wysokości.
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();
}
Poniższe obrazy ilustrują te same ustawienia wysokości w odpowiednim przykładzie .NET i zostały wyeksportowane przy użyciu Microsoft PowerPoint. Mniejszy procent tworzy płaską scenę, większy – wyższą scenę w obrębie tego samego obiektu wykresu. PowerPoint może również dostosować przedziały oznaczeń osi i położenie etykiet, aby dopasować scenę.
| Wysokość: 50% | Wysokość: 100% | Wysokość: 200% |
|---|---|---|
![]() |
![]() |
![]() |
Te metody kontrolują różne aspekty wykresu:
| Metoda | Efekt |
|---|---|
| IRotation3D.setHeightPercents | Wysokość sceny 3D jako procent jej szerokości. |
| IChart.setHeight | Wysokość obiektu wykresu na slajdzie, w punktach. |
| IRotation3D.setDepthPercents | Głębokość sceny 3D jako procent jej szerokości. |
| IChartSeriesGroup.setGapDepth | Odstęp między seriami wzdłuż osi głębokości, jako procent szerokości znacznika. |
Ustawienie wysokości wpływa na wykresy kolumnowe i słupkowe 3D, w tym warianty cylindryczne, stożkowe i piramidalne, a także wykresy liniowe, powierzchniowe, kołowe i powierzchniowe 3D. Porównanie powyżej używa zweryfikowanego typu Column3D. Ustawienie nie zmienia wyglądu wykresu 2D ClusteredColumn ani wykresu BubbleWith3D; nazwy te są członkami klasy ChartType. Inne ustawienia wyglądu wykresu znajdziesz w sekcji Chart Formatting.
Dostosowanie odstępu między seriami
Użyj IChartSeriesGroup.setGapDepth aby kontrolować odległość między seriami danych wzdłuż osi głębokości wykresu 3D, wyrażoną jako procent szerokości znacznika. Dozwolone wartości to 0 do 500, włącznie: 0 usuwa odstęp, wyższe wartości zwiększają przerwę. Przy stałej głębokości wykresu zwiększanie odstępu powoduje, że znaczniki są cieńsze wzdłuż osi głębokości.
Dostęp do grupy uzyskuje się poprzez IChartSeries.getParentSeriesGroup. Ustawienie ma zastosowanie do każdej serii w tej grupie, a nie tylko do serii użytej do uzyskania grupy. IChartSeries.getGapDepth zwraca aktualny odstęp głębokości i odzwierciedla ustawienie grupy nadrzędnej.
Ustawienie to wpływa na wykresy słupkowe i kolumnowe 3D, w tym ich warianty cylindryczne, stożkowe i piramidalne, a także wykresy liniowe i powierzchniowe 3D. Wygląd zależy od tego, czy serie są rozmieszczone w głębokości, grupowane czy skumulowane. Aby jasno porównać odstępy między oddzielnymi seriami, użyj ChartType.Column3D z klasy ChartType.
Te metody kontrolują różne aspekty wykresu:
| Metoda | Efekt |
|---|---|
| IChartSeriesGroup.setGapDepth | Odstęp między seriami wzdłuż osi głębokości, jako procent szerokości znacznika. |
| IChartSeriesGroup.setGapWidth | Odstęp między sąsiadującymi grupami słupków lub kolumn, jako procent szerokości słupka lub kolumny. |
| setDepthPercents | Ogólna głębokość wykresu, jako procent szerokości wykresu. |
Poniższy, samodzielny przykład wykorzystuje domyślne dane wykresu, które zawierają trzy serie i cztery kategorie. Zapisuje dwie prezentacje z identycznymi danymi, obrotem, szerokością odstępu i głębokością wykresu; zmienia się jedynie głębokość odstępu.
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();
}
Poniższe obrazy ilustrują te same ustawienia głębokości odstępu w odpowiednim przykładzie .NET i zostały wyeksportowane przy użyciu Microsoft PowerPoint.
| Odstęp głębokości: 0% | Odstęp głębokości: 500% |
|---|---|
![]() |
![]() |
Zmiana typu serii 3D i kształtu słupka
W wykresie grupowanym cylindrycznym pierwsza seria zaczyna się od cylindrycznego kształtu słupka. Przykład wypisuje wartości całkowite zwracane przez IChartSeries.getType i IChartSeries.getBar3DShape przed i po każdej zmianie. Tabela podaje odpowiadające nazwy stałych.
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();
}
| Zmiana pierwszej serii | Typ serii | Kształt słupka |
|---|---|---|
| Utwórz wykres | ClusteredCylinder |
Cylinder |
Ustaw typ serii na ClusteredCone |
ClusteredCone |
Cone |
Ustaw kształt słupka na Box |
ClusteredColumn3D |
Box |
Ustawienie kształtu na Box zmienia również typ serii na ClusteredColumn3D. Jeśli Twój kod rozgałęzia się w zależności od typu serii, wywołaj series.getType() po zmianie kształtu. Wartość zbuforowana przed przypisaniem nadal wybierze gałąź ClusteredCone.

FAQ
Jakie typy wykresów obsługują tryb 3D w Aspose.Slides?
Aspose.Slides obsługuje warianty 3D wykresów kolumnowych, w tym Column 3D, Clustered Column 3D, Stacked Column 3D i 100 % Stacked Column 3D, oraz powiązane typy 3D dostępne poprzez klasę ChartType. Aby uzyskać dokładną, aktualną listę, sprawdź członków ChartType w dokumentacji API swojej zainstalowanej wersji.
Czy mogę uzyskać rastrowy obraz wykresu 3D do raportu lub sieci?
Tak. Możesz wyeksportować wykres do obrazu przy użyciu Shape.getImage lub renderować cały slajd do formatów takich jak PNG czy JPEG. Jest to przydatne, gdy potrzebny jest podgląd rastrowy lub chcesz osadzić wykres w dokumentach, pulpitach nawigacyjnych lub stronach internetowych bez wymogu PowerPoint.
Jak wydajne jest budowanie i renderowanie dużych wykresów 3D?
Wydajność zależy od ilości danych i złożoności wizualnej. Aby uzyskać najlepsze rezultaty, ogranicz efekty 3D do niezbędnego minimum, unikaj ciężkich tekstur na ścianach i obszarach wykresu, ogranicz liczbę punktów danych na serię, gdy to możliwe, oraz renderuj do odpowiednio dużego rozmiaru wyjściowego (rozdzielczość i wymiary), dostosowanego do docelowego wyświetlacza lub wymagań druku.




