Κύριο API του Aspose.Slides FOSS για Java

Εισαγωγή

Το Aspose.Slides FOSS for Java είναι μια δωρεάν, ανοιχτού κώδικα βιβλιοθήκη που επιτρέπει στους προγραμματιστές Java να δημιουργούν και να επεξεργάζονται παρουσιάσεις PowerPoint χωρίς καμία εξάρτηση από το Microsoft Office. Η βιβλιοθήκη διανέμεται στο πακέτο org.aspose.slides.foss και στοχεύει σε Java 21 και άνω.

Το έργο κυκλοφορεί υπό την άδεια MIT, ώστε να μπορείτε να το χρησιμοποιείτε τόσο σε προσωπικά όσο και σε εμπορικά έργα χωρίς κόστος και χωρίς κλειδί API. Παρέχει ένα πλούσιο μοντέλο αντικειμένων για διαφάνειες, σχήματα, κείμενο, πίνακες, εικόνες, σχόλια και ιδιότητες εγγράφου, υποστηριζόμενο από άμεση διαχείριση του Office Open XML package format.

Με 273 κλάσεις, πάνω από 2.600 μεθόδους και 42 απαριθμήσεις, το βασικό API καλύπτει τα δομικά στοιχεία που χρειάζεστε για να αυτοματοποιήσετε τις ροές εργασίας παρουσίασης σε οποιαδήποτε εφαρμογή Java.

Τι περιλαμβάνεται

Κύκλος ζωής παρουσίασης

Η κλάση Presentation είναι το σημείο εισόδου για κάθε λειτουργία. Μπορείτε να δημιουργήσετε μια κενή παρουσίαση και να αποθηκεύσετε το αποτέλεσμα στον δίσκο ή σε ένα OutputStream σε διάφορες μορφές. Η κλάση υλοποιεί AutoCloseable, έτσι λειτουργεί φυσικά με μπλοκ try-with-resources.

import org.aspose.slides.foss.*;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation pres = new Presentation()) {
    // A new presentation starts with one blank slide
    System.out.println("Slides: " + pres.getSlides().size());
    pres.save("output.pptx", SaveFormat.PPTX);
}

Διαχείριση Διαφανειών

SlideCollection παρέχει πλήρη έλεγχο του συνόλου διαφανειών. Μπορείτε να προσθέσετε κενές διαφάνειες με addEmptySlide(), να διπλασιάσετε υπάρχουσες διαφάνειες με addClone(), να εισάγετε διαφάνειες σε συγκεκριμένο δείκτη με insertEmptySlide(), να αφαιρέσετε διαφάνειες με αναφορά ή δείκτη, και να επαναλάβετε τη συλλογή.

try (Presentation pres = new Presentation()) {
    ILayoutSlide layout = pres.getLayoutSlides().get(0);
    pres.getSlides().addEmptySlide(layout);
    pres.getSlides().addClone(pres.getSlides().get(0));
    System.out.println("Total slides: " + pres.getSlides().size());
}

Σχήματα και Αυτόματα Σχήματα

Η κλάση AutoShape αντιπροσωπεύει το πιο κοινό αντικείμενο που μπορεί να σχεδιαστεί σε μια διαφάνεια. Δημιουργείτε σχήματα μέσω του IShapeCollection.addAutoShape(), καθορίζοντας μια σταθερά ShapeType (όπως η ShapeType.RECTANGLE) και συντεταγμένες θέσης. Κάθε AutoShape εκθέτει ένα TextFrame για το κείμενο και ένα FillFormat για το οπτικό στυλ.

try (Presentation pres = new Presentation()) {
    ISlide slide = pres.getSlides().get(0);
    IAutoShape shape = slide.getShapes().addAutoShape(
        ShapeType.RECTANGLE, 50, 50, 300, 100, false);
    ITextFrame tf = shape.addTextFrame("Hello from Aspose.Slides FOSS");
    System.out.println(tf.getText());
}

Κείμενο και Παράγραφοι

Το πλούσιο κείμενο μοντελοποιείται ως ιεραρχία των αντικειμένων TextFrame, ParagraphCollection, Paragraph, PortionCollection και Portion. Μπορείτε να ορίσετε απλό κείμενο σε ένα πλαίσιο απευθείας με TextFrame.setText(), ή να δημιουργήσετε παραγράφους πολλαπλών εκτελέσεων προσθέτοντας μεμονωμένα αντικείμενα Portion με διαφορετική μορφοποίηση.

