Referència de l’API per a Aspose.3D 26.1.0 (.NET 10.0+, MIT license).
Totes les classes resideixen al Aspose.ThreeD espai de noms arrel. La directiva using arrel és:
Convenció de nomenclatura de C#: Totes les propietats utilitzen la sintaxi estàndard de propietats de C#. Per exemple, utilitzeu scene.RootNode en lloc de scene.getRootNode(), i transform.Translation = ... en lloc de transform.setTranslation(...).
Capitalització de camps vectorials: La biblioteca té dos conjunts de tipus de vectors. Aspose.ThreeD.Utilities.Vector2/3/4 (utilitzat per Mesh.ControlPoints, geometria i la majoria d’operacions matemàtiques) són doble precisió amb minúscules camps públics (v.x, v.y, v.z, v.w). Els més simples Aspose.ThreeD.Vector2/3/4 estructures (a Vector.cs) són precisió simple (float) amb majúscules camps públics (v.X, v.Y, v.Z). FVector2/3/4 i Quaternion i Matrix4 utilitza accés a camps en majúscules. Utilitza Aspose.ThreeD.Utilities tipus per a treballs de geometria.
Graf de l’Escena Central
| Methods | Methods |
|---|
Scene | Contenidor de nivell superior per a totes les dades d’escena 3D. Conté el node arrel, les metadades dels actius i els clips d’animació. Exposa Open() i Save() com els punts d’entrada principals d’E/S. |
Node | Un node anomenat a la jerarquia de l’escena. Posseeix una llista de nodes fills i una llista d’elements adjunts Entity objectes com meshes, càmeres i llums. Porta un local Transform. |
Entity | Classe base abstracta per a tots els objectes que es poden adjuntar a un Node. Proporciona nom i identitat però cap geometria pròpia. |
SceneObject | Classe base compartida per Node i Entity. Proporciona la interfície de col·lecció de propietats utilitzada per a metadades definides per l’usuari. |
A3DObject | Classe base arrel per a tots els objectes gestionats Aspose.3D. Exposa el Name propietat i el Properties col·lecció. |
INamedObject | Interfície que garanteix una Name propietat. Implementada per Node, Entity, i diversos tipus de descriptor específics del format. |
Geometria i Malla
| Methods | Methods |
|---|
Mesh | Entitat de malla de polígons. Emmagatzema punts de control (posicions dels vèrtexs com a Vector4), llistes de cares de polígons (llistes d’índexs de punts de control) i capes d’elements de vèrtex (normals, UVs, colours de vèrtex). |
Geometry | Base abstracta per a tipus de geometria semblants a malles. Defineix la matriu de punts de control i la col·lecció de VertexElement capes. Mesh hereta de Geometry. |
VertexElement | Base abstracta per a una capa de dades adjunta a la geometria (normals, UVs, colours, etc.). Conté MappingMode, ReferenceMode, i una llista de dades. |
VertexElementNormal | Emmagatzema un vector normal per vèrtex o per cantonada de polígon, segons el mode de mapatge. |
VertexElementUV | Emmagatzema parelles de coordenades de textura (Vector2) per vèrtex o per cantonada de polígon. |
VertexElementVertexColor | Emmagatzema dades de color RGBA per vèrtex o per cantonada com a Vector4. |
Primitius Integrats
| Methods | Methods |
|---|
Box | Caixa paramètrica alineada amb els eixos amb amplada, alçada i profunditat configurables. Es pot adjuntar a una Node directament o convertida a Mesh via ToMesh(). |
Sphere | Esfera paramètrica amb radi configurable. Admet ToMesh() conversió. |
Cylinder | Cilindre paramètric amb radi superior, radi inferior i alçada configurables. Admet ToMesh() conversió. |
Transformació i Espacial
| Methods | Methods |
|---|
Transform | Transformació local adjunta a una Node. Proporciona Translation (FVector3), Rotation (Quaternion), Scale (FVector3), i Matrix (Matrix4) propietats. |
GlobalTransform | Vista de només lectura de la matriu de transformació en espai mundial d’un node després de composar totes les transformacions dels avantpassats. Accedit via node.GlobalTransform. Exposa una única Matrix propietat. |
AssetInfo | Bloc de metadades adjunt a un Scene. Hereta de A3DObject que proporciona Name i Properties. No s’han definit propietats addicionals en aquesta edició. |
Materials i Ombrejat
| Methods | Methods |
|---|
Material | Classe base abstracta per a tots els tipus de material. Proporciona un nom i una col·lecció de propietats. |
LambertMaterial | Material clàssic només difús amb Ambient, Diffuse, Emissive, Reflective, Transparency, i Texture propietats. Espai de noms: Aspose.ThreeD.Shading. |
PhongMaterial | Amplia Lambert amb Specular, Shininess, i SpecularPower propietats. Espai de noms: Aspose.ThreeD.Shading. |
PbrMaterial | Material de renderitzat basat en la física amb BaseColor, Metallic, Roughness, Occlusion, i propietats de ranura de textura. Espai de noms: Aspose.ThreeD.Shading. |
Methods
| Methods | Methods |
|---|
Camera | Entitat de càmera. Hereta de Frustum. Adjunta a una Node per definir transformacions del punt de vista. No s’exposen propietats específiques del format en aquesta edició. |
Utilitats Matemàtiques
| Methods | Methods |
|---|
Vector2 | Doble precisió 2-component vector (lowercase fields: x, y). Espai de noms: Aspose.ThreeD.Utilities. Utilitzat per a coordenades de textura UV. |
Vector3 | Doble precisió 3-component vector (lowercase fields: x, y, z). Espai de noms: Aspose.ThreeD.Utilities. Vector espacial d’ús general per a geometria. |
Vector4 | Doble precisió 4-component vector (lowercase fields: x, y, z, w). Espai de noms: Aspose.ThreeD.Utilities. Utilitzat per a Mesh.ControlPoints i dades normals. |
FVector3 | Vector de coma flotant de precisió simple de 3 components (camps en majúscules: X, Y, Z). Utilitzat per Transform.Translation i Transform.Scale. |
FVector4 | Vector de coma flotant de precisió simple de 4 components (camps en majúscules: X, Y, Z, W). |
Quaternion | Quaternió unitari per representar rotacions (W, X, Y, Z). Utilitzat per Transform.Rotation. |
Matrix4 | 4x4 transformation matrix. Used for world/local transform computations and by GlobalTransform.Matrix. |
BoundingBox | Caixa delimitadora alineada amb els eixos definida per Minimum i Maximum FVector3 cantonades. |
Methods
| Methods | Methods |
|---|
AnimationClip | Contenidor anomenat per a un interval d’animació. Un Scene pot contenir diversos clips. Esbós de declaració — les dades de fotograma clau i la reproducció encara no estan implementades. |
E/S de Formats
| Methods | Methods |
|---|
Scene.Open(path) | Obre un fitxer, detecta el format a partir de l’extensió i omple l’escena. |
Scene.Open(path, options) | Obre un fitxer amb format específic LoadOptions. |
Scene.Open(stream) | Obre des d’un flux, detectant automàticament el format a partir del contingut. |
Scene.Open(stream, options) | Obre des d’un flux amb format específic LoadOptions. |
Scene.Save(path) | Desa l’escena a un fitxer; el format s’infereix de l’extensió. |
Scene.Save(path, options) | Desa amb format específic SaveOptions. |
Scene.Save(stream, options) | Desa a un flux amb format específic SaveOptions. |
FileFormat | Registre de formats de fitxer compatibles. Utilitzeu FileFormat.Formats (un IList<FileFormat>) per enumerar tots els formats compatibles, o FileFormat.Detect(fileName) per detectar un format per nom de fitxer. Les constants anomenades (ObjFormat, GltfFormat, FbxFormat, etc.) són internal i no són accessibles des del codi d’usuari. |
IOService | Abstracció interna d’E/S. Proporciona DetectFormat() per a la detecció de formats basada en fluxes. |
LoadOptions | Classe base per a opcions de càrrega específiques de format. |
SaveOptions | Classe base per a opcions de desament específiques de format. |
Format OBJ
| Methods | Methods |
|---|
ObjLoadOptions | Opcions de càrrega per a fitxers Wavefront OBJ. |
ObjSaveOptions | Opcions de desament per a la sortida Wavefront OBJ. |
Format STL
Format glTF
| Methods | Methods |
|---|
GltfLoadOptions | Carrega les opcions per a fitxers glTF 2.0 i GLB. |
GltfSaveOptions | Desa les opcions per a la sortida glTF 2.0 i GLB. No s’exposen propietats específiques del format en aquesta edició; utilitza .glb l’extensió per a la sortida binària. |
Format FBX
| Methods | Methods |
|---|
FbxLoadOptions | Carrega les opcions per a fitxers FBX. |
FbxSaveOptions | Desa les opcions per a la sortida FBX. L’exportació FBX sempre genera sortida binària; l’exportació FBX ASCII no està activa en aquesta versió. |
3MF Format
Methods
| Methods | Methods |
|---|
FileContentType | Descriptor del tipus de contingut: ASCII, Binary. Disponible com a propietat a FileFormat. |
Axis | Identifica un eix de coordenades: XAxis, YAxis, ZAxis. |
CoordinateSystem | Especifica la convenció de sentit: RightHand o LeftHand. |
Sistema de propietats
| Methods | Methods |
|---|
Property | Una única propietat tipada i anomenada en un A3DObject. |
PropertyCollection | Col·lecció iterable de Property objectes adjunts a un A3DObject. |
Vegeu també
