1. Products
  2.   Aspose.3D
  3.   Aspose.3D FOSS for Java

Aspose.3D FOSS pentru Java

Încarcă, creează, transformă și exportă scene 3D din Java — gratuit și open-source.

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

Documentation GitHub

Bibliotecă Java Open-Source pentru procesarea fișierelor 3D

Aspose.3D FOSS pentru Java este o bibliotecă licențiată MIT, pure-Java, pentru lucrul cu formate de fișiere 3D. Adăugați o singură dependență Maven și începeți imediat să citiți, să construiți și să scrieți scene 3D fără a instala niciun runtime nativ, SDK extern sau renderer terț.

Biblioteca expune un API curat de graf de scenă construit în jurul lui Scene, Node, Mesh, Camera și Transform, același model conceptual utilizat de instrumentele 3D profesionale. Suportul pentru formate include OBJ (cu încărcare de materiale .mtl), STL (binare și ASCII, verificat roundtrip), glTF 2.0 (materiale PBR), GLB (glTF binar) și FBX (doar import). Opțiunile de încărcare și salvare per-format vă permit să controlați inversarea coordonatelor, scala, normalizarea normalelor și încărcarea materialelor fără a scrie cod de parsare specific formatului.

Aspose.3D FOSS necesită Java 21 sau o versiune ulterioară și rulează identic pe Windows, macOS și Linux CI runners, containere Docker și medii serverless. Nu există nicio extensie nativă de compilat și niciun pachet de sistem de instalat.

Suport pentru formate 3D și API de graf de scenă

  • OBJ / MTL: Încărcați fișiere Wavefront OBJ cu definițiile de materiale aferente.
  • STL: Citiți și scrieți atât STL binare, cât și ASCII cu verificare completă roundtrip.
  • glTF 2.0 / GLB: Încărcarea materialelor PBR și exportul prin GltfSaveOptions. Utilizați setContentType(FileContentType.BINARY) pentru ieșire GLB.
  • FBX: Suport de import pentru încărcarea fișierelor FBX (exportul nu este disponibil).
  • API graf de scenă: Scene, Node, Mesh, Camera, Transform.

Unde poate fi utilizat Aspose.3D FOSS

  • Pipe-uri de validare a activelor: Verifică, re-orientează și re-exportă activele 3D în CI.
  • Unelte pentru dezvoltarea de jocuri: Procesează în lot mesh-uri OBJ și STL fără un motor nativ.
  • Fluxuri de lucru pentru imprimarea 3D: Citește, validează și re-exportă fișiere STL.
  • Web backends: Serviți puncte finale de conversie 3D în Docker sau funcții serverless.
  • Content migration: Convertiți între familii de formate la scară largă.

Opțiuni per-format și control al coordonatelor

  • Orientarea sistemului de coordonate: Inversează axele și ajustează scara în funcție de format fără cod personalizat.
  • Normalizarea normalelor: Normalizează automat normalele vârfurilor la încărcare sau salvare.
  • Controlul încărcării materialelor: Activează sau dezactivează încărcarea MTL/texturilor pentru o parsare mai rapidă.
  • Ieșire formatată frumos: Alege JSON glTF compact sau ușor de citit prin opțiuni.
  • Fidelitatea round-trip: Nodurile necunoscute ale graficului de scenă sunt păstrate exact la re-salvare.

Experiența dezvoltatorului

Aspose.3D FOSS pentru instalări Java cu o singură dependență Maven (com.aspose:aspose-3d-foss:26.1.0). Biblioteca este pur Java, fără extensii native de compilat și fără pachete de sistem de instalat.

API-ul scene-graph reflectă modelul conceptual al instrumentelor 3D profesionale, astfel încât curba de învățare este scurtă pentru oricine este familiar cu modelul de date al Three.js sau al Blender. Biblioteca este licențiată sub MIT, open-source, și primește cu bucurie rapoarte de bug-uri și contribuții pe GitHub.

Încarcă o scenă OBJ și exportă ca glTF

Adăugați dependența Maven, apoi apelați Scene.fromFile("model.obj") pentru a încărca fișierul OBJ împreună cu definițiile sale de material MTL. Un singur apel scene.save() cu extensia .gltf scrie un fișier JSON glTF 2.0, fără a fi nevoie de un registru de formate sau de un obiect convertor.

<dependency>
  <groupId>com.aspose</groupId>
  <artifactId>aspose-3d-foss</artifactId>
  <version>26.1.0</version>
</dependency>

import com.aspose.threed.*;

// Încarcă un fișier OBJ (cu materiale .mtl)
Scene scene = Scene.fromFile("model.obj");

// Exportă ca glTF 2.0
scene.save("model.gltf");

Convertește STL în glTF cu GltfSaveOptions

Pentru a produce un fișier glTF cu ajustări ale sistemului de coordonate, transmiteți o instanță GltfSaveOptions cu setFlipCoordinateSystem(true). Același model se aplică tuturor opțiunilor per-format — înlocuiți clasa de opțiuni cu cea a formatului vizat.

import com.aspose.threed.*;

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

// Salvează ca glTF cu opțiuni
GltfSaveOptions opts = new GltfSaveOptions();
opts.setFlipCoordinateSystem(true);
opts.setPrettyPrint(true);
scene.save("mesh.gltf", opts);

Frequently Asked Questions

Ce este Aspose.3D FOSS pentru Java?

Este o bibliotecă gratuită, licențiată MIT, pure-Java, pentru încărcarea, manipularea și salvarea scenelor 3D fără a instala niciun runtime nativ sau SDK extern.

Ce formate 3D sunt suportate?

OBJ (cu .mtl), STL (binare și ASCII), glTF 2.0, GLB (glTF binar) și FBX (doar import). Fiecare format are o clasă dedicată de opțiuni de încărcare/salvare.

Necesită dependențe native?

Nu. Aspose.3D FOSS pentru Java este pure Java fără extensii native. Rulează pe Windows, macOS și Linux fără niciun pas de compilare.

Cum îl instalez?

Adăugați dependența Maven com.aspose:aspose-3d-foss:26.1.0 în proiectul dumneavoastră. Nu sunt necesare pachete de sistem suplimentare sau extensii native.

Pot controla orientarea sistemului de coordonate?

Da. Clasele de opțiuni per-format vă permit să inversați axele, să ajustați scala și să normalizați normele fără a scrie cod de parsare specific fiecărui format.

Care versiuni ale Java sunt suportate?

Java 21 și versiunile ulterioare sunt suportate. Biblioteca rulează identic pe toate sistemele de operare majore.

Este codul sursă disponibil?

Da. Biblioteca este licențiată sub MIT și găzduită pe GitHub. Raportările de erori și cererile de pull sunt binevenite.

  

Support and Learning Resources

 Română