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

Aspose.3D FOSS for Java

Indlæs, opret, transformer og eksporter 3D-scener fra Java — gratis og open source.

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

Lære GitHub

Open source Java-bibliotek til 3D-filbehandling

Aspose.3D FOSS for Java er et MIT-licenseret, ren-Java bibliotek til at arbejde med 3D-filformater. Tilføj kun én Maven-afhængighed og begynd straks at læse, konstruere og skrive 3D-scener uden at installere nogen native runtime, ekstern SDK eller tredjepartsrenderer.

Biblioteket eksponerer et rent scene‑graph API bygget omkring Scene, Node, Mesh, Camera og Transform, den samme konceptuelle model som bruges af professionelle 3D‑værktøjer. Formatunderstøttelse omfatter OBJ (med .mtl-materialelæsning), STL (binær og ASCII, round‑trip verificeret), glTF 2.0 (PBR-materialer), GLB (binær glTF) og FBX (kun import). Per‑format indlæsnings‑ og gemme‑indstillinger giver dig mulighed for at styre koordinat‑spejling, skalering, normalisering af normaler og materialelæsning uden at skrive format‑specifik parsingskode.

Aspose.3D FOSS kræver Java 21 eller nyere og kører identisk på Windows, macOS og Linux CI‑runners, Docker‑containere og serverløse miljøer. Der er ingen native udvidelse at kompilere og ingen systempakke at installere.

3D-formatunderstøttelse og Scene-Graph API

  • OBJ / MTL: Indlæs Wavefront OBJ‑filer med tilhørende materialdefinitioner.
  • STL: Læs og skriv både binær og ASCII STL med fuld round‑trip verifikation.
  • glTF 2.0 / GLB: PBR-materialelæsning og eksport via GltfSaveOptions. Brug setContentType(FileContentType.BINARY) for GLB‑output.
  • FBX: Importunderstøttelse til indlæsning af FBX‑filer (eksport er ikke tilgængelig).
  • Scene‑graph API: Scene, Node, Mesh, Camera, Transform.

Hvor Aspose.3D FOSS kan bruges

  • Asset‑validerings‑pipelines: Verificér, re‑orientér og re‑eksporter 3D‑assets i CI.
  • Game development tooling: Batch‑processér OBJ‑ og STL‑meshes uden en native engine.
  • 3D‑print‑arbejdsgange: Læs, validér og re‑eksporter STL‑filer.
  • Web backends: Betjen 3D‑konverteringsendepunkter i Docker eller serverløse funktioner.
  • Indholdsmigrering: Konverter mellem formatfamilier i stor skala.

Indstillinger pr. format og koordinatkontrol

  • Koordinatsystemorientering: Vend akser og justér skala pr. format uden brugerdefineret kode.
  • Normalnormalisering: Normaliser automatisk vertexnormale ved indlæsning eller gemning.
  • Kontrol af materialelæsning: Aktiver eller deaktiver MTL-/teksturlæsning for hurtigere parsing.
  • Pretty-print output: Vælg kompakt eller menneskelig læsbar glTF JSON via indstillinger.
  • Round-trip fidelity: Ukendte scene‑graph‑noder bevares ordret ved gen‑gemning.

Udvikleroplevelse

Aspose.3D FOSS for Java installationer med en enkelt Maven-afhængighed (com.aspose:aspose-3d-foss:26.1.0). Biblioteket er ren Java, uden native extensions at kompilere og uden systempakker at installere.

Scene‑graph API’en spejler den konceptuelle model i professionelle 3D‑værktøjer, så indlæringskurven er kort for alle, der er bekendt med Three.js eller Blenders datamodel. Biblioteket er MIT‑licenseret, open‑source, og byder velkommen til fejlrapporter og bidrag på GitHub.

Indlæs en OBJ-scene og eksporter som glTF

Tilføj Maven‑afhængigheden, og kald derefter Scene.fromFile("model.obj") for at indlæse OBJ‑filen sammen med dens MTL‑materialdefinitioner. Et enkelt scene.save()‑kald med en .gltf‑udvidelse skriver en glTF 2.0 JSON‑fil, uden at der er brug for et formatregister eller konverteringsobjekt.

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

import com.aspose.threed.*;

// Indlæs en OBJ-fil (med .mtl-materialer)
Scene scene = Scene.fromFile("model.obj");

// Eksporter som glTF 2.0
scene.save("model.gltf");

Konverter STL til glTF med GltfSaveOptions

For at producere en glTF-fil med justeringer af koordinatsystemet, skal du videregive en GltfSaveOptions-instans med setFlipCoordinateSystem(true). Det samme mønster gælder for alle per-format-indstillinger — udskift options-klassen med den, der svarer til det format, du har som mål.

import com.aspose.threed.*;

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

// Gem som glTF med indstillinger
GltfSaveOptions opts = new GltfSaveOptions();
opts.setFlipCoordinateSystem(true);
opts.setPrettyPrint(true);
scene.save("mesh.gltf", opts);

Frequently Asked Questions

Hvad er Aspose.3D FOSS for Java?

Det er et gratis, MIT-licenseret pure-Java-bibliotek til indlæsning, manipulation og gemning af 3D-scener uden at installere nogen native runtime eller ekstern SDK.

Hvilke 3D-formater understøttes?

OBJ (med .mtl), STL (binær og ASCII), glTF 2.0, GLB (binær glTF) og FBX (kun import). Hvert format har en dedikeret indlæsnings-/gemningsindstillingsklasse.

Kræver det nogen native afhængigheder?

Nej. Aspose.3D FOSS for Java er ren Java uden native-udvidelser. Det kører på Windows, macOS og Linux uden nogen kompileringstrin.

Hvordan installerer jeg det?

Tilføj Maven-afhængigheden com.aspose:aspose-3d-foss:26.1.0 til dit projekt. Ingen yderligere systempakker eller native-udvidelser er påkrævet.

Kan jeg kontrollere koordinatsystemets orientering?

Ja. Per-format indstillingsklasser giver dig mulighed for at vende akser, justere skala og normalisere normaler uden at skrive format-specifik parsekode.

Hvilke Java-versioner understøttes?

Java 21 og senere understøttes. Biblioteket kører identisk på alle større operativsystemer.

Er kildekoden tilgængelig?

Ja. Biblioteket er MIT-licenseret og hostet på GitHub. Fejlrapporter og pull requests er velkomne.

  

Support og læringsressourcer

 Dansk