Aspose.3D FOSS for Java

API-reference for aspose-3d-foss 26.1.0 (Java 21+, MIT license).

Alle klasser befinder sig i com.aspose.threed rodpakken. Rodimporten er:

import com.aspose.threed.*;

Pakke layout: Næsten alle offentlige klasser er i com.aspose.threed. Det eneste underpakke, der typisk bruges, er com.aspose.threed.shading (for PbrMaterial). Den com.aspose.threed.formats underpakke indeholder interne importører/eksportører og importeres normalt ikke direkte.

Java navnekonvention: Alle egenskaber bruger getter/setter‑metoder. For eksempel, brug node.getTransform() i stedet for node.transform, og transform.setTranslation(...) i stedet for transform.translation = .... Bemærk, at Vector3, Vector4, Quaternion, Matrix4, og FVector typer bruger offentlige felter (v.x, v.y, v.z) i stedet for getters til komponentadgang.

Kerne‑scene‑graf

EnumerationsEnumerations
SceneTop‑niveau container for alle 3D‑scenedata. Indeholder rotnoden, asset‑metadata og animationsklip. Eksponerer fromFile(), open(), og save() som de primære I/O‑indgangspunkt.
NodeEn navngivet node i scenens hierarki. Ejer en liste over under‑noder og en liste over vedhæftede Entity objekter såsom mesh‑net, kameraer og lys. Bærer en lokal Transform.
EntityAbstrakt grundklasse for alle objekter, der kan vedhæftes til en Node. Giver navn og identitet men ingen egen geometri.
SceneObjectGrundklasse delt af Node og Entity.
A3DObjectRod‑grundklasse for alle Aspose.3D‑administrerede objekter. Eksponerer navneegenskaben og den Properties samling.
INamedObjectInterface der garanterer en getName() metode. Implementeret af Node, Entity, og flere format‑specifikke deskriptortyper.

Geometri og Mesh

EnumerationsEnumerations
MeshPolygonnet-entity. Gemmer kontrolpunkter (vertexpositioner som Vector4), polygonfladelister (lister over kontrolpunktindekser), og vertex-elementlag (normals, UVs, vertex colours).
GeometryAbstrakt base for mesh-lignende geometrityper. Definerer kontrolpunktarrayet og samlingen af VertexElement lag. Mesh arver fra Geometry.
VertexElementAbstrakt base for et datalag knyttet til geometri (normals, UVs, farver osv.). Bærer getMappingMode(), getReferenceMode(), og en dataliste.
VertexElementNormalGemmer én normalvektor pr. vertex eller pr. polygonhjørne, afhængigt af kortlægningsmode. Dataværdier er Vector4 instanser med w ubrugt.
VertexElementUVGemmer teksturkoordinatpar (Vector2) pr. vertex eller pr. polygonhjørne. Et mesh kan indeholde flere UV-lag for forskellige teksturkanaler.
VertexElementVertexColorGemmer per-vertex eller per-hjørne RGBA-farvedata som Vector4 (r, g, b, a i intervallet 0–1).
VertexElementTypeEnumeration, der identificerer den semantiske rolle for et vertex-elementlag: NORMAL, UV, VERTEX_COLOR, og andre. Overfør værdier til Mesh.getElement().
MappingModeEnumeration, der styrer hvilken primitive en vertex-elementværdi kortlægges til: CONTROL_POINT, POLYGON_VERTEX, eller POLYGON.
ReferenceModeEnumeration, der styrer hvordan værdier indekseres: DIRECT (én værdi pr. kortlægningsprimitive) eller INDEX_TO_DIRECT (values array plus en separat indices array).

Transform og Spatial

