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

Aspose.3D FOSS for Java

Завантажуйте, створюйте, трансформуйте та експортуйте 3D‑сцени з Java — безкоштовно та з відкритим вихідним кодом.

Aspose.3D FOSS for Java Aspose.3D FOSS
for Java

Документація GitHub

Бібліотека Java з відкритим вихідним кодом для обробки 3D‑файлів

Aspose.3D FOSS для Java — це бібліотека під ліцензією MIT, чисто-Java, призначена для роботи з 3D форматами файлів. Додайте одну залежність Maven і одразу починайте читати, конструювати та записувати 3D сцени без встановлення будь‑якого нативного середовища виконання, зовнішнього SDK чи стороннього рендерера.

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

Aspose.3D FOSS вимагає Java 21 або новішої версії і працює однаково на Windows, macOS та Linux CI‑ранерах, Docker‑контейнерах і безсерверних середовищах. Немає нативного розширення для компіляції та жодного системного пакету для встановлення.

Підтримка 3D‑форматів та API графа сцени

  • OBJ / MTL: Завантажуйте файли Wavefront OBJ разом з визначеннями матеріалів.
  • STL: Читайте та записуйте як бінарні, так і ASCII STL з повною верифікацією зворотного проходу.
  • 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 backends: Обслуговуйте 3D‑конвертаційні кінцеві точки в Docker або безсерверних функціях.
  • Content migration: Перетворюйте між сімействами форматів у масштабі.

Параметри для кожного формату та контроль координат

  • Орієнтація системи координат: Перевернути осі та налаштувати масштаб відповідно до формату без кастомного коду.
  • Нормалізація нормалей: Автоматично нормалізувати нормалі вершин під час завантаження або збереження.
  • Керування завантаженням матеріалів: Увімкнути або вимкнути завантаження 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);

Часті Питання

Що таке 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. Повідомлення про помилки та запити на злиття вітаються.

  

Ресурси Підтримки та Навчання

 Українська