Personnaliser les graphiques 3D dans les présentations sur Android

Aperçu

Aspose.Slides for Android via Java vous permet de personnaliser la vue d’un graphique 3D via la méthode IChart.getRotation3D. Cet article montre comment ajuster la rotation, les proportions de hauteur, la profondeur, les axes à angle droit et l’espacement entre les séries, puis enregistrer la présentation au format PPTX.

Définir la rotation et la profondeur d’un graphique 3D

L’exemple ci‑dessous crée une Presentation et utilise IShapeCollection.addChart pour ajouter un graphique en colonnes 3D empilé à la première diapositive. Il remplace les séries et catégories par défaut par deux séries contenant trois valeurs chacune. L’index de feuille de calcul 0 identifie la première feuille de données du graphique ; la ligne 0 contient les noms des séries, et la colonne 0 contient les libellés des catégories.

Les méthodes setRotationX et setRotationY définissent la rotation du graphique à 40 et 270 degrés respectivement. setDepthPercents fixe sa profondeur à 150 % de sa largeur, tandis que setRightAngleAxes active les axes à angle droit au lieu de la perspective. La présentation résultante contient le graphique renseigné avec ces paramètres de vue 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();
}

Ajuster les proportions de hauteur d’un graphique 3D

Utilisez IRotation3D.setHeightPercents pour définir la hauteur d’un graphique 3D en pourcentage de sa largeur. Cette opération modifie les proportions de la scène 3D sans redimensionner l’objet graphique sur la diapositive.

L’exemple suivant crée un graphique Column3D avec les données par défaut : trois séries et quatre catégories. Il enregistre trois présentations avec des proportions de hauteur de 50 %, 100 % et 200 %. La position, la largeur et la hauteur du graphique restent fixes. Les données, la rotation, la profondeur, l’espacement des séries et le formatage sont identiques dans les trois fichiers ; seul le pourcentage de hauteur varie.

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();
}

Les images suivantes illustrent les mêmes réglages de hauteur dans l’exemple .NET équivalent et ont été exportées avec Microsoft PowerPoint. Un pourcentage plus petit produit une scène plus plate, tandis qu’un pourcentage plus grand produit une scène plus haute dans le même objet graphique. PowerPoint peut également ajuster les intervalles des graduations des axes et le placement des libellés pour adapter la scène.

Hauteur : 50 % Hauteur : 100 % Hauteur : 200 %
Graphique 3D en colonne avec hauteur définie à 50 % de sa largeur Graphique 3D en colonne avec hauteur définie à 100 % de sa largeur Graphique 3D en colonne avec hauteur définie à 200 % de sa largeur

Ces méthodes contrôlent différents aspects du graphique :

Méthode Effet
IRotation3D.setHeightPercents Hauteur de la scène 3D en pourcentage de sa largeur.
IChart.setHeight Hauteur de l’objet graphique sur la diapositive, en points.
IRotation3D.setDepthPercents Profondeur de la scène 3D en pourcentage de sa largeur.
IChartSeriesGroup.setGapDepth Espacement entre les séries le long de l’axe de profondeur, en pourcentage de la largeur du marqueur.

Le réglage de la hauteur affecte les graphiques en colonnes et en barres 3D, y compris les variantes cylindre, cône et pyramide, ainsi que les graphiques 3D en lignes, aires, secteurs et surfaces. La comparaison ci‑dessus utilise le type vérifié Column3D. Le réglage ne modifie pas l’apparence d’un graphique 2D ClusteredColumn ou d’un graphique BubbleWith3D ; ces noms sont des membres de la classe ChartType. Pour d’autres paramètres d’apparence, consultez Chart Formatting.

Ajuster l’écart entre les séries

Utilisez IChartSeriesGroup.setGapDepth pour contrôler la distance entre les séries de données le long de l’axe de profondeur d’un graphique 3D, exprimée en pourcentage de la largeur du marqueur. Utilisez des valeurs de 0 à 500, incluses : 0 supprime l’écart, tandis que des valeurs plus élevées augmentent l’espacement. Avec une profondeur de graphique fixe, augmenter l’écart rend les marqueurs plus fins le long de l’axe de profondeur.

