Как да започнете с Aspose.3D FOSS за Java

Как да започнете с Aspose.3D FOSS за Java

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

Стъпка по стъпка ръководство

Стъпка 1: Добавете зависимостта на Maven

Добавете следната зависимост към вашата 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 изисква някакви коренни DLLs?

Библиотеката е чиста Java с никакви вътрешни зависимост или външни бинарни изисквания.

Какви версии на Java се поддържат?

Библиотеката работи на контейнери Windows, macOS, Linux и Docker.

Библиотеката е свободна за търговско ползване.?

Да. Тя е издадена под лиценза на MIT. Можете да я използвате, модифицирате и преразпределите за всякакви цели, включително търговски приложения.

Какви 3D формати мога да чета и пиша?

Библиотеката поддържа OBJ, STL, glTF 2.0 / GLB и FBX за четене и писане. Използвайте го Scene.save() API базирана на разширение за износ към всеки поддържан формат.

Мога ли да създам 3D сцена от скратено?

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

Виж също

 Български