Aspose.3D FOSS
Java
Πώς να ξεκινήσετε με το Aspose.3D FOSS για Java

Πώς να ξεκινήσετε με το Aspose.3D FOSS για Java

Το Aspose.3D FOSS για Java είναι μια δωρεάν, MIT-licensed βιβλιοθήκη για την φόρτωση, χειρισμό και αποθήκευση 3D αρχείων - δεν απαιτούνται εγχώριες δυαδικές ανάγκες, καθαρή Java από το Maven Central.

Βήμα προς βήμα οδηγός

Βήμα 1: Προσθέστε την εξάρτηση Maven

Προσθέστε την εξάρτηση στο δικό σας pom.xml (Η Java 21 ή αργότερα απαιτείται):

<dependency>
  <groupId>com.aspose</groupId>
  <artifactId>aspose-3d-foss</artifactId>
  <version>26.1.0</version>
</dependency>

Ελέγξτε την εγκατάσταση φορτωμένη σωστά:

import com.aspose.threed.*;
Scene s = new Scene();
System.out.println("Aspose.3D loaded.");

Βήμα 2: Εισαγωγή απαιτούμενων τάξεων

Εισαγωγή των κεντρικών τάξεων για το φορτίο σκηνής και τη χειραγώγηση:

import com.aspose.threed.Scene;
import com.aspose.threed.Node;

Βήμα 3: Κατεβάστε ένα αρχείο 3D

Χρησιμοποιήστε Scene.fromFile() να φορτώσει οποιαδήποτε υποστηριζόμενη μορφή. η βιβλιοθήκη ανιχνεύει τη μορφοποίηση Αυτόματα από την επέκταση αρχείου:

import com.aspose.threed.Scene;

Scene scene = Scene.fromFile("model.obj");
System.out.println("Loaded scene with root node: " + scene.getRootNode().getName());

Ή χρησιμοποιήστε το open() Μέθοδος της υπόθεσης:

Scene scene = new Scene();
scene.open("model.glb");

Βήμα 4: Περπατήστε το γραφείο σκηνής

Μια σκηνή φορτισμένη είναι ένα δέντρο Node αντικείμενα που ριζώνουν σε scene.getRootNode():

import com.aspose.threed.Node;
import com.aspose.threed.Scene;

void walk(Node node, int depth) {
    String indent = " ".repeat(depth * 2);
    System.out.println(indent + "Node: " + node.getName());
    for (Node child : node.getChildNodes()) {
        walk(child, depth + 1);
    }
}

Scene scene = Scene.fromFile("model.obj");
walk(scene.getRootNode(), 0);

Βήμα 5: Αποθηκεύστε σε διαφορετικό μορφότυπο

Χρησιμοποιήστε Scene.save() να εξάγει σε οποιαδήποτε μορφή έκδοσης που υποστηρίζεται. η βιβλιοθήκη εντοπίζει την Η μορφή εξόδου από την επέκταση αρχείου:

import com.aspose.threed.Scene;

Scene scene = Scene.fromFile("model.obj");
scene.save("output.glb");
System.out.println("Saved as GLB.");

Κοινά προβλήματα και τακτοποιήσεις

FileNotFoundException Όταν καλείται Scene.fromFile() Ο δρόμος που πέρασες δεν υπάρχει ή χρησιμοποιεί τον λάθος διαχωριστή. java.nio.file.Paths.get() Για να διασφαλιστεί ότι η πορεία του αρχείου είναι σωστή.

Απίστευτο σφάλμα μορφής Βεβαιωθείτε ότι η επέκταση αρχείου ταιριάζει με την πραγματική μορφή.Η βιβλιοθήκη ανακαλύπτει τη μορφοποίηση από το Η επέκταση για open() και fromFile().Πάρτε μια σαφή παραμέτρους μορφής για να υπερβαίνει.

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

UnsupportedOperationException Για ορισμένες μεθόδους Ορισμένες μεθόδους (εικόνα rendering, watermarking) δεν είναι διαθέσιμες στην έκδοση FOSS. Ελέγξτε την τεκμηρίωση περιορισμών πριν χρησιμοποιήσετε προηγμένες λειτουργίες.

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

Το Aspose.3D FOSS απαιτεί οποιαδήποτε DLL;?

Η βιβλιοθήκη είναι καθαρή Java χωρίς εγχώρια εξάρτηση ή εξωτερικές δυαδικές απαιτήσεις.

Ποια εκδόσεις Java υποστηρίζονται;?

Η βιβλιοθήκη λειτουργεί στα Windows, macOS, Linux και Docker.

Είναι η βιβλιοθήκη ελεύθερη για εμπορική χρήση;?

Μπορείτε να το χρησιμοποιήσετε, να τροποποιήσουν και να αναδιανέμουν για οποιονδήποτε σκοπό, συμπεριλαμβανομένων των εμπορικών εφαρμογών.

Ποια 3D μορφή μπορώ να διαβάσω και να γράψω;?

Η βιβλιοθήκη υποστηρίζει OBJ, STL, glTF 2.0 / GLB και FBX για τόσο την ανάγνωση όσο και τη γραφή. Χρησιμοποιήστε το Scene.save() API βασισμένη στην επέκταση για εξαγωγή σε οποιαδήποτε υποστηριζόμενη μορφή.

Μπορώ να δημιουργήσω μια σκηνή 3D από το scratch;?

Ναι. Δημιουργία A Scene χωρίς λόγους, προσθέστε τα παιδικά κόμβα στο scene.getRootNode(),και Συσκευή στο επιθυμητό σχήμα.

Δείτε επίσης

 Ελληνικά