Accédez au groupe via IChartSeries.getParentSeriesGroup. Le réglage s’applique à toutes les séries du groupe, pas seulement à celle utilisée pour y accéder. IChartSeries.getGapDepth renvoie l’écart de profondeur et reflète le paramètre du groupe parent.

Ce réglage affecte les graphiques en colonnes et en barres 3D, y compris leurs variantes cylindre, cône et pyramide, ainsi que les graphiques 3D en lignes et aires. L’apparence dépend de la façon dont les séries sont disposées en profondeur, groupées ou empilées. Pour une comparaison claire des écarts entre séries séparées, utilisez ChartType.Column3D de la classe ChartType.

Ces méthodes contrôlent différents aspects du graphique :

Méthode Effet
IChartSeriesGroup.setGapDepth Espacement entre les séries le long de l’axe de profondeur, en pourcentage de la largeur du marqueur.
IChartSeriesGroup.setGapWidth Espacement entre les groupes de barres ou de colonnes adjacents, en pourcentage de la largeur de la barre ou de la colonne.
setDepthPercents Profondeur globale du graphique, en pourcentage de la largeur du graphique.

L’exemple autonome suivant utilise les données de graphique par défaut, qui contiennent trois séries et quatre catégories. Il enregistre deux présentations avec des données, une rotation, une largeur d’écart et une profondeur de graphique identiques ; seul l’écart de profondeur varie.

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();
}

Les images suivantes illustrent les mêmes réglages d’écart de profondeur dans l’exemple .NET équivalent et ont été exportées avec Microsoft PowerPoint.

Écart de profondeur : 0 % Écart de profondeur : 500 %
Graphique 3D en colonne sans écart entre les séries le long de l’axe de profondeur Graphique 3D en colonne avec un écart de 500 % entre les séries le long de l’axe de profondeur

Modifier le type de série 3D et la forme de barre

Dans un graphique à cylindres groupés, la première série commence avec une forme de barre cylindrique. L’exemple affiche les valeurs entières retournées par IChartSeries.getType et IChartSeries.getBar3DShape avant et après chaque modification. Le tableau fournit les noms de constantes correspondants.

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();
}
Modification de la première série Type de série Forme de barre
Créer le graphique ClusteredCylinder Cylinder
Définir le type de série à ClusteredCone ClusteredCone Cone
Définir la forme de barre à Box ClusteredColumn3D Box

Définir la forme à Box change également le type de série en ClusteredColumn3D. Si votre code effectue des bifurcations selon le type de série, appelez series.getType() après avoir modifié la forme. Une valeur mise en cache avant l’affectation sélectionnerait encore la branche ClusteredCone.

Comparaison PowerPoint montrant la première série en cylindres, cônes et colonnes rectangulaires de gauche à droite

FAQ

Quels types de graphiques prennent en charge le mode 3D dans Aspose.Slides ?

Aspose.Slides prend en charge les variantes 3D des graphiques à colonnes, notamment Column 3D, Clustered Column 3D, Stacked Column 3D et 100 % Stacked Column 3D, ainsi que les types 3D associés exposés via la classe ChartType. Pour une liste exacte et à jour, consultez les membres de ChartType dans la référence API de la version installée.

Puis-je obtenir une image raster d’un graphique 3D pour un rapport ou le web ?

Oui. Vous pouvez exporter un graphique sous forme d’image avec Shape.getImage ou rendre la diapositive complète vers des formats tels que PNG ou JPEG. Cela est utile lorsque vous avez besoin d’un aperçu raster ou que vous souhaitez intégrer le graphique dans des documents, tableaux de bord ou pages web sans nécessiter PowerPoint.

Quelle est la performance de la construction et du rendu de grands graphiques 3D ?

Les performances dépendent du volume de données et de la complexité visuelle. Pour de meilleurs résultats, limitez les effets 3D, évitez les textures lourdes sur les murs et les zones de tracé, réduisez le nombre de points de données par série lorsque cela est possible, et rendez à une résolution et des dimensions appropriées à l’affichage ou à l’impression cible.