Προσαρμογή 3D διαγραμμάτων σε παρουσιάσεις με Python

Επισκόπηση

Το Aspose.Slides for Python μέσω .NET σάς επιτρέπει να προσαρμόζετε την προβολή ενός 3D διαγράμματος μέσω της ιδιότητας Chart.rotation_3d . Αυτό το άρθρο δείχνει πώς να ρυθμίσετε την περιστροφή, τις αναλογίες ύψους, το βάθος, τους άξονες ορθογωνίου γωνίας και το διάστημα μεταξύ των σειρών, και στη συνέχεια να αποθηκεύσετε την παρουσίαση σε μορφή PPTX.

Ορίστε την Περιστροφή και το Βάθος ενός 3D Διαγράμματος

Το παρακάτω παράδειγμα δημιουργεί ένα Presentation και χρησιμοποιεί το ShapeCollection.add_chart για να προσθέσει ένα στοίβασμα 3D στήλης στο πρώτο του διαφάνεια. Αντικαθιστά τις προεπιλεγμένες σειρές και κατηγορίες με δύο σειρές που περιέχουν τρεις τιμές η κάθε μία. Ο δείκτης φύλλου εργασίας 0 προσδιορίζει το πρώτο φύλλο δεδομένων του διαγράμματος· η γραμμή 0 περιέχει τα ονόματα των σειρών και η στήλη 0 περιέχει τις ετικέτες των κατηγοριών.

Οι ιδιότητες rotation_x και rotation_y ορίζουν την περιστροφή του διαγράμματος στα 40 και 270 μοίρες, αντίστοιχα. Η ιδιότητα depth_percents ορίζει το βάθος του στο 150 % του πλάτους του, ενώ η right_angle_axes ενεργοποιεί άξονες ορθής γωνίας αντί για προοπτική. Η προκύπτουσα παρουσίαση περιέχει το γεμισμένο διάγραμμα με αυτές τις ρυθμίσεις προβολής 3D.

import aspose.slides as slides
import aspose.slides.charts as charts

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    chart = slide.shapes.add_chart(charts.ChartType.STACKED_COLUMN_3D, 0, 0, 500, 500)

    chart.chart_data.series.clear()
    chart.chart_data.categories.clear()

    workbook = chart.chart_data.chart_data_workbook
    worksheet_index = 0
    
    values = [[20, 50, 30], [30, 10, 60]]

    for category_index in range(3):
        category_cell = workbook.get_cell(worksheet_index, category_index + 1, 0, f"Category {category_index + 1}")
        chart.chart_data.categories.add(category_cell)

    for series_index in range(2):
        series_cell = workbook.get_cell(worksheet_index, 0, series_index + 1, f"Series {series_index + 1}")
        series = chart.chart_data.series.add(series_cell, chart.type)

        for category_index in range(3):
            value_cell = workbook.get_cell(worksheet_index, category_index + 1, series_index + 1, values[series_index][category_index])
            series.data_points.add_data_point_for_bar_series(value_cell)

    chart.rotation_3d.right_angle_axes = True
    chart.rotation_3d.rotation_x = 40
    chart.rotation_3d.rotation_y = 270
    chart.rotation_3d.depth_percents = 150

    presentation.save("Rotation3D_out.pptx", slides.export.SaveFormat.PPTX)

Ρυθμίστε τις Αναλογίες Ύψους ενός 3D Διαγράμματος

Χρησιμοποιήστε το Rotation3D.height_percents για να ορίσετε το ύψος ενός 3D διαγράμματος ως ποσοστό του πλάτους του. Αυτό αλλάζει τις αναλογίες της 3D σκηνής χωρίς να αλλάζει το μέγεθος του αντικειμένου διαγράμματος στη διαφάνεια.

