Aspose.Slides FOSS for Java के साथ कैसे शुरू करें

aspose-slides-foss for Java एक मुफ्त, MIT-लाइसेंस वाली लाइब्रेरी है जो PowerPoint .pptx फ़ाइलों को बनाने और संपादित करने के लिए उपयोग की जाती है — कोई Microsoft Office आवश्यक नहीं, Maven Central पर उपलब्ध।

चरण-दर-चरण मार्गदर्शिका

चरण 1: Maven निर्भरता जोड़ें

अपने pom.xml में निर्भरता जोड़ें (Java 21 या बाद का आवश्यक है):

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

प्रोजेक्ट को बनाकर पैकेज सही ढंग से हल हो रहा है, यह सत्यापित करें:

mvn dependency:resolve

चरण 2: आवश्यक क्लासेस आयात करें

प्रेजेंटेशन लोड करने और सहेजने के लिए आवश्यक क्लासेस इम्पोर्ट करें:

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;

चरण 3: प्रस्तुति बनाएं

एक Presentation बिना किसी तर्क के बनाएं ताकि एक खाली स्लाइड से शुरू हो। हमेशा उपयोग करें try-with-resources ताकि आंतरिक संसाधनों को मुक्त किया जा सके:

import org.aspose.slides.foss.Presentation;

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

चरण 4: टेक्स्ट के साथ एक आकार जोड़ें

slide.getShapes().addAutoShape() का उपयोग करके एक आयत डालें, फिर addTextFrame() को कॉल करके
पाठ सामग्री जोड़ें:

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

चरण 5: भराव लागू करें और सहेजें

सहेजने से पहले आकार पर ठोस भराव रंग सेट करें:

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

सामान्य समस्याएँ और समाधान

ClassNotFoundException के लिए org.aspose.slides.foss.Presentation
Maven निर्भरता हल नहीं हुई है। mvn dependency:resolve चलाएँ और जाँचें कि आर्टिफैक्ट Maven Central में उपलब्ध है। pom.xml में संस्करण की पुष्टि करें।

UnsupportedOperationException कुछ विधियों को कॉल करते समय
कुछ सुविधाएँ (चार्ट, एनीमेशन, PDF निर्यात) इस रिलीज़ में UnsupportedOperationException फेंकती हैं। उन्नत सुविधाओं का उपयोग करने से पहले API संदर्भ के ज्ञात सीमाओं अनुभाग की जाँच करें।

आकार निर्देशांक गलत लग रहे हैं
निर्देशांक और आयाम EMU (English Metric Units) में होते हैं। एक बिंदु लगभग 12700 EMU के बराबर है। डिफ़ॉल्ट स्लाइड 9144000 × 6858000 EMU है।

फ़ाइल नहीं मिली जब मौजूदा PPTX लोड किया जा रहा है
एक पूर्ण पथ पास करें या सुनिश्चित करें कि कार्य निर्देशिका सही ढंग से सेट है:

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

अक्सर पूछे जाने वाले प्रश्न

क्या aspose-slides-foss को Microsoft Office की आवश्यकता है?

नहीं। लाइब्रेरी शुद्ध जावा में मूल रूप से .pptx फ़ाइलें बनाती और पढ़ती है, बिना Microsoft Office, COM automation, या Windows APIs पर निर्भरता के।

कौन से जावा संस्करण समर्थित हैं?

Java 21 या बाद का संस्करण। लाइब्रेरी Windows, macOS, Linux, और Docker कंटेनरों पर चलती है।

क्या लाइब्रेरी व्यावसायिक उपयोग के लिए मुफ्त है?

हाँ। इसे MIT लाइसेंस के तहत जारी किया गया है। आप इसे किसी भी उद्देश्य के लिए, जिसमें व्यावसायिक अनुप्रयोग भी शामिल हैं, उपयोग, संशोधित और पुनर्वितरित कर सकते हैं।

क्या मैं मौजूदा PPTX फ़ाइल लोड कर सकता हूँ?

हाँ। फ़ाइल पथ को Presentation कंस्ट्रक्टर को पास करें:

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

क्या मुझे प्रस्तुति को स्पष्ट रूप से बंद करने की आवश्यकता है?

हाँ। Presentation AutoCloseable को लागू करता है। हमेशा try-with-resources (try (Presentation prs = new Presentation()) { ... }) का उपयोग करें ताकि सफाई सुनिश्चित हो सके।