Întrebări frecvente

Licențiere și Open Source

Care este modelul de licență pentru Aspose.3D FOSS pentru Java?

Aspose.3D FOSS pentru Java este lansat sub licența MIT. Puteți să o utilizați în proiecte personale, comerciale și open-source fără restricții. Nu este necesară nici un cheie de licență sau activare. Codul sursă este disponibil pe GitHub.

Pot folosi Aspose.3D FOSS pentru Java într-un produs comercial?

Da. Licența MIT permite utilizarea nelimitată a produselor comerciale. Nu este necesară nici o plată de royalty, server licențiat sau conexiune la internet în timp util.

Instalare & Cerințe

Cum să instalezi Aspose.3D FOSS pentru Java?

Adăugați dependența de Maven la tine pom.xml:

<dependency>
  <groupId>org.aspose</groupId>
  <artifactId>aspose-3d-foss</artifactId>
  <version>26.5.0</version>
</dependency>

Apoi, importati pachetul in fișierele de sursa:

import com.aspose.threed.*;

Ce versiune Java este necesară?

Aspose.3D FOSS pentru Java necesită JDK 21 sau mai târziu. este complet autoconținut fără dependențe native și fără binare specifice platformei.

Formatul de suport

Ce formate de fișier 3D pot citi și scrie Aspose.3D FOSS pentru Java?

Versiunea actuală susține următoarele formate:

Cum pot detecta automat formatul unui fișier?

Utilizarea FileFormat.getFormatByExtension(filePath) Pentru a vizualiza format prin extensie de fișier:

FileFormat fmt = FileFormat.getFormatByExtension("model.gltf");
System.out.println(fmt.getCanImport()); // true
System.out.println(fmt.getCanExport()); // true

Cum pot folosi opțiunile de încărcare sau salvare pentru un format specific?

Pass un obiect de opţiuni specifice formatului pentru a Scene.open() sau Scene.save().De exemplu, pentru a permite coordonatul-sistemului de flipping atunci când încărca glTF:

GltfLoadOptions opts = new GltfLoadOptions();
opts.setFlipCoordinateSystem(true);

Scene scene = new Scene();
scene.open("input.gltf", opts);

Pentru exportul de glTF cu JSON imprimat:

GltfSaveOptions saveOpts = new GltfSaveOptions();
saveOpts.setPrettyPrint(true);
scene.save("output.gltf", saveOpts);

În mod similar, FbxLoadOptions Este disponibil pentru configurarea importului FBX.

Utilizarea API-ului

Cum pot încărca un model 3D dintr-un fișier?

Foloseste fabrica statica Scene.fromFile(filePath) pentru o încărcare de un pas, sau construiți o Scene şi apelul scene.open(filePath):

// Option 1 — static factory (recommended)
Scene scene = Scene.fromFile("model.obj");

// Option 2 — instance method
Scene scene2 = new Scene();
scene2.open("model.fbx");

Cum pot crea o nouă scenă goală și să o salvez?

Construirea a Scene, adăugați noduri după cum este necesar, apoi apelați scene.save(filePath):

Scene scene = new Scene();
Node child = scene.getRootNode().createChildNode("Box");
scene.save("output.glb");

Cum pot trece prin graficul de scenă?

Accesul la nodul de rădăcină prin scene.getRootNode() şi ieteră pe copiii săi:

Scene scene = Scene.fromFile("model.gltf");
Node root = scene.getRootNode();

for (Node child : root.getChildNodes()) {
    System.out.println(child.getName());
}

Cum să salvez o scenă într-un format specific?

Pasă calea de ieșire cu extinderea țintă — Aspose.3D detectează formatul din pentru a efectua controlul explicit, treceți un FileFormat sau obiecte de opțiuni de salvare:

// Auto-detect output format from extension
scene.save("output.stl");

// Explicit format (using options object)
GltfSaveOptions opts = new GltfSaveOptions();
opts.setBufferFilePrefix("buffer_");
scene.save("output.gltf", opts);

Limite cunoscute

Este disponibilă în acest articol o prezentare 3D?

Nu. în Scene.render() Metode de aruncare UnsupportedOperationException În prezentul Rendering nu este încă implementat. Utilizați această bibliotecă pentru import, prelucrare, Exportarea datelor de scenă 3D.

Sunt toate funcțiile FBX susținute?

Importul FBX este susținut pentru geometrie și date de grafică scenă. exportul FBX nu este implementat — apel salvare cu fbx format aruncă ExportException.Complexul FBX Importare caracteristici cum ar fi animații încorporate, restricții și proprietăți FBX Extinderi nu pot fi în întregime păstrate.