Το παρακάτω παράδειγμα δημιουργεί ένα διάγραμμα COLUMN_3D με τα προεπιλεγμένα δεδομένα: τρεις σειρές και τέσσερις κατηγορίες. Αποθηκεύει τρεις παρουσιάσεις με αναλογίες ύψους 50 %, 100 % και 200 %. Η θέση, το πλάτος και το ύψος του διαγράμματος παραμένουν σταθερά. Τα δεδομένα, η περιστροφή, το βάθος, το διάστημα μεταξύ σειρών και η μορφοποίηση είναι τα ίδια και στα τρία αρχεία· μόνο το ποσοστό ύψους αλλάζει.

import aspose.slides as slides
import aspose.slides.charts as charts

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    chart = slide.shapes.add_chart(charts.ChartType.COLUMN_3D, 40, 30, 620, 460)
    chart.rotation_3d.rotation_x = 20
    chart.rotation_3d.rotation_y = 30
    chart.rotation_3d.right_angle_axes = True
    chart.rotation_3d.depth_percents = 100
    chart.chart_data.series[0].parent_series_group.gap_depth = 150

    for height_percent in (50, 100, 200):
        chart.rotation_3d.height_percents = height_percent
        presentation.save(f"chart_height_{height_percent}.pptx", slides.export.SaveFormat.PPTX)

Οι παρακάτω εικόνες εξήχθησαν από τις παραγόμενες παρουσιάσεις χρησιμοποιώντας το Microsoft PowerPoint. Ένα μικρότερο ποσοστό παράγει πιο επίπεδη σκηνή, ενώ ένα μεγαλύτερο ποσοστό δημιουργεί πιο ψηλή σκηνή εντός του ίδιου αντικειμένου διαγράμματος. Το PowerPoint μπορεί επίσης να προσαρμόσει τα διαστήματα των σημάνσεων των αξόνων και τη θέση των ετικετών για να ταιριάζει στη σκηνή.

Ύψος: 50% Ύψος: 100% Ύψος: 200%
Διάγραμμα 3D στήλης με ύψος ορισμένο στο 50 τοις εκατό του πλάτους του Διάγραμμα 3D στήλης με ύψος ορισμένο στο 100 τοις εκατό του πλάτους του Διάγραμμα 3D στήλης με ύψος ορισμένο στο 200 τοις εκατό του πλάτους του

Αυτές οι ιδιότητες ελέγχουν διαφορετικές πτυχές του διαγράμματος:

Ιδιότητα Αποτέλεσμα
Rotation3D.height_percents Ύψος της 3D σκηνής ως ποσοστό του πλάτους της.
Chart.height Ύψος του αντικειμένου διαγράμματος στη διαφάνεια, σε πόντους.
Rotation3D.depth_percents Βάθος της 3D σκηνής ως ποσοστό του πλάτους της.
ChartSeriesGroup.gap_depth Απόσταση μεταξύ σειρών κατά τον άξονα βάθους, ως ποσοστό του πλάτους του δείκτη.

Η ρύθμιση του ύψους επηρεάζει τα 3D διαγράμματα στήλης και ράβδου, συμπεριλαμβανομένων των κυλίνδρου, κώνου και πυραμίδας, καθώς και τα 3D διαγράμματα γραμμής, περιοχής, πίτας και επιφάνειας. Η παραπάνω σύγκριση χρησιμοποιεί τον επαληθευμένο τύπο COLUMN_3D. Η ρύθμιση δεν αλλάζει την εμφάνιση ενός 2D διαγράμματος CLUSTERED_COLUMN ή ενός διαγράμματος BUBBLE_WITH_3D; αυτά τα ονόματα είναι μέλη της απαρίθμησης ChartType. Για άλλες ρυθμίσεις εμφάνισης διαγράμματος, δείτε Chart Formatting.

Ρυθμίστε το Κενό Μεταξύ Σειρών

