API-referanse for aspose-3d-foss 26.1.0 (Java 21+, MIT-lisens).
Alle klasser befinner seg i com.aspose.threed rotpakken. Rotimporten er:
Pakkeoppsett: Nesten alle offentlige klasser er i com.aspose.threed. Det eneste underpakke som vanligvis brukes er com.aspose.threed.shading (for PbrMaterial). Den com.aspose.threed.formats underpakke inneholder interne importører/eksportører og blir vanligvis ikke importert direkte.
Java navnekonvensjon: Alle egenskaper bruker getter/setter‑metoder. For eksempel, bruk node.getTransform() i stedet for node.transform, og transform.setTranslation(...) i stedet for transform.translation = .... Merk at Vector3, Vector4, Quaternion, Matrix4, og FVector typer bruker offentlige felter (v.x, v.y, v.z) i stedet for getters for komponenttilgang.
Kjerne‑scenegraf
| Enumerations | Enumerations |
|---|
Scene | Toppnivåbeholder for alle 3D-scenedata. Inneholder rot-noden, ressursmetadata og animasjonsklipp. Eksponerer fromFile(), open(), og save() som de primære I/O-inngangspunktene. |
Node | En navngitt node i scenehierarkiet. Eier en liste over undernoder og en liste over tilknyttede Entity objekter som mesh, kameraer og lys. Bærer en lokal Transform. |
Entity | Abstrakt basisklasse for alle objekter som kan festes til en Node. Tilbyr navn og identitet, men ingen egen geometri. |
SceneObject | Basisklasse delt av Node og Entity. Tilbyr grensesnittet for egenskapskolleksjon brukt for brukerdefinert metadata. |
A3DObject | Rotbasisklasse for alle Aspose.3D-administrerte objekter. Eksponerer navnegenskapen og den Properties samlingen. |
INamedObject | Grensesnitt som garanterer en getName() metode. Implementert av Node, Entity, og flere formatspesifikke deskriptortyper. |
Geometri og nett
| Enumerations | Enumerations |
|---|
Mesh | Polygon mesh entity. Lagrer kontrollpunkter (vertex positions som Vector4), polygonflistelister (lister over kontrollpunktindekser), og vertex element-lag (normals, UVs, vertex colours). |
Geometry | Abstrakt base for mesh-lignende geometrityper. Definerer control-point array og samlingen av VertexElement lag. Mesh arver fra Geometry. |
VertexElement | Abstrakt base for et datalag festet til geometri (normals, UVs, farger, osv.). Bærer getMappingMode(), getReferenceMode(), og en dataliste. |
VertexElementNormal | Lagrer én normalvektor per vertex eller per polygonhjørne, avhengig av kartleggingsmodus. Dataverdier er Vector4 instanser med w ubrukt. |
VertexElementUV | Lagrer teksturkoordinatpar (Vector2) per vertex eller per polygonhjørne. Et mesh kan ha flere UV-lag for ulike teksturkanaler. |
VertexElementVertexColor | Lagrer per-vertex eller per-hjørne RGBA-fargedata som Vector4 (r, g, b, a i området 0–1). |
VertexElementType | Enumering som identifiserer den semantiske rollen til et vertex-elementlag: NORMAL, UV, VERTEX_COLOR, og andre. Send verdier til Mesh.getElement(). |
MappingMode | Enumering som styrer hvilken primitive en vertex-elementverdi kartlegger til: CONTROL_POINT, POLYGON_VERTEX, eller POLYGON. |
ReferenceMode | Enumering som styrer hvordan verdier indekseres: DIRECT (én verdi per kartleggingsprimitive) eller INDEX_TO_DIRECT (verdier-array pluss en separat indeks-array). |
Transformasjon og romlig
| Enumerations | Enumerations |
|---|
Transform | Lokal transformasjon festet til en Node. Gir translasjon, rotasjon (som Quaternion), og skaleringskomponenter, pluss praktiske metoder for Euler‑vinkler. |
GlobalTransform | Skrivebeskyttet visning av en nodes verdensromtransformasjon etter å ha komponert alle foreldertransformasjoner. Tilgjengelig via node.getGlobalTransform(). |
AssetInfo | Metadatablokk festet til en Scene. Lagrer navnet på forfatterprogrammet, enhetsnavn, enhetens skaleringsfaktor, definisjoner av koordinatsystemets akser, og tidsstempler for opprettelse/modifisering. |
Materialer og skyggelegging
| Enumerations | Enumerations |
|---|
Material | Abstrakt basisklasse for alle materialtyper. Tilbyr et navn og en egenskapskoleksjon for numeriske og fargeparametere. |
PbrMaterial | Fysisk basert rendering-materiale. Lagrer albedo, metallisk faktor, ruhetsfaktor, emissiv farge, transparens og tilknyttede teksturer. Brukes av glTF 2.0 og andre PBR-kompatible formater. Import: com.aspose.threed.shading.PbrMaterial. |
Enumerations
| Enumerations | Enumerations |
|---|
Camera | Kameraenhet. Arver fra Entity. Ingen formatspesifikke egenskaper er eksponert i Java FOSS-utgaven utover det arvede navnet og egenskapskoleksjonen. Festet til en Node for å definere synspunkttransformasjoner. |
Merk: Enumerations Light klassen er ikke tilgjengelig i Java-utgaven av Aspose.3D FOSS. Scenebelysningsdata fra importerte filer lagres som generisk Entity objekter.
Matematikk‑verktøy
| Enumerations | Enumerations |
|---|
Vector2 | Dobbeltpresisjon 2-komponent vektor (x, y). Brukes for UV-teksturkoordinater. |
Vector3 | Dobbeltpresisjon 3-komponent vektor (x, y, z). Brukes for posisjoner, retninger og skala. |
Vector4 | Dobbeltpresisjon 4-komponent vektor (x, y, z, w). Brukes for kontrollpunkter (homogene posisjoner) og normaldata. |
FVector3 | Enkelpresisjon 3-komponent flyttallsvektor. Forekommer i vertex-element-datamatriser for normaler og tangenter. |
FVector4 | Enkelpresisjon 4-komponent flyttallsvektor. Lagringstypen til VertexElementFVector data. |
Quaternion | Enhetskvaternion for å representere rotasjoner (w, x, y, z). Brukes av Transform.getRotation(). |
Matrix4 | 4x4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions. |
BoundingBox | Aksialt justert avgrensningsboks definert av getMinimum() og getMaximum() Vector3 hjørner. Brukes til romlige spørringer og hjelpemidler for frustum-skjuling. |
Enumerations
| Enumerations | Enumerations |
|---|
AnimationClip | Navngitt beholder for et animasjonsområde. En Scene kan inneholde flere klipp (f.eks. “Walk”, “Run”). Deklarasjonsstubb — nøkkelrammedata og avspilling er ennå ikke implementert. |
Format I/U
| Enumerations | Enumerations |
|---|
Scene.fromFile(path) | Statisk metode. Åpner filen på path, oppdager formatet fra filendelsen, og returnerer en fylt Scene. Kaster unntak ved fil‑ikke‑funnet eller ikke‑støttet format. |
Scene.open(path, options) | Instansmetode. Åpner en fil inn i en eksisterende Scene instans, eventuelt ved bruk av et formatspesifikt LoadOptions subklasse. |
Scene.save(path, options) | Instansmetode. Serialiserer scenen til path ved å bruke formatet som er utledet fra filendelsen, eventuelt ved å bruke et formatspesifikt SaveOptions subklasse. |
FileFormat | Register over støttede filformater. Inneholder oppføringer som FileFormat.WAVEFRONT_OBJ(), FileFormat.GLTF2(), FileFormat.FBX7400ASCII(). |
IOService | Intern I/O-abstraksjon brukt av formatimportører og -eksportører. Vanligvis ikke brukt direkte av applikasjonskode. |
LoadOptions | Basisklasse for alle formatspesifikke lastingsalternativ-objekter. Subklasset av ObjLoadOptions, StlLoadOptions, GltfLoadOptions, FbxLoadOptions. |
SaveOptions | Basisklasse for alle formatspesifikke lagringsalternativ-objekter. Subklasset av ObjSaveOptions, StlSaveOptions, GltfSaveOptions. |
OBJ‑format
| Enumerations | Enumerations |
|---|
ObjImporter | Intern importørklasse som parser Wavefront OBJ- og MTL-filer. Kalles automatisk av Scene.fromFile() for .obj filendelser. |
ObjLoadOptions | Lastingsalternativer for Wavefront OBJ-filer. Viktige egenskaper: setFlipCoordinateSystem(), setScale(), setEnableMaterials(), setNormalizeNormal(). |
ObjSaveOptions | Lagringsalternativer for Wavefront OBJ-utdata. Kontrollerer normaler, UV-er, materialreferanser og punkt-sky-modus. |
ObjFormat | Formatbeskrivelse for Wavefront OBJ. Tilgjengelig som FileFormat.WAVEFRONT_OBJ(). |
STL‑format
| Enumerations | Enumerations |
|---|
StlImporter | Intern importør som leser både binære og ASCII STL-filer. Velges automatisk etter filendelse. |
StlExporter | Intern eksportør som skriver STL. |
StlLoadOptions | Lastingsalternativer for STL-filer. Støtter setFlipCoordinateSystem(), setRecalculateNormal(), og setContentType(). |
StlSaveOptions | Lagringsalternativer for STL-utdata. Kontrollerer setFlipCoordinateSystem(), setAxisSystem(), og setContentType(). |
StlFormat | Formatbeskrivelse for STL. |
glTF‑format
| Enumerations | Enumerations |
|---|
GltfLoadOptions | Last inn alternativer for glTF 2.0- og GLB-filer. Viktige egenskaper: setFlipCoordinateSystem(), setPrettyPrint(). |
GltfSaveOptions | Lagre alternativer for glTF 2.0- og GLB-utdata. Bruk setContentType(FileContentType.BINARY) for å produsere en selvstendig .glb pakke. |
GltfFormat | Formatbeskrivelse for glTF 2.0 / GLB. Tilgjengelig som FileFormat.GLTF2(). |
FBX‑format
FBX støttes for kun import. Eksport til FBX er ikke tilgjengelig i Java FOSS-utgaven.
| Enumerations | Enumerations |
|---|
FbxLoadOptions | Lastalternativer for FBX-filer. Nøkkel‑egenskap: setFlipCoordinateSystem(). |
FbxFormat | Formatbeskrivelse for FBX. Tilgjengelig som FileFormat.FBX7400ASCII(). |
Enumerations
| Enumerations | Enumerations |
|---|
Axis | Identifiserer en koordinataksel: X_AXIS, Y_AXIS, Z_AXIS. Brukes i alternativer for omkartlegging av koordinatsystem. |
CoordinateSystem | Angir håndhetskonvensjon: RIGHT_HANDED eller LEFT_HANDED. |
TextureMapping | Identifiserer hvordan en tekstur er kartlagt til geometri: DIFFUSE, SPECULAR, EMISSIVE, NORMAL, AMBIENT, osv. |
BooleanOperation | CSG boolsk operasjonstype: UNION, DIFFERENCE, INTERSECTION. |
Egenskapssystem
| Enumerations | Enumerations |
|---|
Property | En enkelt navngitt typet egenskap på en A3DObject. Lagrer egenskapsnavnet, typebeskrivelsen og gjeldende verdi. |
PropertyCollection | Itererbar samling av Property objekter knyttet til en A3DObject. Støtter oppslag etter navn og iterasjon over alle definerte egenskaper. |
CustomObject | En lettvektig A3DObject underklasse som kun inneholder et navn og en vilkårlig PropertyCollection. Brukes til å lagre brukerdefinert metadata på scenobjekter. |
Bilde og gjengivelse
| Enumerations | Enumerations |
|---|
ImageRenderOptions | Alternativer for programvare‑rasterisering når en scene rendres til en bildbuffer. Lagrer bakgrunnsfarge, bildedimensjoner og kamerareferanse. Denne funksjonen er tilgjengelig i støttede konfigurasjoner. |
Se også
