Kā sākt darbu ar Aspose.3D FOSS priekš Java

Aspose.3D FOSS priekš Java ir bezmaksas, MIT licencēta bibliotēka, kas ļauj ielādēt, manipulēt un saglabāt 3D failus — nav vajadzīgi vietējie binārie faili, tīrs Java no Maven Central.

Rokasgrāmata soli pa solim

1. solis: Pievienojiet Maven atkarību

Pievienojiet šādu atkarību jūsu pom.xml (Java 21 vai jaunāks ir nepieciešams):

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

Pārbaudiet, vai instalācija ielādējās pareizi:

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

2. solis: Importējiet nepieciešamās klases

Importējiet pamatklases ainas ielādei un manipulēšanai:

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

3. solis: Ielādēt 3D failu

Izmantojiet Scene.fromFile() lai ielādētu jebkuru atbalstītu formātu. Bibliotēka automātiski noteic formātu automātiski no faila paplašinājuma:

import com.aspose.threed.Scene;

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

Vai arī izmantojiet open() instances metodi:

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

4. solis: Pārlūkot ainas grafu

Ielādēta aina ir koks no Node objektiem, kura sakne ir 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);

5. solis: Saglabāt citā formātā

Izmantojiet Scene.save() eksportēt uz jebkuru atbalstītu izvades formātu. Bibliotēka nosaka izvades formātu no faila paplašinājuma:

import com.aspose.threed.Scene;

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

Biežāk sastopamās problēmas un risinājumi

FileNotFoundException izsaucot Scene.fromFile() Norādītais ceļš neeksistē vai izmanto nepareizu atdalītāju. Izmantojiet absolūto ceļu vai java.nio.file.Paths.get() lai pārliecinātos, ka faila ceļš ir pareizs.

Nezināma formāta kļūda Pārliecinieties, ka faila paplašinājums atbilst faktiskajam formātam. Bibliotēka nosaka formātu pēc paplašinājuma priekš open() un fromFile(). Norādiet skaidru formāta parametru, lai pārrakstītu.

Tukša aina pēc ielādes Dažiem binārajiem formātiem var būt nepieciešamas specifiskas ielādes opcijas. Mēģiniet izmantot explicit overload ar ielādes opcijām, ja noklusējums rada tukšu ainu.

UnsupportedOperationException noteiktām metodēm Dažas metodes (ainas renderēšana, ūdenszīmes pievienošana) nav pieejamas FOSS versijā. Pirms izmantot papildu funkcijas, pārbaudiet ierobežojumu dokumentāciju.

Biežāk uzdotie jautājumi

Vai Aspose.3D FOSS pieprasa kādas vietējās DLL?

Nē. Bibliotēka ir tīri Java bez vietējām atkarībām vai ārējām binārajām failiem.

Kādas Java versijas tiek atbalstītas?

Java 21 vai jaunāka. Bibliotēka darbojas Windows, macOS, Linux un Docker konteineros.

Vai bibliotēka ir bezmaksas komerciālai lietošanai?

Jā. Tā ir izlaista zem MIT licences. Jūs varat izmantot, modificēt un izplatīt jebkuram mērķim, ieskaitot komerciālas lietojumprogrammas.

Kādus 3D formātus varu lasīt un rakstīt?

Bibliotēka atbalsta OBJ, STL, glTF 2.0 / GLB un FBX gan lasīšanai, gan rakstīšanai. Izmantojiet Scene.save() paplašinājuma bāzēto API, lai eksportētu uz jebkuru atbalstītu formātu.

Vai es varu izveidot 3D ainu no sākuma?

Jā. Izveidojiet Scene bez argumentiem, pievienojiet bērna mezglus scene.getRootNode(), un saglabāt vēlamajā formātā.