Riferimento API per Aspose.3D 26.1.0 (.NET 10.0+, MIT license).
Tutte le classi risiedono nel Aspose.ThreeD namespace radice. La direttiva using radice è:
Convenzione di denominazione C#: Tutte le proprietà utilizzano la sintassi standard delle proprietà C#. Per esempio, usa scene.RootNode invece di scene.getRootNode(), e transform.Translation = ... invece di transform.setTranslation(...).
Casing dei campi vettoriali: La libreria dispone di due serie di tipi vettoriali. Aspose.ThreeD.Utilities.Vector2/3/4 (usato da Mesh.ControlPoints, geometria e la maggior parte delle operazioni matematiche) sono a doppia precisione con minuscolo campi pubblici (v.x, v.y, v.z, v.w). Il più semplice Aspose.ThreeD.Vector2/3/4 struct (in Vector.cs) sono single-precision (float) con maiuscolo campi pubblici (v.X, v.Y, v.Z). FVector2/3/4 e Quaternion e Matrix4 usa l’accesso ai campi in maiuscolo. Usa Aspose.ThreeD.Utilities tipi per il lavoro di geometria.
Grafico della scena principale
| Methods | Methods |
|---|
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 Open() e Save() come i punti di ingresso I/O principali. |
Node | Un nodo nominato nella gerarchia della scena. Possiede un elenco di nodi figli e un elenco di allegati Entity oggetti come mesh, telecamere e luci. Possiede un locale Transform. |
Entity | Classe base astratta per tutti gli oggetti che possono essere allegati a un Node. Fornisce nome e identità ma nessuna geometria propria. |
SceneObject | Classe base condivisa da Node e Entity. Fornisce l’interfaccia di raccolta delle proprietà usata per i metadati definiti dall’utente. |
A3DObject | Classe base radice per tutti gli oggetti gestiti Aspose.3D. Espone il Name proprietà e il Properties collezione. |
INamedObject | Interfaccia che garantisce una Name proprietà. Implementata da Node, Entity, e diversi tipi di descrittori specifici per formato. |
Geometria e Mesh
| Methods | Methods |
|---|
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 layer di elementi dei vertici (normali, UV, 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 layer. Mesh eredita da Geometry. |
VertexElement | Base astratta per un layer di dati collegato alla geometria (normali, UV, colori, ecc.). Contiene MappingMode, ReferenceMode, e una lista di dati. |
VertexElementNormal | Memorizza un vettore normale per vertice o per angolo del poligono, a seconda della modalità di mappatura. |
VertexElementUV | Memorizza coppie di coordinate di texture (Vector2) per vertice o per angolo del poligono. |
VertexElementVertexColor | Memorizza dati di colore RGBA per vertice o per angolo come Vector4. |
Primitive integrate
| Methods | Methods |
|---|
Box | Scatola parametrica allineata agli assi con larghezza, altezza e profondità configurabili. Può essere collegata a una Node direttamente o convertita in Mesh tramite ToMesh(). |
Sphere | Sfera parametrica con raggio configurabile. Supporta ToMesh() conversione. |
Cylinder | Cilindro parametrico con raggio superiore, raggio inferiore e altezza configurabili. Supporta ToMesh() conversione. |
Trasformazione e Spatial
| Methods | Methods |
|---|
Transform | Trasformazione locale collegata a un Node. Fornisce Translation (FVector3), Rotation (Quaternion), Scale (FVector3), e Matrix proprietà (Matrix4). |
GlobalTransform | Vista di sola lettura della matrice di trasformazione nello spazio mondiale di un nodo dopo aver composto tutte le trasformazioni dei genitori. Accessibile tramite node.GlobalTransform. Espone un unico Matrix proprietà. |
AssetInfo | Blocco di metadati collegato a un Scene. Eredita da A3DObject fornendo Name e Properties. Nessuna proprietà aggiuntiva è definita in questa edizione. |
Materiali e Shading
| Methods | Methods |
|---|
Material | Classe base astratta per tutti i tipi di materiale. Fornisce un nome e una raccolta di proprietà. |
LambertMaterial | Materiale classico solo diffuso con Ambient, Diffuse, Emissive, Reflective, Transparency, e Texture proprietà. Namespace: Aspose.ThreeD.Shading. |
PhongMaterial | Estende Lambert con Specular, Shininess, e SpecularPower proprietà. Namespace: Aspose.ThreeD.Shading. |
PbrMaterial | Materiale Physically Based Rendering con BaseColor, Metallic, Roughness, Occlusion, e proprietà dello slot di texture. Namespace: Aspose.ThreeD.Shading. |
Methods
| Methods | Methods |
|---|
Camera | Entità fotocamera. Eredita da Frustum. Collegato a un Node per definire le trasformazioni del punto di vista. Nessuna proprietà specifica del formato è esposta in questa edizione. |
Utilità matematiche
| Methods | Methods |
|---|
Vector2 | Doppia precisione 2-component vector (lowercase fields: x, y). Namespace: Aspose.ThreeD.Utilities. Utilizzato per coordinate di texture UV. |
Vector3 | Doppia precisione 3-component vector (lowercase fields: x, y, z). Namespace: Aspose.ThreeD.Utilities. Vettore spaziale di uso generale per la geometria. |
Vector4 | Doppia precisione 4-component vector (lowercase fields: x, y, z, w). Namespace: Aspose.ThreeD.Utilities. Utilizzato per Mesh.ControlPoints e dati delle normali. |
FVector3 | Vettore float a 3 componenti a precisione singola (campi in maiuscolo: X, Y, Z). Utilizzato da Transform.Translation e Transform.Scale. |
FVector4 | Vettore float a 4 componenti a precisione singola (campi in maiuscolo: X, Y, Z, W). |
Quaternion | Quaternione unitario per rappresentare rotazioni (W, X, Y, Z). Utilizzato da Transform.Rotation. |
Matrix4 | 4x4 transformation matrix. Used for world/local transform computations and by GlobalTransform.Matrix. |
BoundingBox | Bounding box allineata agli assi definita da Minimum e Maximum FVector3 angoli. |
Methods
| Methods | Methods |
|---|
AnimationClip | Contenitore nominato per un intervallo di animazione. Un Scene può contenere più clip. Bozza di dichiarazione — i dati dei fotogrammi chiave e la riproduzione non sono ancora implementati. |
I/O del formato
| Methods | Methods |
|---|
Scene.Open(path) | Apre un file, rileva il formato dall’estensione e popola la scena. |
Scene.Open(path, options) | Apre un file con specifiche di formato LoadOptions. |
Scene.Open(stream) | Apre da uno stream, rilevando automaticamente il formato dal contenuto. |
Scene.Open(stream, options) | Apre da uno stream con specifiche di formato LoadOptions. |
Scene.Save(path) | Salva la scena in un file; formato dedotto dall’estensione. |
Scene.Save(path, options) | Salva con specifiche di formato SaveOptions. |
Scene.Save(stream, options) | Salva su uno stream con specifiche di formato SaveOptions. |
FileFormat | Registro dei formati di file supportati. Usa FileFormat.Formats (un IList<FileFormat>) per elencare tutti i formati supportati, o FileFormat.Detect(fileName) per rilevare un formato dal nome del file. Le costanti nominate (ObjFormat, GltfFormat, FbxFormat, ecc.) sono internal e non accessibili dal codice utente. |
IOService | Astrazione I/O interna. Fornisce DetectFormat() per il rilevamento di formati basato su stream. |
LoadOptions | Classe base per le opzioni di caricamento specifiche per formato. |
SaveOptions | Classe base per le opzioni di salvataggio specifiche per formato. |
Formato OBJ
Formato STL
Formato glTF
| Methods | Methods |
|---|
GltfLoadOptions | Opzioni di caricamento per file glTF 2.0 e GLB. |
GltfSaveOptions | Opzioni di salvataggio per l’output glTF 2.0 e GLB. Nessuna proprietà specifica del formato è esposta in questa edizione; usa .glb estensione per l’output binario. |
Formato FBX
| Methods | Methods |
|---|
FbxLoadOptions | Opzioni di caricamento per file FBX. |
FbxSaveOptions | Opzioni di salvataggio per l’output FBX. L’esportazione FBX produce sempre output binario; l’esportazione FBX ASCII non è attiva in questa versione. |
3MF Format
Methods
| Methods | Methods |
|---|
FileContentType | Descrittore del tipo di contenuto: ASCII, Binary. Disponibile come proprietà su FileFormat. |
Axis | Identifica un asse di coordinate: XAxis, YAxis, ZAxis. |
CoordinateSystem | Specifica la convenzione di orientamento: RightHand oppure LeftHand. |
Sistema delle proprietà
| Methods | Methods |
|---|
Property | Una singola proprietà tipizzata nominata su un A3DObject. |
PropertyCollection | Collezione iterabile di Property oggetti collegati a un A3DObject. |
Vedi anche
