Ako začať s Aspose.3D FOSS pre Java

Aspose.3D FOSS pre Java je bezplatná knižnica s licenciou MIT na nahrávanie, manipuláciu a úsporu 3D súborov - žiadne domáce binárne požadované, čisté Java z Maven Central.

Krok za krokom sprievodca

Krok 1: Pridať Maven závislosť

Pridajte nasledujúcu závislosť k vašej pom.xml (Java 21 alebo neskôr je potrebná):

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

Skontrolujte správne nabitý inštalátor:

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

Krok 2: Import požadovaných tried

Import kľúčových tried pre nahrávanie a manipuláciu scénou:

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

Krok 3: Nahrať 3D súbor

Používanie Scene.fromFile() na stiahnutie akéhokoľvek podporovaného formátu. knižnica detekuje formát automaticky z rozšírenia súboru:

import com.aspose.threed.Scene;

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

alebo použite open() Prípadná metóda :

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

Krok 4: Prejsť cez scénový graf

Nádherná scéna je stromček Node Objekty zakorenené v 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);

Krok 5: Uložiť do iného formátu

Používanie Scene.save() na export do akéhokoľvek podporovaného formátu výstupu. knižnica detekuje formát výstupu z rozšírenia súborov:

import com.aspose.threed.Scene;

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

Spoločné problémy a riešenia

FileNotFoundException Keď volá Scene.fromFile() Cesta, ktorú ste prešli neexistuje alebo používa nesprávny separátor. java.nio.file.Paths.get() zabezpečiť, aby bola správna cesta súboru.

Neznámy formát chyb Uistite sa, že rozšírenie súboru zodpovedá skutočnému formátu. knižnica detekuje formát podľa rozšírenie pre open() a fromFile().Prepustiť explicitný parameter formátu pre override.

Prázdna scéna po nahrávaní Niektoré binárne formáty môžu vyžadovať špecifické možnosti zaťaženia. skúste použiť explicitný preťaženie s možnosťami zaťaženia, ak predvolený produkuje prázdnu scénu.

UnsupportedOperationException V niektorých metódach Niektoré metódy (referencie scény, vodné označenie) nie sú k dispozícii v vydaní FOSS. Skontrolujte dokumentáciu obmedzení pred použitím pokročilých funkcií.

Často kladené otázky

Potrebuje Aspose.3D FOSS žiadne domáce DLL?

Knižnica je čistá Java s žiadnou domácich závislostí alebo externých binárnych požiadaviek.

Ktoré Java verzie sú podporované?

Java 21 alebo neskôr. knižnica beží na kontajneroch Windows, macOS, Linux a Docker.

Je knižnica voľná na komerčné použitie?

Je vydaný podľa licencie MIT. Môžete ho používať, modifikovať a distribuovať na akýkoľvek účel vrátane komerčných aplikácií.

Aké 3D formáty môžem čítať a písať?

Knižnica podporuje OBJ, STL, glTF 2.0 / GLB a FBX pre čítanie a písanie. Použite si Scene.save() rozšírenia založené API na export do akéhokoľvek podporovaného formátu.

Môžem vytvoriť 3D scénu z škrabanca?

konštrukcia a Scene bez argumentov, pridajte detské uzly k scene.getRootNode(),a , a Uložiť do požadovaného formátu.