EnumerationsEnumerations
TransformLokal transformation knyttet til en Node. Giver oversættelse, rotation (som Quaternion), og skaleringskomponenter, plus bekvemmelighedsmekanismer for Euler-vinkler.
GlobalTransformSkrivebeskyttet visning af en nodes transformation i verdensrum efter sammensætning af alle forældretransformeringer. Tilgået via node.getGlobalTransform().
AssetInfoMetadata-blok vedhæftet en Scene. Gemmer navnet på forfatterapplikationen, enhedens navn, enhedens skaleringsfaktor, definitioner af koordinatsystemets akser samt oprettelses-/ændringstidspunkter.

Materialer og Shading

EnumerationsEnumerations
MaterialAbstrakt grundklasse for alle materialetyper. Tilbyder et navn og en egenskabssamling for numeriske og farveparametre.
PbrMaterialPhysically Based Rendering-materiale. Gemmer albedo, metallisk faktor, ruhedsfaktor, emissiv farve, gennemsigtighed og tilknyttede teksturer. Bruges af glTF 2.0 og andre PBR-kompatible formater. Import: com.aspose.threed.shading.PbrMaterial.

Enumerations

EnumerationsEnumerations
CameraKameraenhed. Arver fra Entity. Ingen format‑specifikke egenskaber er eksponeret i Java FOSS‑udgaven ud over det arvede navn og egenskabssamlingen. Vedhæftet en Node for at definere synspunktstransformationer.

Bemærk: Enumerations Light klassen er ikke tilgængelig i Java-udgaven af Aspose.3D FOSS. Scene‑belysningsdata fra importerede filer gemmes som generisk Entity objekter.

Matematiske værktøjer

EnumerationsEnumerations
Vector2Dobbeltpræcisions 2-komponents vektor (x, y). Bruges til UV‑teksturkoordinater.
Vector3Dobbeltpræcisions 3-komponents vektor (x, y, z). Bruges til positioner, retninger og skala.
Vector4Dobbeltpræcisions 4-komponents vektor (x, y, z, w). Bruges til kontrolpunkter (homogene positioner) og normaldata.
FVector3Enkeltpræcision 3-komponent float-vektor. Forekommer i vertex-elementdatarrays for normaler og tangenter.
FVector4Enkeltpræcision 4-komponent float-vektor. Lagringstypen for VertexElementFVector data.
QuaternionEnhedsquaternion til at repræsentere rotationer (w, x, y, z). Bruges af Transform.getRotation().
Matrix44x4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions.
BoundingBoxAksialt justeret begrænsningsboks defineret af getMinimum() og getMaximum() Vector3 hjørner. Bruges til rumlige forespørgsler og frustum culling‑hjælper.

Enumerations

EnumerationsEnumerations
AnimationClipNavngivet container for et animationsinterval. En Scene kan indeholde flere klip (f.eks. “Walk”, “Run”). Deklarationsstub — keyframe-data og afspilning er endnu ikke implementeret.

Format I/O

EnumerationsEnumerations
Scene.fromFile(path)Statisk metode. Åbner filen på path, opdager formatet ud fra filendelsen og returnerer en udfyldt Scene. Kaster en fejl ved fil‑ikke‑fundet eller ikke‑understøttet format.
Scene.open(path, options)Instansmetode. Åbner en fil i en eksisterende Scene instans, eventuelt ved brug af en format‑specifik LoadOptions underklasse.
Scene.save(path, options)Instansmetode. Serialiserer scenen til path ved at bruge formatet, som er afledt af filendelsen, eventuelt ved at bruge et format‑specifikt SaveOptions underklasse.
FileFormatRegister over understøttede filformater. Indeholder poster såsom FileFormat.WAVEFRONT_OBJ(), FileFormat.GLTF2(), FileFormat.FBX7400ASCII().
IOServiceIntern I/O-abstraktion brugt af formatimportører og -eksportører. Typisk ikke brugt direkte af applikationskode.
LoadOptionsBasisklasse for alle format‑specifikke indlæsnings‑optionsobjekter. Underklasset af ObjLoadOptions, StlLoadOptions, GltfLoadOptions, FbxLoadOptions.
SaveOptionsBasisklasse for alle format‑specifikke gemme‑optionsobjekter. Underklasset af ObjSaveOptions, StlSaveOptions, GltfSaveOptions.

