Hvordan å starte med Aspose.3D FOSS for Java
Aspose.3D FOSS for Java er en gratis, MIT-licensert bibliotek for lasting, manipulering og lagring av 3D filer - ingen innfødte binære kreves, ren Java fra Maven Central.
Steps-for-step guide
Steg 1: Legg til Maven avhengighet
Legg til følgende avhengighet til din pom.xml (Java 21 eller senere kreves):
<dependency>
<groupId>com.aspose</groupId>
<artifactId>aspose-3d-foss</artifactId>
<version>26.1.0</version>
</dependency>Sjekk installasjonen lastet riktig:
import com.aspose.threed.*;
Scene s = new Scene();
System.out.println("Aspose.3D loaded.");Steg 2: Import av nødvendige klasser
Import av kjerneklasser for scene lading og manipulasjon:
import com.aspose.threed.Scene;
import com.aspose.threed.Node;Trinn 3: Last ned en 3D fil
Bruker Scene.fromFile() for å laste ned alle støttet format. biblioteket oppdager formatet automatisk fra filforlengelsen:
import com.aspose.threed.Scene;
Scene scene = Scene.fromFile("model.obj");
System.out.println("Loaded scene with root node: " + scene.getRootNode().getName());Eller bruk den open() Instansemetode er:
Scene scene = new Scene();
scene.open("model.glb");Steg 4: Gjør scenen grafen
Et overbelastet scen er et tre av Node Objekter som er røtne i 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);Steg 5: Lagre til en annen format
Bruker Scene.save() for å eksportere til ethvert støttet utgangsformat. biblioteket oppdager Utgangsformat fra filutvidelsen:
import com.aspose.threed.Scene;
Scene scene = Scene.fromFile("model.obj");
scene.save("output.glb");
System.out.println("Saved as GLB.");Vanlige problemer og fixer
FileNotFoundException Når vi ringer Scene.fromFile() Veien du har gått gjennom eksisterer ikke eller bruker feil separator. Bruk en absolutt vei eller java.nio.file.Paths.get() For å sikre at filen er riktig.
Unknown format feil Sørg for at filutvidelsen matcher det faktiske formatet. biblioteket oppdager formatene ved å Utvidelse for open() og fromFile().Pass en eksplisitt formatparameter til å override.
Vekk scene etter lading Noen binære formater kan kreve spesifikke lastalternativer. prøv å bruke en eksplisitt overlast med lastalternativer hvis standardet produserer en tom scene.
UnsupportedOperationException For visse metoder Noen metoder (scenesign, vannmarkering) er ikke tilgjengelig i FOSS-utgaven. Sjekk dokumentasjonen om begrensninger før du bruker avanserte funksjoner.
Ofte stillede spørsmål
Er Aspose.3D FOSS krever noen innfødte DLL?
No. Biblioteket er ren Java med ingen innfødte avhengigheter eller eksterne binære kreves.
Hvilke Java-versjoner støttes?
Java 21 eller senere. biblioteket kjører på Windows, macOS, Linux og Docker-konteinere.
Er biblioteket gratis for kommersiell bruk?
Ja. Det er utgitt under MIT-lisens. Du kan bruke, endre og redistribuere det til ethvert formål, inkludert kommersielle applikasjoner.
Hvilke 3D-format kan jeg lese og skrive?
Biblioteket støtter OBJ, STL, glTF 2.0 / GLB og FBX for både lesing og skriving. Bruker den Scene.save() API-basert for utvidelse til å eksportere til alle støttet format.
Kan jeg lage en 3D scene fra scratch?
Konstruksjon A Scene uten argumenter, legge til barns noder til scene.getRootNode(),og Lagre til ønsket format.