Hvordan man starter med Aspose.3D FOSS for Java

Hvordan man starter med Aspose.3D FOSS for Java

Aspose.3D FOSS for Java er en gratis, MIT-licenseret bibliotek til opladning, manipulation og sparing af 3D filer - ingen indfødte binære krav, ren Java fra Maven Central.

Step-by-Step Guide til dig

Trin 1: Tilføj Maven afhængighed

Tilføj følgende afhængighed til din pom.xml (Java 21 eller senere er påkrævet):

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

Kontroller installationen korrekt:

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

Trin 2: Import af nødvendige klasser

Import af de centrale klasser til sceneopladning og manipulation:

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

Trin 3: Lade en 3D fil

Brug af Scene.fromFile() at lade alle støttede format. biblioteket opdager formatet automatisk fra filforlængelsen:

import com.aspose.threed.Scene;

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

Eller brug den open() Indsigt metode:

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

Trin 4: Gå over scenen grafen

En bærende scene er et træ af Node Objekter, der er rødme 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);

Trin 5: Spare til et andet format

Brug af Scene.save() til at eksportere til ethvert støttet udgangsformat. biblioteket opdager Udgangsformatet fra filforlængelsen:

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 kaldet Scene.fromFile() Den vej, du passerer, eksisterer ikke eller bruger den forkerte separator. Brug en absolut vej eller java.nio.file.Paths.get() For at sikre, at filen er korrekt.

Ukendt formatfejl Sørg for, at filudvidelsen matcher det faktiske format. biblioteket opdager formatet ved hjælp af Udvidelse til open() og fromFile().Gør en eksplicit format parameter til at override.

En tom scene efter opladning Nogle binære formater kan kræve specifikke opladningsmuligheder. prøv at bruge en eksplisiv overbelastning med optioner for belastning, hvis standardet producerer en tom scene.

UnsupportedOperationException For visse metoder Nogle metoder (scene rendering, vandmarkering) er ikke tilgængelige i FOSS-udgaven. Tjek begrænsningshistorien, før du bruger avancerede funktioner.

Ofte stillede spørgsmål

Har Aspose.3D FOSS brug for nogen indfødte DLL’er?

Biblioteket er ren Java med ingen indfødte afhængigheder eller eksterne binære krav.

Hvilke Java-versioner støttes?

Biblioteket kører på Windows, macOS, Linux og Docker containere.

Er biblioteket gratis til kommercielt brug?

Det er udgivet under MIT-licens. Du kan bruge, ændre og redistribuere det til ethvert formål, herunder kommercielle applikationer.

Hvilke 3D-format kan jeg læse og skrive?

Biblioteket understøtter OBJ, STL, glTF 2.0 / GLB og FBX for både læsning og skrivning. Brug den Scene.save() API-baseret udvidelse til eksport til ethvert understøttede format.

Kan jeg lave en 3D scene fra scratch?

Konstruktion A Scene med ingen argumenter, tilføje børns knuder til scene.getRootNode(),og Sæt til det ønskede format.

Se også

 Dansk