مرجع API لـ Aspose.3D 26.1.0 (.NET 10.0+، رخصة MIT).
جميع الفئات موجودة في Aspose.ThreeD مساحة الاسم الجذرية. توجيه using الجذر هو:
اتفاقية تسمية C#: جميع الخصائص تستخدم بنية خصائص C# القياسية. على سبيل المثال، استخدم scene.RootNode بدلاً من scene.getRootNode(),، و transform.Translation = ... بدلاً من transform.setTranslation(...).
تسمية حقل المتجه: المكتبة تحتوي على مجموعتين من أنواع المتجهات. Aspose.ThreeD.Utilities.Vector2/3/4 (مستخدمة من قبل Mesh.ControlPoints, الهندسة، ومعظم عمليات الرياضيات) هي دقة مزدوجة مع أحرف صغيرة الحقول العامة (v.x, v.y, v.z, v.w). الأبسط Aspose.ThreeD.Vector2/3/4 الهياكل (في Vector.cs) هي دقة مفردة (float) مع أحرف كبيرة الحقول العامة (v.X, v.Y, v.Z). FVector2/3/4 و Quaternion و Matrix4 استخدم الوصول إلى الحقول بأحرف كبيرة. استخدم Aspose.ThreeD.Utilities أنواع لعمل الهندسة.
الرسم البياني الأساسي للمشهد
| Methods | Methods |
|---|
Scene | حاوية المستوى الأعلى لجميع بيانات المشهد ثلاثي الأبعاد. تحتفظ بالعقدة الجذرية، وبيانات تعريف الأصول، ومقاطع الرسوم المتحركة. تكشف Open() و Save() كنقاط الدخول الأساسية للإدخال/الإخراج. |
Node | عقدة مسماة في تسلسل المشهد. تمتلك قائمة من العقد الفرعية وقائمة من المرفقات Entity كائنات مثل الشبكات والكاميرات والإضاءة. تحمل محلية Transform. |
Entity | فئة أساسية مجردة لجميع الكائنات التي يمكن إرفاقها بـ Node. يوفر الاسم والهوية ولكن لا يحتوي على أي هندسة خاصة به. |
SceneObject | الفئة الأساسية المشتركة بين Node و Entity. يوفر واجهة مجموعة الخصائص المستخدمة للبيانات الوصفية المعرفة من قبل المستخدم. |
A3DObject | الفئة الأساسية الجذرية لجميع الكائنات المدارة Aspose.3D. تكشف عن Name الخاصية وال Properties المجموعة. |
INamedObject | واجهة تضمن Name الخاصية. تم تنفيذها بواسطة Node, Entity,، والعديد من أنواع الوصف الخاصة بكل صيغة. |
الهندسة والشبكة
| Methods | Methods |
|---|
Mesh | كيان شبكة مضلع. يخزن نقاط التحكم (مواقع الرؤوس ك Vector4)، قوائم أوجه المضلع (قوائم مؤشرات نقاط التحكم)، وطبقات عناصر الرؤوس (المتجهات العمودية، UVs، ألوان الرؤوس). |
Geometry | قاعدة تجريدية لأنواع الهندسة الشبيهة بالشبكة. تعرف مصفوفة نقاط التحكم ومجموعة VertexElement طبقات. Mesh يُورث من Geometry. |
VertexElement | قاعدة تجريدية لطبقة بيانات مرفقة بالهندسة (normals, UVs, colours, etc.). تحمل MappingMode, ReferenceMode, وقائمة بيانات. |
VertexElementNormal | يخزن متجهًا عموديًا واحدًا لكل رأس أو لكل زاوية مضلع، حسب وضعية التعيين. |
VertexElementUV | يخزن أزواج إحداثيات القوام (Vector2) لكل رأس أو لكل زاوية مضلع. |
VertexElementVertexColor | يخزن بيانات لون RGBA لكل رأس أو لكل زاوية كـ Vector4. |
الأشكال الأولية المدمجة
| Methods | Methods |
|---|
Box | صندوق محور-محاذى برمجي مع عرض وارتفاع وعمق قابلين للتكوين. يمكن ربطه بـ Node مباشرةً أو تحويله إلى Mesh عبر ToMesh(). |
Sphere | كرة برمجية مع نصف قطر قابل للتكوين. تدعم ToMesh() تحويل. |
Cylinder | اسطوانة بارامترية مع نصف قطر علوي قابل للتكوين، نصف قطر سفلي، وارتفاع. يدعم ToMesh() تحويل. |
التحويل والفضائي
| Methods | Methods |
|---|
Transform | تحويل محلي مرفق بـ Node. يوفر Translation (FVector3)،, Rotation (Quaternion)،, Scale (FVector3)، و Matrix (Matrix4) الخصائص. |
GlobalTransform | عرض للقراءة فقط لمصفوفة التحويل في الفضاء العالمي لعقدة بعد تجميع جميع التحويلات السلفية. يتم الوصول إليه عبر node.GlobalTransform. يكشف عن عنصر واحد Matrix خاصية. |
AssetInfo | كتلة البيانات الوصفية المرفقة بـ Scene. يرث من A3DObject توفر Name و Properties. لا توجد خصائص إضافية معرفة في هذا الإصدار. |
المواد والتظليل
| Methods | Methods |
|---|
Material | فئة أساسية مجردة لجميع أنواع المواد. توفر اسمًا ومجموعة خصائص. |
LambertMaterial | مادة كلاسيكية تعتمد على الانتشار فقط مع Ambient, Diffuse, Emissive, Reflective, Transparency, و Texture الخصائص. النطاق: Aspose.ThreeD.Shading. |
PhongMaterial | يمتد Lambert بـ Specular, Shininess, و SpecularPower الخصائص. النطاق: Aspose.ThreeD.Shading. |
PbrMaterial | مادة Physically Based Rendering مع BaseColor, Metallic, Roughness, Occlusion,، وخصائص فتحة القوام. Namespace: Aspose.ThreeD.Shading. |
Methods
| Methods | Methods |
|---|
Camera | كيان Camera. يرث من Frustum. مرفق بـ a Node لتحديد تحويلات منظور الرؤية. لا يتم كشف أي خصائص خاصة بالتنسيق في هذا الإصدار. |
أدوات الرياضيات
| Methods | Methods |
|---|
Vector2 | دقة مزدوجة 2-component vector (lowercase fields: x, y). مساحة الاسم: Aspose.ThreeD.Utilities. يُستخدم لإحداثيات القوام UV. |
Vector3 | دقة مزدوجة 3-component vector (lowercase fields: x, y, z). النطاق: Aspose.ThreeD.Utilities. متجه مكاني عام للجيومتري. |
Vector4 | دقة مزدوجة 4-component vector (lowercase fields: x, y, z, w). Namespace: Aspose.ThreeD.Utilities. يُستخدم لـ Mesh.ControlPoints والبيانات العادية. |
FVector3 | متجه عائم من 3 مكوّنات بدقة مفردة (الحقول الكبيرة: X, Y, Z). يُستخدم بواسطة Transform.Translation و Transform.Scale. |
FVector4 | متجه عائم بدقة مفردة مكوّن من 4 مكوّنات (الحقول بأحرف كبيرة: X, Y, Z, W). |
Quaternion | كواترنيون وحدة لتمثيل الدورانات (W, X, Y, Z). مستخدم من قبل Transform.Rotation. |
Matrix4 | 4x4 transformation matrix. Used for world/local transform computations and by GlobalTransform.Matrix. |
BoundingBox | Axis-aligned bounding box معرف بـ Minimum و Maximum FVector3 الزوايا. |
Methods
| Methods | Methods |
|---|
AnimationClip | حاوية مسماة لنطاق الرسوم المتحركة. A Scene قد يحتوي على مقاطع متعددة. قالب الإعلان — لم يتم تنفيذ بيانات الإطارات المفتاحية والتشغيل بعد. |
إدخال وإخراج الصيغ
| Methods | Methods |
|---|
Scene.Open(path) | يفتح ملفًا، يكتشف الصيغة من الامتداد، ويملأ المشهد. |
Scene.Open(path, options) | يفتح ملفًا بتنسيق محدد LoadOptions. |
Scene.Open(stream) | يفتح من تدفق، مكتشفًا الصيغة تلقائيًا من المحتوى. |
Scene.Open(stream, options) | يفتح من تدفق باستخدام format-specific LoadOptions. |
Scene.Save(path) | يحفظ المشهد إلى ملف؛ format مستنتج من الامتداد. |
Scene.Save(path, options) | يحفظ باستخدام format-specific SaveOptions. |
Scene.Save(stream, options) | يحفظ إلى تدفق باستخدام format-specific SaveOptions. |
FileFormat | سجل صيغ الملفات المدعومة. استخدم FileFormat.Formats (an IList<FileFormat>) FileFormat.Detect(fileName) لكشف صيغة بناءً على اسم الملف. الثوابت المسماة (ObjFormat, GltfFormat, FbxFormat,، إلخ.) هي internal ولا يمكن الوصول إليها من كود المستخدم. |
IOService | تجريد الإدخال/الإخراج الداخلي. يوفر DetectFormat() لاكتشاف الصيغ المستندة إلى التدفق. |
LoadOptions | الفئة الأساسية لخيارات التحميل الخاصة بالتنسيق. |
SaveOptions | الفئة الأساسية لخيارات الحفظ الخاصة بالتنسيق. |
صيغة OBJ
صيغة STL
صيغة glTF
| Methods | Methods |
|---|
GltfLoadOptions | خيارات التحميل لملفات glTF 2.0 و GLB. |
GltfSaveOptions | خيارات الحفظ لإخراج glTF 2.0 و GLB. لا يتم عرض خصائص خاصة بالتنسيق في هذا الإصدار؛ استخدم .glb امتداد للإخراج الثنائي. |
صيغة FBX
| Methods | Methods |
|---|
FbxLoadOptions | خيارات التحميل لملفات FBX. |
FbxSaveOptions | خيارات الحفظ لإخراج FBX. تصدير FBX ينتج دائمًا إخراجًا ثنائيًا؛ تصدير FBX بصيغة ASCII غير مفعل في هذا الإصدار. |
3MF Format
Methods
| Methods | Methods |
|---|
FileContentType | وصف نوع المحتوى: ASCII, Binary. متاح كخاصية على FileFormat. |
Axis | يحدد محور إحداثي: XAxis, YAxis, ZAxis. |
CoordinateSystem | يحدد اتفاقية اليد: RightHand أو LeftHand. |
نظام الخصائص
| Methods | Methods |
|---|
Property | خاصية واحدة مسماة ومُعرفة النوع على A3DObject. |
PropertyCollection | مجموعة قابلة للتكرار من Property الكائنات المرفقة بـ A3DObject. |
انظر أيضًا