OBJ-format

EnumerationsEnumerations
ObjImporterIntern importørklasse som parserer Wavefront OBJ- og MTL-filer. Kaldt automatisk af Scene.fromFile() for .obj filendelser.
ObjLoadOptionsIndlæsningsindstillinger for Wavefront OBJ-filer. Nøgleegenskaber: setFlipCoordinateSystem(), setScale(), setEnableMaterials(), setNormalizeNormal().
ObjSaveOptionsGemmeindstillinger for Wavefront OBJ-output. Styrer normaler, UV‑koordinater, materialereferencer og punkt‑sky‑tilstand.
ObjFormatFormatbeskriver for Wavefront OBJ. Tilgængelig som FileFormat.WAVEFRONT_OBJ().

STL-format

EnumerationsEnumerations
StlImporterIntern importør som læser både binære og ASCII STL-filer. Vælges automatisk efter filendelse.
StlExporterIntern eksportør som skriver STL.
StlLoadOptionsIndlæsningsindstillinger for STL-filer. Understøtter setFlipCoordinateSystem(), setRecalculateNormal(), og setContentType().
StlSaveOptionsGemmemuligheder for STL-output. Styrer setFlipCoordinateSystem(), setAxisSystem(), og setContentType().
StlFormatFormatbeskriver for STL.

glTF-format

EnumerationsEnumerations
GltfLoadOptionsIndlæsningsindstillinger for glTF 2.0 og GLB-filer. Nøgleegenskaber: setFlipCoordinateSystem(), setPrettyPrint().
GltfSaveOptionsGemningsindstillinger for glTF 2.0 og GLB-output. Brug setContentType(FileContentType.BINARY) for at producere en selvstændig .glb pakke.
GltfFormatFormatbeskrivelse for glTF 2.0 / GLB. Tilgængelig som FileFormat.GLTF2().

FBX-format

FBX understøttes til kun import. Eksport til FBX er ikke tilgængelig i Java FOSS-udgaven.

EnumerationsEnumerations
FbxLoadOptionsIndlæsningsindstillinger for FBX-filer. Nøgleegenskab: setFlipCoordinateSystem().
FbxFormatFormatbeskrivelse for FBX. Tilgængelig som FileFormat.FBX7400ASCII().

Enumerations

EnumerationsEnumerations
AxisIdentificerer en koordinatakse: X_AXIS, Y_AXIS, Z_AXIS. Bruges i indstillinger for omkortlægning af koordinatsystem.
CoordinateSystemAngiver håndheds‑konvention: RIGHT_HANDED eller LEFT_HANDED.
TextureMappingIdentificerer hvordan en tekstur er kortlagt til geometri: DIFFUSE, SPECULAR, EMISSIVE, NORMAL, AMBIENT, osv.
BooleanOperationCSG Boolean operationstype: UNION, DIFFERENCE, INTERSECTION.

Egenskabssystem

EnumerationsEnumerations
PropertyEn enkelt navngivet typet egenskab på en A3DObject. Gemmer egenskabsnavnet, typebeskrivelsen og den aktuelle værdi.
PropertyCollectionItererbar samling af Property objekter knyttet til en A3DObject. Understøtter opslag efter navn og iteration over alle definerede egenskaber.
CustomObjectEn letvægts A3DObject underklasse, der kun bærer et navn og en vilkårlig PropertyCollection. Bruges til at gemme brugerdefineret metadata på scenens objekter.

Billede og rendering

EnumerationsEnumerations
ImageRenderOptionsIndstillinger for software rasterisation, når en scene renderes til en billedbuffer. Gemmer baggrundsfarve, billeddimensioner og kamerareference. Denne funktion er tilgængelig i understøttede konfigurationer.

Se også

 Dansk