Référence API pour Aspose.3D 26.1.0 (.NET 10.0+, licence MIT).
Toutes les classes résident dans le Aspose.ThreeD espace de noms racine. La directive using racine est :
Convention de nommage C# : Toutes les propriétés utilisent la syntaxe standard des propriétés C#. Par exemple, utilisez scene.RootNode au lieu de scene.getRootNode(), et transform.Translation = ... au lieu de transform.setTranslation(...).
Casse des champs vectoriels : La bibliothèque possède deux ensembles de types de vecteurs. Aspose.ThreeD.Utilities.Vector2/3/4 (utilisé par Mesh.ControlPoints, geometry, et la plupart des opérations mathématiques) sont double précision avec en minuscules champs publics (v.x, v.y, v.z, v.w). Le plus simple Aspose.ThreeD.Vector2/3/4 structures (dans Vector.cs) sont simple précision (float) avec majuscules champs publics (v.X, v.Y, v.Z). FVector2/3/4 et Quaternion et Matrix4 utilisez l’accès aux champs en majuscules. Utilisez Aspose.ThreeD.Utilities types pour le travail de géométrie.
Graphique de scène principal
| Methods | Methods |
|---|
Scene | Conteneur de niveau supérieur pour toutes les données de scène 3D. Contient le nœud racine, les métadonnées des actifs et les clips d’animation. Expose Open() et Save() comme les points d’entrée I/O principaux. |
Node | Un nœud nommé dans la hiérarchie de la scène. Possède une liste de nœuds enfants et une liste d’attachés Entity objets tels que des maillages, des caméras et des lumières. Porte un local Transform. |
Entity | Classe de base abstraite pour tous les objets qui peuvent être attachés à un Node. Fournit un nom et une identité mais aucune géométrie propre. |
SceneObject | Classe de base partagée par Node et Entity. Fournit l’interface de collection de propriétés utilisée pour les métadonnées définies par l’utilisateur. |
A3DObject | Classe de base racine pour tous les objets gérés Aspose.3D. Expose la Name propriété et le Properties collection. |
INamedObject | Interface qui garantit un Name propriété. Implémentée par Node, Entity, et plusieurs types de descripteurs spécifiques au format. |
Géométrie et maillage
| Methods | Methods |
|---|
Mesh | Entité de maillage polygonal. Stocke les points de contrôle (positions des sommets en tant que Vector4), listes de faces polygonales (listes d’indices de points de contrôle), et couches d’éléments de sommet (normales, UV, couleurs de sommet). |
Geometry | Base abstraite pour les types de géométrie de type maillage. Définit le tableau de points de contrôle et la collection de VertexElement couches. Mesh hérite de Geometry. |
VertexElement | Base abstraite pour une couche de données attachée à la géométrie (normales, UV, couleurs, etc.). Transporte MappingMode, ReferenceMode, et une liste de données. |
VertexElementNormal | Stocke un vecteur normal par sommet ou par coin de polygone, selon le mode de mappage. |
VertexElementUV | Stocke des paires de coordonnées de texture (Vector2) par sommet ou par coin de polygone. |
VertexElementVertexColor | Stocke les données de couleur RGBA par sommet ou par coin sous forme de Vector4. |
Primitives intégrées
| Methods | Methods |
|---|
Box | Boîte paramétrique alignée sur les axes avec largeur, hauteur et profondeur configurables. Peut être attachée à un Node directement ou convertie en Mesh via ToMesh(). |
Sphere | Sphère paramétrique avec rayon configurable. Prend en charge ToMesh() la conversion. |
Cylinder | Cylindre paramétrique avec rayon supérieur, rayon inférieur et hauteur configurables. Prend en charge ToMesh() la conversion. |
Transformation et spatial
| Methods | Methods |
|---|
Transform | Transformation locale attachée à un Node. Fournit Translation (FVector3), Rotation (Quaternion), Scale (FVector3), et Matrix (Matrix4) propriétés. |
GlobalTransform | Vue en lecture seule de la matrice de transformation en espace mondial d’un nœud après composition de toutes les transformations des ancêtres. Accessible via node.GlobalTransform. Expose une seule Matrix propriété. |
AssetInfo | Bloc de métadonnées attaché à un Scene. Hérite de A3DObject fournissant Name et Properties. Aucune propriété supplémentaire n’est définie dans cette édition. |
Matériaux et ombrage
| Methods | Methods |
|---|
Material | Classe de base abstraite pour tous les types de matériau. Fournit un nom et une collection de propriétés. |
LambertMaterial | Matériau classique uniquement diffus avec Ambient, Diffuse, Emissive, Reflective, Transparency, et Texture propriétés. Namespace : Aspose.ThreeD.Shading. |
PhongMaterial | Étend Lambert avec Specular, Shininess, et SpecularPower propriétés. Namespace : Aspose.ThreeD.Shading. |
PbrMaterial | Matériau de rendu physiquement basé avec BaseColor, Metallic, Roughness, Occlusion, et propriétés des emplacements de texture. Namespace : Aspose.ThreeD.Shading. |
Methods
| Methods | Methods |
|---|
Camera | Entité caméra. Hérite de Frustum. Attaché à un Node pour définir les transformations de point de vue. Aucune propriété spécifique au format n’est exposée dans cette édition. |
Utilitaires mathématiques
| Methods | Methods |
|---|
Vector2 | Double précision 2-component vector (lowercase fields: x, y). Namespace: Aspose.ThreeD.Utilities. Utilisé pour les coordonnées de texture UV. |
Vector3 | Double précision 3-component vector (lowercase fields: x, y, z). Namespace: Aspose.ThreeD.Utilities. Vecteur spatial à usage général pour la géométrie. |
Vector4 | Double précision 4-component vector (lowercase fields: x, y, z, w). Namespace: Aspose.ThreeD.Utilities. Utilisé pour Mesh.ControlPoints et les données de normales. |
FVector3 | Vecteur flottant à simple précision de 3 composantes (champs en majuscules : X, Y, Z). Utilisé par Transform.Translation et Transform.Scale. |
FVector4 | Vecteur flottant à simple précision de 4 composantes (champs en majuscules : X, Y, Z, W). |
Quaternion | Quaternion unité pour représenter les rotations (W, X, Y, Z). Utilisé par Transform.Rotation. |
Matrix4 | 4x4 transformation matrix. Used for world/local transform computations and by GlobalTransform.Matrix. |
BoundingBox | Boîte englobante alignée sur les axes définie par Minimum et Maximum FVector3 coins. |
Methods
| Methods | Methods |
|---|
AnimationClip | Conteneur nommé pour une plage d’animation. Un Scene peut contenir plusieurs clips. Ébauche de déclaration — les données d’image-clé et la lecture ne sont pas encore implémentées. |
Entrée/Sortie de format
| Methods | Methods |
|---|
Scene.Open(path) | Ouvre un fichier, détecte le format à partir de l’extension et remplit la scène. |
Scene.Open(path, options) | Ouvre un fichier avec un format spécifique LoadOptions. |
Scene.Open(stream) | Ouvre depuis un flux, détectant automatiquement le format à partir du contenu. |
Scene.Open(stream, options) | Ouvre depuis un flux avec un format spécifique LoadOptions. |
Scene.Save(path) | Enregistre la scène dans un fichier ; le format est déduit de l’extension. |
Scene.Save(path, options) | Enregistre avec un format spécifique SaveOptions. |
Scene.Save(stream, options) | Enregistre dans un flux avec un format spécifique SaveOptions. |
FileFormat | Registre des formats de fichiers pris en charge. Utilisez FileFormat.Formats (un IList<FileFormat>) pour énumérer tous les formats pris en charge, ou FileFormat.Detect(fileName) pour détecter un format par le nom de fichier. Les constantes nommées (ObjFormat, GltfFormat, FbxFormat, etc.) sont internal et ne sont pas accessibles depuis le code utilisateur. |
IOService | Abstraction interne d’E/S. Fournit DetectFormat() pour la détection de format basée sur les flux. |
LoadOptions | Classe de base pour les options de chargement spécifiques à un format. |
SaveOptions | Classe de base pour les options d’enregistrement spécifiques à un format. |
Format OBJ
| Methods | Methods |
|---|
ObjLoadOptions | Options de chargement pour les fichiers Wavefront OBJ. |
ObjSaveOptions | Options d’enregistrement pour la sortie Wavefront OBJ. |
Format STL
Format glTF
| Methods | Methods |
|---|
GltfLoadOptions | Options de chargement pour les fichiers glTF 2.0 et GLB. |
GltfSaveOptions | Options d’enregistrement pour la sortie glTF 2.0 et GLB. Aucune propriété spécifique au format n’est exposée dans cette édition ; utilisez .glb l’extension pour la sortie binaire. |
Format FBX
| Methods | Methods |
|---|
FbxLoadOptions | Options de chargement pour les fichiers FBX. |
FbxSaveOptions | Options d’enregistrement pour la sortie FBX. L’exportation FBX produit toujours une sortie binaire ; l’exportation FBX ASCII n’est pas active dans cette version. |
3MF Format
Methods
| Methods | Methods |
|---|
FileContentType | Descripteur de type de contenu : ASCII, Binary. Disponible en tant que propriété sur FileFormat. |
Axis | Identifie un axe de coordonnées: XAxis, YAxis, ZAxis. |
CoordinateSystem | Spécifie la convention de main: RightHand ou LeftHand. |
Système de propriétés
| Methods | Methods |
|---|
Property | Une propriété typée nommée unique sur un A3DObject. |
PropertyCollection | Collection itérable de Property objets attachés à un A3DObject. |
Voir aussi