Χρησιμοποιήστε το ChartSeriesGroup.gap_depth για να ελέγξετε την απόσταση μεταξύ των σειρών δεδομένων κατά τον άξονα βάθους ενός 3D διαγράμματος, εκφρασμένη ως ποσοστό του πλάτους του δείκτη. Χρησιμοποιήστε τιμές από 0 έως 500, συμπεριλαμβανομένου: 0 αφαιρεί το κενό, ενώ μεγαλύτερες τιμές αυξάνουν το διάστημα. Με σταθερό βάθος διαγράμματος, η αύξηση του κενού κάνει τα δείκτες πιο λεπτά κατά τον άξονα βάθους.

Προσπελάστε την ομάδα μέσω του ChartSeries.parent_series_group. Η ρύθμιση εφαρμόζεται σε κάθε σειρά της ομάδας, όχι μόνο στη σειρά που χρησιμοποιείται για την πρόσβαση. Η ιδιότητα ChartSeries.gap_depth είναι μόνο για ανάγνωση και αντανακλά τη ρύθμιση της γονικής ομάδας.

Η ρύθμιση αυτή επηρεάζει τα 3D διαγράμματα στήλης και ράβδου, συμπεριλαμβανομένων των παραλλαγών κυλίνδρου, κώνου και πυραμίδας, καθώς και τα 3D διαγράμματα γραμμής και περιοχής. Η εμφάνιση εξαρτάται από το αν οι σειρές είναι διατεταγμένες σε βάθος, ομαδοποιημένες ή στοίβες. Για σαφή σύγκριση των κενών μεταξύ ξεχωριστών σειρών, χρησιμοποιήστε το ChartType.COLUMN_3D από την απαρίθμηση ChartType.

Αυτές οι ιδιότητες ελέγχουν διαφορετικές πτυχές του διαγράμματος:

Ιδιότητα Αποτέλεσμα
ChartSeriesGroup.gap_depth Απόσταση μεταξύ σειρών κατά τον άξονα βάθους, ως ποσοστό του πλάτους του δείκτη.
ChartSeriesGroup.gap_width Απόσταση μεταξύ γειτονικών ομάδων ραβδών ή στηλών, ως ποσοστό του πλάτους της ράβδου ή της στήλης.
Rotation3D.depth_percents Συνολικό βάθος διαγράμματος, ως ποσοστό του πλάτους του διαγράμματος.

Το παρακάτω αυτόνομο παράδειγμα χρησιμοποιεί τα προεπιλεγμένα δεδομένα διαγράμματος, που περιέχουν τρεις σειρές και τέσσερις κατηγορίες. Αποθηκεύει δύο παρουσιάσεις με ταυτόσημα δεδομένα, περιστροφή, πλάτος κενού και βάθος διαγράμματος· μόνο το βάθος του κενού αλλάζει.

import aspose.slides as slides
import aspose.slides.charts as charts

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    chart = slide.shapes.add_chart(charts.ChartType.COLUMN_3D, 40, 30, 620, 230)

    chart.rotation_3d.rotation_x = 20
    chart.rotation_3d.rotation_y = 30
    chart.rotation_3d.depth_percents = 100

    series = chart.chart_data.series[0]
    group = series.parent_series_group
    group.gap_width = 150

    for gap_depth in (0, 500):
        group.gap_depth = gap_depth
        file_name = f"series_gap_depth_{gap_depth}.pptx"
        presentation.save(file_name, slides.export.SaveFormat.PPTX)

Οι παρακάτω εικόνες εξήχθησαν από τις παραγόμενες παρουσιάσεις χρησιμοποιώντας το Microsoft PowerPoint.

Βάθος κενού: 0% Βάθος κενού: 500%
Διάγραμμα 3D στήλης χωρίς κενό μεταξύ σειρών κατά τον άξονα βάθους Διάγραμμα 3D στήλης με κενό 500 τοις εκατό μεταξύ σειρών κατά τον άξονα βάθους

Αλλάξτε τον 3D Τύπο Σειράς και το Σχήμα Ράβδου

