Как начать с Aspose.3D FOSS для Java

Как начать с Aspose.3D FOSS для Java

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

Крок за шагом руководство

Шаг 1: Добавить зависимость от мавен

Добавьте следующую зависимость к вашему pom.xml (Java 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 для читания и письма. Используйте The Scene.save() API-базируемый на расширение для экспорта в любой поддерживаемый формат.

Можно ли создать 3D-сцену из скратча?

Да. Создание A Scene без аргументов, добавьте детские узлы к scene.getRootNode(),и Сделайте в желаемом формате.

Смотреть также

 Русский