Как да започнете с 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(),и Използвайте желания формат.