Σε ένα ομαδοποιημένο διάγραμμα κυλίνδρου, η πρώτη σειρά ξεκινά με κυλινδρικές ράβδους. Το παράδειγμα διαβάζει τα ChartSeries.type και ChartSeries.bar_3d_shape πριν και μετά από κάθε αλλαγή.

import aspose.slides as slides
import aspose.slides.charts as charts

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    chart = slide.shapes.add_chart(charts.ChartType.CLUSTERED_CYLINDER, 20, 20, 500, 300)
    series = chart.chart_data.series[0]
    
    print(f"{series.type.name} | {series.bar_3d_shape.name}")

    series.type = charts.ChartType.CLUSTERED_CONE
    print(f"{series.type.name} | {series.bar_3d_shape.name}")

    series.bar_3d_shape = charts.ChartShapeType.BOX
    print(f"{series.type.name} | {series.bar_3d_shape.name}")

    presentation.save("series_shape.pptx", slides.export.SaveFormat.PPTX)
Αλλαγή στην πρώτη σειρά type bar_3d_shape
Create the chart CLUSTERED_CYLINDER CYLINDER
Set type to CLUSTERED_CONE CLUSTERED_CONE CONE
Set bar_3d_shape to BOX CLUSTERED_COLUMN_3D BOX

Ο ορισμός του σχήματος σε BOX αλλάζει επίσης τον τύπο σειράς σε CLUSTERED_COLUMN_3D. Εάν ο κώδικάς σας κάνει κλαδώσεις βάσει του τύπου σειράς, διαβάστε το series.type μετά την αλλαγή του σχήματος. Μια τιμή που έχει αποθηκευτεί πριν από την εκχώρηση θα συνέχιζε να επιλέγει το κλαδί CLUSTERED_CONE.

Σύγκριση PowerPoint που δείχνει την πρώτη σειρά ως κυλίνδρους, κώνοι και ορθογώνιες στήλες από αριστερά προς δεξιά

Συχνές Ερωτήσεις

Ποιοι τύποι διαγραμμάτων υποστηρίζουν τη λειτουργία 3D στο Aspose.Slides;

Το Aspose.Slides υποστηρίζει 3D παραλλαγές των διαγραμμάτων στήλης, συμπεριλαμβανομένων των Column 3D, Clustered Column 3D, Stacked Column 3D και 100 % Stacked Column 3D, καθώς και σχετικούς 3D τύπους που εκτίθενται μέσω της απαρίθμησης ChartType. Για μια ακριβή, ενημερωμένη λίστα, ελέγξτε τα μέλη του ChartType στην αναφορά API της εγκατεστημένης έκδοσής σας.

Μπορώ να λάβω μια ραστική εικόνα ενός 3D διαγράμματος για αναφορά ή τον ιστό;

Ναι. Μπορείτε να εξάγετε ένα διάγραμμα σε εικόνα με το Shape.get_image ή να αποδώσετε ολόκληρη τη διαφάνεια σε μορφές όπως PNG ή JPEG. Αυτό είναι χρήσιμο όταν χρειάζεστε μια ραστική προεπισκόπηση ή θέλετε να ενσωματώσετε το διάγραμμα σε έγγραφα, πίνακες ελέγχου ή ιστοσελίδες χωρίς να απαιτείται το PowerPoint.

Πόσο αποδοτική είναι η δημιουργία και η απόδοση μεγάλων 3D διαγραμμάτων;

Η απόδοση εξαρτάται από τον όγκο των δεδομένων και την οπτική πολυπλοκότητα. Για βέλτιστα αποτελέσματα, διατηρήστε τα εφέ 3D στο ελάχιστο, αποφύγετε βαριές υφές σε τοίχους και περιοχές γραφήματος, περιορίστε τον αριθμό των σημείων δεδομένων ανά σειρά όταν είναι δυνατόν, και αποδώστε σε κατάλληλο μέγεθος εξόδου (ανάλυση και διαστάσεις) ώστε να ταιριάζει με την επιδιωκόμενη οθόνη ή τις ανάγκες εκτύπωσης.