Jak začít s Aspose.3D FOSS pro Java

Aspose.3D FOSS pro Java je bezplatná knihovna s licencí MIT pro stahování, manipulace a úsporu 3D souborů – žádné domácí binární požadavky, čistá Java z Maven Central.

Krok za krokem průvodce

Krok 1: Přidejte závislost na Mavenu

Přidejte následující závislost na vašem pom.xml (Java 21 nebo později vyžaduje):

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

Zkontrolujte správně nabitý instalace:

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

Krok 2: Import požadovaných tříd

Import základní třídy pro scénické nabíjení a manipulace:

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

Krok 3: Stáhněte si 3D soubor

Použití Scene.fromFile() - přenášet jakýkoli formát podporovaný. knihovna detekuje formáty automaticky z rozšíření souboru:

import com.aspose.threed.Scene;

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

Nebo použijte open() Případní metoda :

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

Krok 4: Přejděte přes scénický graf

Nádherná scéna je stromem Node Objekty zakotvené 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žte do jiného formátu

Použití Scene.save() do jakéhokoli formátu výstupu podporovaného. knihovna detekuje Formát výstupu z rozšíření souboru:

import com.aspose.threed.Scene;

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

Společné problémy a fixy

FileNotFoundException Když voláme Scene.fromFile() Cesta, kterou jste prošli neexistuje nebo používá nesprávný separátor. java.nio.file.Paths.get() Zajišťujeme, že je správná cesta k souboru.

Neznámá chyba formátu Ujistěte se, že rozšíření souboru odpovídá skutečnému formátu. knihovna detekuje formát podle Rozšíření pro open() a fromFile().Přejděte do výslovného formátu parametru, aby se přehodnotil.

Prázdná scéna po nakládce Některé binární formáty mohou vyžadovat specifické možnosti zatížení. zkuste použít explicitní přetížení s možností nabití, pokud výchozí produkuje prázdnou scénu.

UnsupportedOperationException Pro určité metody Některé metody (reference scény, vodní označení) nejsou k dispozici v vydání FOSS. Zkontrolujte dokumentaci omezení před použitím pokročilých funkcí.

Často kladené otázky

Potřebuje Aspose.3D FOSS žádné nativní DLL?

No. Knihovna je čistá Java s žádnými domorodými závislostmi nebo vnějšími binárními požadavky.

Které Java verze jsou podporovány?

Knihovna funguje na kontejnerech Windows, macOS, Linux a Docker.

Je knihovna zdarma pro komerční použití?

Je vydán pod licencí MIT. Můžete jej používat, upravovat a distribuovat pro jakýkoli účel, včetně komerčních aplikací.

Jaké 3D formáty si mohu přečíst a psát?

Knihovna podporuje OBJ, STL, glTF 2.0 / GLB a FBX pro čtení a psaní. Použijte si Scene.save() API založené na rozšíření pro export do jakéhokoli podporovaného formátu.

Můžu vytvořit 3D scénu z skratku?

Ano, stavět a Scene bez argumentů, přidejte dětské uzly k scene.getRootNode(),a Využijte požadovaný formát.