Начало работы

Начало работы с Aspose.3D FOSS для Java

Добро пожаловать в aspose-3d-foss, бесплатная, открытая библиотека Java для загрузки, построения и экспорта 3D‑сцен. Это руководство проведёт вас от нового проекта к работающей сцене за считанные минуты.

Требования

ТребованияПодробности
JavaJDK 21 или новее
Инструмент сборкиMaven или Gradle
OSWindows, macOS или Linux

Установка

Добавьте зависимость Maven в ваш pom.xml:

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

Проверьте:

import com.aspose.threed.Scene;

public class Main {
    public static void main(String[] args) {
        Scene scene = new Scene();
        System.out.println("aspose-3d-foss loaded successfully.");
    }
}

См. Руководство по установке для настройки Gradle и шагов проверки.

Что вы можете сделать

После установки вы можете сразу:

  • Загрузить файлы OBJ, STL, glTF 2.0 / GLB и FBX через scene.open()
  • Проверить иерархии сцены: обход Node деревья, чтение Mesh геометрия, доступ к нормалям вершин и UVs
  • Transform узлы: задайте перемещение, вращение и масштаб через Transform класс
  • Применить материалы: назначить Material или PbrMaterial к узлам
  • Экспорт в любой поддерживаемый формат с scene.save()
  • Создать геометрию: создать Mesh объекты программно с контрольными точками и полигонами

Быстрый старт

Загрузите 3D‑файл, выведите иерархию сцены и сохраните заново в формате GLB:

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

public class QuickStart {
    public static void main(String[] args) throws Exception {
        Scene scene = new Scene();
        scene.open("input.obj");

        System.out.println("Root children: " + scene.getRootNode().getChildNodes().size());
        for (Node node : scene.getRootNode().getChildNodes()) {
            String entityType = node.getEntity() != null
                ? node.getEntity().getClass().getSimpleName()
                : "no entity";
            System.out.println("  " + node.getName() + " [" + entityType + "]");
        }

        scene.save("output.glb");
        System.out.println("Saved output.glb");
    }
}

Следующие шаги

 Русский