Як почати з Aspose.3D FOSS для Java

Aspose.3D FOSS для Java - це безкоштовна, ліцензована бібліотека MIT для завантаження, маніпулювання та збереження 3D-файлів — немає німецьких бінарних необхідних чистих Java з Maven Central.

Крок за кроком - Guide

Крок 1: Додайте Maven Залежність

Додайте наступну залежність до вашого pom.xml (Ява 21 або пізніше вимагається):

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

Перевірте, що зарядка встановлена правильно:

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

Крок 2: Ввезення необхідних класів

Імпорт основних класів для завантаження та маніпуляції сцени:

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

Крок 3: Завантажити 3D-файл

Використання Scene.fromFile() завантажувати будь-який підтримуваний формат. Бібліотека виявляє формати Автоматично з розширення файлу:

import com.aspose.threed.Scene;

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

або використовуйте його open() Метод інстанції:

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

Крок 4: Перейти через сцену графік

Сцену, що навантажується, є дерево Node Об’єкти, що закріплені в 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: Зберегти в інший формат

Використання Scene.save() для експорту в будь-який підтримуваний формат виходу. Бібліотека розпізнає Формат виходу з розширення файлу:

import com.aspose.threed.Scene;

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

Загальні проблеми та рішення

FileNotFoundException Коли закликати Scene.fromFile() Пут, який ви пройшли не існує або використовує неправильний розділятор. java.nio.file.Paths.get() Щоб переконатися, що шлях файлу правильний.

Невідомий формат помилки Забезпечити, що розширення файлу відповідає фактичному формату. Бібліотека виявляє формат за допомогою Продовження для open() і fromFile().Перенести чіткий параметр формату для перехрестя.

Порожня сцена після завантаження Деякі бінарні формати можуть вимагати конкретних опцій завантаження. спробуйте використовувати експлицитну перевантажу з опціями завантаження, якщо у замовленні виникає порожня сцена.

UnsupportedOperationException Для певних методів Деякі методи (рендеринг сцен, водозначення) не доступні в FOSS-виданні. Перевірте документацію обмежень перед використанням передових функцій.

Часто задавані запитання

Чи потрібні Aspose.3D FOSS будь-яким корінним DLL?

Бібліотека чиста Java з ні в якому місці, ні зовнішніми двосторонніми необхідними.

Які версії Java підтримуються?

Бібліотека працює на контейнерах Windows, macOS, Linux і Docker.

Чи є бібліотека безкоштовною для комерційного використання?

Ви можете використовувати, модифікувати і перерозподіляти його для будь-якого цілей, включаючи комерційні додатки.

Які 3D-формати можна читати і писати?

Бібліотека підтримує OBJ, STL, glTF 2.0 / GLB і FBX для читання та написання. Використовуйте його Scene.save() API-базирується на розширеннях для експорту в будь-який підтримуваний формат.

Чи можна створити 3D-сцену з скратча?

Створення A Scene без аргументів, додайте дитячі вузли до scene.getRootNode(), і Залишитися в бажаному форматі.