Ako začať s Aspose.Slides FOSS pre Java

Ako začať s Aspose.Slides FOSS pre Java

aspose-slides-foss pre Javu je bezplatná knižnica s licenciou MIT na vytváranie a úpravu súborov PowerPoint .pptx — nie je potrebný Microsoft Office, dostupná v Maven Central.

Krok za krokom sprievodca

Krok 1: Pridajte Maven závislosť

Pridajte závislosť do svojho pom.xml (vyžaduje sa Java 21 alebo novšia):

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

Overte, že balík sa správne vyrieši, zostavením projektu:

mvn dependency:resolve

Krok 2: Importovať požadované triedy

Importujte triedy, ktoré potrebujete na načítanie prezentácií a ukladanie:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.FillType;

Krok 3: Vytvoriť prezentáciu

Vytvorte Presentation bez argumentov, aby ste začali s jedným prázdnym snímkom. Vždy používajte
try-with-resources na zabezpečenie uvoľnenia interných zdrojov:

import org.aspose.slides.foss.Presentation;

try (Presentation prs = new Presentation()) {
    System.out.println("Slides: " + prs.getSlides().size());
    prs.save("new_presentation.pptx");
}

Krok 4: Pridať tvar s textom

Použite slide.getShapes().addAutoShape() na vloženie obdĺžnika, potom zavolajte addTextFrame()
na pridanie textového obsahu:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.IPortionFormat;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.NullableBool;

try (Presentation prs = new Presentation()) {
    ISlide slide = prs.getSlides().get(0);
    IAutoShape shape = slide.getShapes().addAutoShape(
        ShapeType.RECTANGLE, 50, 50, 400, 150
    );
    ITextFrame tf = shape.addTextFrame("Hello from Aspose.Slides FOSS!");
    IPortionFormat fmt = tf.getParagraphs().get(0).getPortions().get(0).getPortionFormat();
    fmt.setFontHeight(24);
    fmt.setFontBold(NullableBool.TRUE);
    prs.save("with_shape.pptx");
}

Krok 5: Použiť výplň a uložiť

Nastavte plnú farbu výplne na tvar pred uložením:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.FillType;
import org.aspose.slides.foss.drawing.Color;

try (Presentation prs = new Presentation()) {
    IAutoShape shape = prs.getSlides().get(0).getShapes().addAutoShape(
        ShapeType.RECTANGLE, 100, 100, 400, 200
    );
    shape.getFillFormat().setFillType(FillType.SOLID);
    shape.getFillFormat().getSolidFillColor().setColor(new Color(70, 130, 180));
    shape.addTextFrame("Styled shape");
    prs.save("styled.pptx");
}

Bežné problémy a riešenia

ClassNotFoundException for org.aspose.slides.foss.Presentation Závislosť Maven nie je vyriešená. Spustite mvn dependency:resolve a skontrolujte, či je artefakt dostupný v Maven Central. Overte verziu v pom.xml.

UnsupportedOperationException pri volaní určitých metód Niektoré funkcie (grafy, animácie, export do PDF) vyhadzujú UnsupportedOperationException v tejto verzii. Skontrolujte sekciu známych obmedzení v referencii API pred použitím pokročilých funkcií.

Súradnice tvaru sa zdajú nesprávne Súradnice a rozmery sú v EMU (English Metric Units). Jeden bod je približne 12700 EMU. Predvolený snímok má rozmery 9144000 × 6858000 EMU.

Súbor nebol nájdený pri načítavaní existujúceho PPTX
Zadajte absolútnu cestu alebo sa uistite, že pracovný adresár je nastavený správne:

import java.nio.file.Paths;
String path = Paths.get("presentations", "existing.pptx").toAbsolutePath().toString();
try (Presentation prs = new Presentation(path)) { ... }

Často kladené otázky

Vyžaduje aspose-slides-foss Microsoft Office?

Nie. Knižnica vytvára a číta súbory .pptx natívne v čistom Jave bez závislosti na Microsoft Office, COM automatizácii alebo Windows API.

Ktoré verzie Javy sú podporované?

Java 21 alebo novšia. Knižnica beží na Windows, macOS, Linux a Docker kontajneroch.

Je knižnica zadarmo pre komerčné použitie?

Áno. Je vydané pod licenciou MIT. Môžete ho používať, upravovať a redistribuovať pre akýkoľvek účel, vrátane komerčných aplikácií.

Môžem načítať existujúci súbor PPTX?

Áno. Zadajte cestu k súboru do konštruktora Presentation:

try (Presentation prs = new Presentation("existing.pptx")) {
    System.out.println("Loaded " + prs.getSlides().size() + " slides");
    prs.save("copy.pptx");
}

Potrebujem explicitne zatvoriť prezentáciu?

Áno. Presentation implementuje AutoCloseable. Vždy používajte try-with-resources (try (Presentation prs = new Presentation()) { ... }), aby ste zabezpečili čistenie.

Pozri tiež

 Slovenčina