try (Presentation pres = new Presentation()) {
    ISlide slide = pres.getSlides().get(0);
    IAutoShape shape = slide.getShapes()
        .addAutoShape(ShapeType.RECTANGLE, 50, 50, 400, 100, false);
    ITextFrame tf = shape.addTextFrame("First run ");
    Portion extra = new Portion("second run");
    tf.getParagraphs().get(0).getPortions().add(extra);
    System.out.println(tf.getText());
}

Ιδιότητες εγγράφου

Η κλάση DocumentProperties εκθέτει τυπικά πεδία μεταδεδομένων όπως τίτλος, συγγραφέας, θέμα, λέξεις‑κλειδιά, κατηγορία και χρονικές σφραγίδες. Οι Ιδιότητες αποθηκεύονται στα τμήματα πυρήνα και επεκταμένων ιδιοτήτων του PPTX και διατηρούνται κατά τις κύκλους αποθήκευσης/φόρτωσης.

try (Presentation pres = new Presentation()) {
    IDocumentProperties props = pres.getDocumentProperties();
    props.setTitle("Quarterly Report");
    props.setAuthor("Engineering Team");
    pres.save("report.pptx", SaveFormat.PPTX);
}

Σχόλια και Σημειώσεις

Το υποσύστημα σχολίων περιλαμβάνει CommentAuthorCollection και CommentCollection. Μπορείτε να προσθέσετε συγγραφείς, να συνημψετε σχόλια σε συγκεκριμένες διαφάνειες και θέσεις, και να διαβάσετε ξανά υπάρχουσες σημειώσεις. Τα δεδομένα σχολίων αποθηκεύονται στα τμήματα ppt/commentAuthors.xml και ppt/comments/*.xml του πακέτου PPTX.

Γρήγορη εκκίνηση

Προσθέστε την εξάρτηση Maven στο pom.xml σας:

<dependency>
  <groupId>org.aspose.slides.foss</groupId>
  <artifactId>aspose-slides-foss</artifactId>
  <version>1.0.0</version>
</dependency>

Στη συνέχεια δημιουργήστε και αποθηκεύστε μια παρουσίαση:

import org.aspose.slides.foss.*;
import org.aspose.slides.foss.export.SaveFormat;

public class QuickStart {
    public static void main(String[] args) {
        try (Presentation pres = new Presentation()) {
            ISlide slide = pres.getSlides().get(0);

            // Add a title shape
            IAutoShape title = slide.getShapes().addAutoShape(
                ShapeType.RECTANGLE, 50, 30, 600, 60, false);
            title.addTextFrame("Aspose.Slides FOSS for Java");

            // Add a content shape
            IAutoShape body = slide.getShapes().addAutoShape(
                ShapeType.RECTANGLE, 50, 120, 600, 300, false);
            body.addTextFrame(
                "This presentation was created entirely in Java "
                + "using a free, open-source library.");

            pres.save("quick-start.pptx", SaveFormat.PPTX);
        }
    }
}

Υποστηριζόμενες μορφές

Η απαρίθμηση SaveFormat ορίζει κάθε μορφή εξόδου που μπορεί να γράψει η βιβλιοθήκη. Ο παρακάτω πίνακας παραθέτει τις επιβεβαιωμένες καταχωρίσεις.

Οι μορφές που αναφέρονται παραπάνω είναι επιβεβαιωμένοι προορισμοί εξαγωγής που ορίζονται στην SaveFormat enum.

Ανοιχτού Κώδικα & Άδειες

Το Aspose.Slides FOSS for Java διανέμεται υπό την άδεια MIT. Ο πλήρης κώδικας πηγής είναι διαθέσιμος στο GitHub στη διεύθυνση Aspose.Slides-FOSS-for-Java. Είστε ελεύθεροι να χρησιμοποιήσετε, να τροποποιήσετε και να αναδιανείμετε τη βιβλιοθήκη σε οποιοδήποτε έργο χωρίς δικαιώματα ή κλειδιά άδειας.

Ξεκινώντας

Έτοιμοι να βουτήξετε πιο βαθιά; Εδώ είναι πόροι που θα σας βοηθήσουν να ξεκινήσετε:

• Developer Guide – οδηγούς και εκπαιδευτικά προγράμματα για κάθε περιοχή λειτουργίας
• Knowledge Base – άρθρα οδηγιών και συχνές ερωτήσεις
• API Reference – πλήρης τεκμηρίωση κλάσεων και μεθόδων