Hoe te beginnen met Aspose.3D FOSS voor Java

Aspose.3D FOSS voor Java is een gratis, MIT-licentieerde bibliotheek voor het opladen, manipuleren en besparen van 3D-bestanden - geen inheemse binaire vereiste, pure Java van Maven Central.

Step-by-Step Guide voor de werkplek

Stap 1: Voeg de Maven-afhankelijkheid toe

Voeg de volgende afhankelijkheid toe aan uw pom.xml (Java 21 of later vereist):

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

Controleer de installatie correct geladen:

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

Stap 2: Import vereiste klassen

Import de kernklassen voor scène laden en manipulatie:

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

Stap 3: Een 3D-bestand opladen

Gebruik Scene.fromFile() om alle ondersteunde formaten te laden. de bibliotheek detecteert het format automatisch uit de bestanduitbreiding:

import com.aspose.threed.Scene;

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

Of gebruik de open() Instantie methode :

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

Stap 4: Over de scène grafiek

Een opgeladen scène is een boom van Node De voorwerpen die in de 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);

Stap 5: Save naar een andere vorm

Gebruik Scene.save() om te exporteren naar een ondersteunde outputformat. de bibliotheek detecteert de Uitgangsformaat van de bestanduitbreiding:

import com.aspose.threed.Scene;

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

Gemeenschappelijke problemen en fixes

FileNotFoundException Wanneer het roepen Scene.fromFile() De weg die je hebt doorbracht bestaat niet of gebruikt de verkeerde scheider. gebruik een absolute route of java.nio.file.Paths.get() Om ervoor te zorgen dat de bestandpad correct is.

Onbekende formatenfouten Zorg dat de bestanduitbreiding overeenkomt met het werkelijke formaat.De bibliotheek detecteert format door: Uitbreiding voor open() en fromFile(). Pass een uitdrukkelijke formatparameters om te override.

Vakantie scene na loading Sommige binaire formaten kunnen specifieke ladingopties vereisen. probeer een uitdrukkelijke overbelasting te gebruiken met opties voor lading als de standaard een leeg scène produceert.

UnsupportedOperationException Voor bepaalde methoden Sommige methoden (scene rendering, watermarking) zijn niet beschikbaar in de FOSS-editie. Controleer de beperkingendocumentatie voordat u geavanceerde functies gebruikt.

Vaak gestelde vragen

Heeft Aspose.3D FOSS enige inheemse DLL’s nodig?

De bibliotheek is pure Java met geen inheemse afhankelijkheden of externe binariën vereist.

Welke Java-versies zijn ondersteund?

De bibliotheek loopt op Windows, macOS, Linux en Docker containers.

Is de bibliotheek gratis voor commerciële gebruik?

U kunt het gebruiken, wijzigen en redistribueren voor elk doel, inclusief commerciële toepassingen.

Welke 3D-formaat kan ik lezen en schrijven?

De bibliotheek ondersteunt OBJ, STL, glTF 2.0 / GLB en FBX voor zowel lezen als schrijven. Gebruik de Scene.save() API op basis van extensie om te exporteren naar een ondersteunde formats.

Kan ik een 3D-scène maken van scratch?

Ja, bouw een Scene zonder argumenten, voeg de kindernodes toe aan scene.getRootNode(), en op het gewenste formaat.