1. Продукти
  2.   Aspose.3D
  3.   Aspose.3D FOSS for Java

Aspose.3D FOSS за Java

Зареждайте, създавайте, трансформирайте и експортирайте 3D сцени от Java — безплатно и с отворен код.

Отворен код Java библиотека за обработка на 3D файлове

Aspose.3D FOSS за Java е библиотека с лиценз MIT, чисто-Java, предназначена за работа с 3D файлови формати. Добавете една единствена Maven зависимост и веднага започнете да четете, конструирате и записвате 3D сцени, без да инсталирате нито едно native runtime, външен SDK или трети рендерер.

Библиотеката предоставя чист API за сценичен граф, построен около Scene, Node, Mesh, Camera и Transform, същият концептуален модел, използван от професионалните 3D инструменти. Поддръжката на формати включва OBJ (с зареждане на материали от .mtl), STL (бинарен и ASCII, проверено с roundtrip), glTF 2.0 (PBR материали), GLB (бинарен glTF) и FBX (само импорт). Опциите за зареждане и запис за всеки формат ви позволяват да контролирате обръщане на координати, мащаб, нормализиране на нормалите и зареждане на материали, без да пишете код за парсинг, специфичен за формата.

Aspose.3D FOSS изисква Java 21 или по-нов и работи идентично на Windows, macOS и Linux CI runner-и, Docker контейнери и сървърлес среди. Няма native extension за компилиране и няма системен пакет за инсталиране.

Поддръжка на 3D формати и API за граф на сцената

  • OBJ / MTL: Зарежда Wavefront OBJ файлове с придружаващи дефиниции на материали.
  • STL: Чете и записва както бинарни, така и ASCII STL с пълна проверка на roundtrip.
  • glTF 2.0 / GLB: Зареждане на PBR материали и експортиране чрез GltfSaveOptions. Използвайте setContentType(FileContentType.BINARY) за GLB изход.
  • FBX: Поддръжка за импорт на FBX файлове (експорт не е наличен).
  • Scene-graph API: Scene, Node, Mesh, Camera, Transform.

Къде Aspose.3D FOSS може да се използва

  • Верификационни конвейери за активи: Проверявайте, преориентирайте и реекспортирайте 3D активи в CI.
  • Инструменти за гейм разработка: Пакетна обработка на OBJ и STL мрежи без нативен енджин.
  • Работни процеси за 3D печат: Четете, валидирате и реекспортирате STL файлове.
  • Web бекендове: Сервирайте 3D конверсионни крайни точки в Docker или безсървърни функции.
  • Миграция на съдържание: Конвертирайте между семейства формати в мащаб.

Опции за всеки формат и контрол на координатите

  • Ориентация на координатната система: Обръщане на осите и корекция на мащаба според формата без персонализиран код.
  • Нормализиране на нормалите: Автоматично нормализиране на върховите нормали при зареждане или запазване.
  • Контрол на зареждането на материали: Включване или изключване на зареждането на MTL/текстури за по-бързо парсиране.
  • Форматиране на изхода: Изберете компактен или четим за хора glTF JSON чрез опциите.
  • Точност при обратен процес: Неизвестните възли в графа на сцената се запазват буквално при повторно запазване.

Опит на разработчиците

Aspose.3D FOSS за Java инсталации с една единствена Maven зависимост (com.aspose:aspose-3d-foss:26.1.0). Библиотеката е чисто Java, без родни разширения за компилация и без системни пакети за инсталиране.

API‑то за сценичен граф отразява концептуалния модел на професионалните 3D инструменти, така че кривата на обучение е къса за всеки, запознат с модела на данни на Three.js или Blender. Библиотеката е лицензирана под MIT, с отворен код, и приветства доклади за грешки и приноси в GitHub.

Заредете OBJ сцена и я експортирайте като glTF

Добавете Maven зависимостта, след което извикайте Scene.fromFile("model.obj"), за да заредите OBJ файла заедно с неговите MTL дефиниции за материали. Едно единствено извикване scene.save() с разширение .gltf записва glTF 2.0 JSON файл, без да е необходим регистър на формати или обект за конвертиране.

<dependency>
  <groupId>com.aspose</groupId>
  <artifactId>aspose-3d-foss</artifactId>
  <version>26.1.0</version>
</dependency>
import com.aspose.threed.*;

// Зареждане на OBJ файл (с .mtl материали)
Scene scene = Scene.fromFile("model.obj");

// Експортиране като glTF 2.0
scene.save("model.gltf");

Конвертирайте STL към glTF с GltfSaveOptions

За да създадете glTF файл с корекции на координатната система, предайте инстанция на GltfSaveOptions с setFlipCoordinateSystem(true). Същият модел се прилага за всички опции за конкретен формат — заменете класа с опции с този, който съответства на целевия формат.

import com.aspose.threed.*;

Scene scene = new Scene();
scene.open("mesh.stl");

// Запазване като glTF с опции
GltfSaveOptions opts = new GltfSaveOptions();
opts.setFlipCoordinateSystem(true);
opts.setPrettyPrint(true);
scene.save("mesh.gltf", opts);

Frequently Asked Questions

Какво е Aspose.3D FOSS за Java?

Това е безплатна библиотека под лиценз MIT, чисто-Java, за зареждане, манипулиране и запазване на 3D сцени без инсталиране на нативно изпълнение или външен SDK.

Кои 3D формати се поддържат?

OBJ (с .mtl), STL (бинарен и ASCII), glTF 2.0, GLB (бинарен glTF) и FBX (само импорт). Всеки формат има специален клас за опции за зареждане/запис.

Изисква ли някакви нативни зависимости?

Не. Aspose.3D FOSS за Java е чисто Java без нативни разширения. Работи на Windows, macOS и Linux без каквато и да е стъпка на компилация.

Как да го инсталирам?

Добавете Maven зависимостта com.aspose:aspose-3d-foss:26.1.0 към вашия проект. Не са необходими допълнителни системни пакети или нативни разширения.

Мога ли да контролирам ориентацията на координатната система?

Да. Класовете за опции за всеки формат ви позволяват да обръщате осите, регулирате мащаба и нормализирате нормалите без да пишете код за парсиране, специфичен за формата.

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

Java 21 и по-нови се поддържат. Библиотеката работи идентично на всички основни операционни системи.

Достъпен ли е изходният код?

Да. Библиотеката е лицензирана под MIT и е хоствана в GitHub. Съобщения за грешки и pull requests са добре дошли.

  

Ресурси за поддръжка и обучение

 Български