Започване

Започване с Aspose.3D FOSS за Java

Добре дошли в aspose-3d-foss, безплатна, с отворен код Java библиотека за зареждане, създаване и експортиране на 3D сцени. Това ръководство ви превръща от нов проект до работеща сцена за минути.

Предпоставки

Инсталация

Добавете 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 геометрия, достъп до нормалите на върховете и UV координати
• Трансформация възли: задайте транслация, ротация и мащаб чрез 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");
    }
}

Следващи стъпки

• Ръководство за инсталиране: Настройка и проверка на Maven/Gradle
• Ръководство за разработчици: Поддръжка на формати, операции с мрежи, материали и трансформации
• Характеристики и функционалности: Подробен преглед на всяка област на функциите с примери Java