Hur man börjar med Aspose.3D FOSS för Java
Aspose.3D FOSS för Java är en gratis, MIT-licensierad bibliotek för laddning, manipulering och spara 3D-filer - inga inhemska binärer krävs, ren Java från Maven Central.
Steg för steg guide
Steg 1: Lägg till Maven beroende
Lägg till följande beroende på din pom.xml (Java 21 eller senare krävs):
<dependency>
<groupId>com.aspose</groupId>
<artifactId>aspose-3d-foss</artifactId>
<version>26.1.0</version>
</dependency>Kontrollera installationen laddas korrekt:
import com.aspose.threed.*;
Scene s = new Scene();
System.out.println("Aspose.3D loaded.");Steg 2: Import nödvändiga klasser
Import av kärnklasser för scenladdning och manipulation:
import com.aspose.threed.Scene;
import com.aspose.threed.Node;Steg 3: Ladda upp en 3D-fil
Användning Scene.fromFile() ladda alla stödda format. biblioteket upptäcker formatet automatiskt från filändelsen:
import com.aspose.threed.Scene;
Scene scene = Scene.fromFile("model.obj");
System.out.println("Loaded scene with root node: " + scene.getRootNode().getName());Eller använda den open() Instansmetod är:
Scene scene = new Scene();
scene.open("model.glb");Steg 4: Överträda scenen grafen
En laddad scen är ett träd av Node föremål som är rötta 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: Spara till ett annat format
Användning Scene.save() för export till alla stödda utgångsformat. biblioteket upptäcker Utgångsformat från filändelsen:
import com.aspose.threed.Scene;
Scene scene = Scene.fromFile("model.obj");
scene.save("output.glb");
System.out.println("Saved as GLB.");Vanliga problem och fixar
FileNotFoundException När ringer Scene.fromFile() Vägen du passerade finns inte eller använder fel separator. Använd en absolut väg eller java.nio.file.Paths.get() För att säkerställa att filvägen är korrekt.
Okänd formatfel Se till att filändelsen matchar det faktiska formatet. biblioteket upptäcker format genom förlängning för open() och fromFile().Passera en explicit format parameter för att överrida.
tom scen efter laddning Vissa binära format kan kräva specifika laddningsalternativ. försök att använda en explicit överbelastning med laddningsalternativ om standarden ger en tom scen.
UnsupportedOperationException För vissa metoder Vissa metoder (scene rendering, vattenmärkning) är inte tillgängliga i FOSS-utgåvan. Kontrollera begränsningsdokumentationen innan du använder avancerade funktioner.
Ofta ställda frågor
Behöver Aspose.3D FOSS några inhemska DLL?
Biblioteket är rent Java med inga inhemska beroende eller externa binärer krävs.
Vilka Java-versioner stöds?
Biblioteket körs på Windows, macOS, Linux och Docker-behållare.
Är biblioteket gratis för kommersiellt bruk?
Det släpps under MIT-licensen. Du kan använda, modifiera och omfördelar det för alla ändamål, inklusive kommersiella applikationer.
Vilka 3D-format kan jag läsa och skriva?
Biblioteket stöder OBJ, STL, glTF 2.0 / GLB och FBX för både läsning och skrivande. Använd den Scene.save() API-baserad förlängning för export till något stödsformat.
Kan jag skapa en 3D-scena från scratch?
Ja, bygg A Scene utan argument, lägg till barn noder för att scene.getRootNode(),och Spara i önskad format.