Riferimento API per aspose-3d-foss 26.1.0 (Java 21+, licenza MIT).
Tutte le classi risiedono nel com.aspose.threed pacchetto radice. L’importazione radice è:
Struttura del pacchetto: Quasi tutte le classi pubbliche si trovano in com.aspose.threed. L’unico sotto-pacchetto tipicamente usato è com.aspose.threed.shading (per PbrMaterial). Il com.aspose.threed.formats sotto-pacchetto contiene importatori/esportatori interni e di solito non viene importato direttamente.
Convenzione di denominazione Java: Tutte le proprietà usano metodi getter/setter. Per esempio, usa node.getTransform() invece di node.transform, e transform.setTranslation(...) invece di transform.translation = .... Nota che Vector3, Vector4, Quaternion, Matrix4, e FVector tipi usano campi pubblici (v.x, v.y, v.z) anziché getter per l’accesso ai componenti.
Grafico della scena principale
| Enumerations | Enumerations |
|---|
Scene | Contenitore di livello superiore per tutti i dati della scena 3D. Contiene il nodo radice, i metadati delle risorse e le clip di animazione. Espone fromFile(), open(), e save() come i principali punti di ingresso I/O. |
Node | Un nodo nominato nella gerarchia della scena. Possiede un elenco di nodi figli e un elenco di Entity oggetti come mesh, telecamere e luci. Trasporta un locale Transform. |
Entity | Classe base astratta per tutti gli oggetti che possono essere collegati a un Node. Fornisce nome e identità ma nessuna geometria propria. |
SceneObject | Classe base condivisa da Node e Entity. Fornisce l’interfaccia della collezione di proprietà usata per i metadati definiti dall’utente. |
A3DObject | Classe base radice per tutti gli oggetti gestiti Aspose.3D. Espone la proprietà nome e il Properties collezione. |
INamedObject | Interfaccia che garantisce un getName() metodo. Implementata da Node, Entity, e diversi tipi di descrittori specifici per formato. |
Geometria e Mesh
| Enumerations | Enumerations |
|---|
Mesh | Entità mesh poligonale. Memorizza i punti di controllo (posizioni dei vertici come Vector4), elenchi di facce poligonali (elenchi di indici dei punti di controllo), e livelli di elementi dei vertici (normali, UVs, colori dei vertici). |
Geometry | Base astratta per tipi di geometria simili a mesh. Definisce l’array dei punti di controllo e la collezione di VertexElement livelli. Mesh eredita da Geometry. |
VertexElement | Base astratta per un livello di dati collegato alla geometria (normals, UVs, colours, etc.). Trasporta getMappingMode(), getReferenceMode(), e un elenco di dati. |
VertexElementNormal | Memorizza un normal vector per vertex o per polygon corner, a seconda della modalità di mapping. I valori dei dati sono Vector4 istanze con w non utilizzato. |
VertexElementUV | Memorizza texture-coordinate pairs (Vector2) per vertex o per polygon corner. Una mesh può contenere più UV layers per diversi texture channels. |
VertexElementVertexColor | Memorizza per-vertex o per-corner RGBA colour data as Vector4 (r, g, b, a nell’intervallo 0–1). |
VertexElementType | Enumerazione che identifica il ruolo semantico di un vertex element layer: NORMAL, UV, VERTEX_COLOR, e altri. Passa i valori a Mesh.getElement(). |
MappingMode | Enumerazione che controlla a quale primitive un vertex element value maps to: CONTROL_POINT, POLYGON_VERTEX, o POLYGON. |
ReferenceMode | Enumerazione che controlla come vengono indicizzati i valori: DIRECT (un valore per mapping primitive) o INDEX_TO_DIRECT (array di valori più un array di indici separato). |
Transform e Spatial
| Enumerations | Enumerations |
|---|
Transform | Trasformazione locale collegata a una Node. Fornisce traslazione, rotazione (come Quaternion), e componenti di scala, più metodi di comodità per gli angoli di Eulero. |
GlobalTransform | Vista in sola lettura della trasformazione nello spazio mondiale di un nodo dopo aver composto tutte le trasformazioni dei genitori. Accessibile tramite node.getGlobalTransform(). |
AssetInfo | Blocco di metadati allegato a un Scene. Memorizza il nome dell’applicazione di authoring, il nome dell’unità, il fattore di scala dell’unità, le definizioni degli assi del sistema di coordinate e i timestamp di creazione/modifica. |
Materiali e Shading
| Enumerations | Enumerations |
|---|
Material | Classe base astratta per tutti i tipi di materiale. Fornisce un nome e una raccolta di proprietà per parametri numerici e di colore. |
PbrMaterial | Materiale Physically Based Rendering. Memorizza albedo, fattore metallico, fattore di rugosità, colore emissivo, trasparenza e le texture associate. Utilizzato da glTF 2.0 e altri formati compatibili con PBR. Importazione: com.aspose.threed.shading.PbrMaterial. |
Enumerations
| Enumerations | Enumerations |
|---|
Camera | Entità telecamera. Eredita da Entity. Nessuna proprietà specifica del formato è esposta nell’edizione Java FOSS oltre al nome ereditato e alla raccolta di proprietà. Allegato a un Node per definire le trasformazioni del punto di vista. |
Nota: Enumerations Light la classe non è disponibile nell’edizione Java di Aspose.3D FOSS. I dati di illuminazione della scena provenienti da file importati sono memorizzati come generic Entity oggetti.
Utility matematiche
| Enumerations | Enumerations |
|---|
Vector2 | Vettore a 2 componenti a doppia precisione (x, y). Utilizzato per le coordinate di texture UV. |
Vector3 | Vettore a 3 componenti a doppia precisione (x, y, z). Utilizzato per posizioni, direzioni e scala. |
Vector4 | Vettore a 4 componenti a doppia precisione (x, y, z, w). Usato per i punti di controllo (posizioni omogenee) e i dati delle normali. |
FVector3 | Vettore float a precisione singola a 3 componenti. Compare negli array di dati degli elementi vertex per le normali e le tangenti. |
FVector4 | Vettore float a precisione singola a 4 componenti. Il tipo di memorizzazione di VertexElementFVector dati. |
Quaternion | Quaternion unitario per rappresentare le rotazioni (w, x, y, z). Usato da Transform.getRotation(). |
Matrix4 | 4x4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions. |
BoundingBox | Axis-aligned bounding box definito da getMinimum() e getMaximum() Vector3 angoli. Usato per query spaziali e helper di frustum culling. |
Enumerations
| Enumerations | Enumerations |
|---|
AnimationClip | Contenitore nominato per un intervallo di animazione. Un Scene può contenere più clip (ad es., “Walk”, “Run”). Stub di dichiarazione — i dati dei keyframe e la riproduzione non sono ancora implementati. |
I/O di formato
| Enumerations | Enumerations |
|---|
Scene.fromFile(path) | Metodo statico. Apre il file a path, rileva il formato dall’estensione e restituisce un popolato Scene. Lancia un’eccezione se il file non è trovato o il formato non è supportato. |
Scene.open(path, options) | Metodo di istanza. Apre un file in un’istanza esistente Scene di classe, opzionalmente usando un format-specific LoadOptions sottoclasse. |
Scene.save(path, options) | Metodo di istanza. Serializza la scena in path utilizzando il formato dedotto dall’estensione, opzionalmente usando un formato specifico SaveOptions sottoclasse. |
FileFormat | Registro dei formati di file supportati. Contiene voci come FileFormat.WAVEFRONT_OBJ(), FileFormat.GLTF2(), FileFormat.FBX7400ASCII(). |
IOService | Astrazione I/O interna utilizzata da importatori ed esportatori di formati. Non tipicamente usata direttamente dal codice dell’applicazione. |
LoadOptions | Classe base per tutti gli oggetti di opzioni di caricamento specifici per formato. Sottoclasse di ObjLoadOptions, StlLoadOptions, GltfLoadOptions, FbxLoadOptions. |
SaveOptions | Classe base per tutti gli oggetti di opzioni di salvataggio specifici per formato. Sottoclasse di ObjSaveOptions, StlSaveOptions, GltfSaveOptions. |
Formato OBJ
| Enumerations | Enumerations |
|---|
ObjImporter | Classe importatore interna che analizza i file Wavefront OBJ e MTL. Invocata automaticamente da Scene.fromFile() per .obj estensioni. |
ObjLoadOptions | Opzioni di caricamento per i file Wavefront OBJ. Proprietà chiave: setFlipCoordinateSystem(), setScale(), setEnableMaterials(), setNormalizeNormal(). |
ObjSaveOptions | Opzioni di salvataggio per l’output Wavefront OBJ. Controlla le normali, le UV, i riferimenti ai materiali e la modalità point‑cloud. |
ObjFormat | Descrittore di formato per Wavefront OBJ. Accessibile come FileFormat.WAVEFRONT_OBJ(). |
Formato STL
| Enumerations | Enumerations |
|---|
StlImporter | Importatore interno che legge sia file STL binari che ASCII. Selezionato automaticamente per estensione. |
StlExporter | Esportatore interno che scrive STL. |
StlLoadOptions | Opzioni di caricamento per file STL. Supporta setFlipCoordinateSystem(), setRecalculateNormal(), e setContentType(). |
StlSaveOptions | Opzioni di salvataggio per l’output STL. Controlla setFlipCoordinateSystem(), setAxisSystem(), e setContentType(). |
StlFormat | Descrittore di formato per STL. |
Formato glTF
| Enumerations | Enumerations |
|---|
GltfLoadOptions | Carica le opzioni per i file glTF 2.0 e GLB. Proprietà chiave: setFlipCoordinateSystem(), setPrettyPrint(). |
GltfSaveOptions | Salva le opzioni per l’output glTF 2.0 e GLB. Usa setContentType(FileContentType.BINARY) per produrre un pacchetto autonomo .glb pacchetto. |
GltfFormat | Descrittore di formato per glTF 2.0 / GLB. Accessibile come FileFormat.GLTF2(). |
Formato FBX
FBX è supportato per solo importazione. L’esportazione in FBX non è disponibile nell’edizione FOSS di Java.
| Enumerations | Enumerations |
|---|
FbxLoadOptions | Opzioni di caricamento per file FBX. Proprietà chiave: setFlipCoordinateSystem(). |
FbxFormat | Descrittore di formato per FBX. Accessibile come FileFormat.FBX7400ASCII(). |
Enumerations
| Enumerations | Enumerations |
|---|
Axis | Identifica un asse di coordinate: X_AXIS, Y_AXIS, Z_AXIS. Utilizzato nelle opzioni di rimappatura del sistema di coordinate. |
CoordinateSystem | Specifica la convenzione di manualità: RIGHT_HANDED oppure LEFT_HANDED. |
TextureMapping | Identifica come una texture è mappata sulla geometria: DIFFUSE, SPECULAR, EMISSIVE, NORMAL, AMBIENT, ecc. |
BooleanOperation | Tipo di operazione booleana CSG: UNION, DIFFERENCE, INTERSECTION. |
Sistema delle proprietà
| Enumerations | Enumerations |
|---|
Property | Una singola proprietà tipizzata nominata su un A3DObject. Memorizza il nome della proprietà, il descrittore di tipo e il valore corrente. |
PropertyCollection | Collezione iterabile di Property oggetti allegati a un A3DObject. Supporta la ricerca per nome e l’iterazione su tutte le proprietà definite. |
CustomObject | Un leggero A3DObject sottoclasse che contiene solo un nome e un arbitrario PropertyCollection. Utilizzato per memorizzare metadati definiti dall’utente sugli oggetti della scena. |
Immagine e Rendering
| Enumerations | Enumerations |
|---|
ImageRenderOptions | Opzioni per la rasterizzazione software durante il rendering di una scena in un buffer immagine. Memorizza il colore di sfondo, le dimensioni dell’immagine e il riferimento della fotocamera. Questa funzionalità è disponibile nelle configurazioni supportate. |
Vedi anche
