البدء

البدء مع Aspose.3D FOSS لـ .NET

مرحبًا بك في Aspose.3D,، مكتبة .NET مجانية ومفتوحة المصدر لتحميل وبناء وتصدير المشاهد ثلاثية الأبعاد. يوجهك هذا الدليل من بيئة جديدة إلى مشهد يعمل خلال دقائق.

المتطلبات المسبقة

التثبيت

1. إنشاء أو فتح مشروع .NET:

dotnet new console -n My3DApp
cd My3DApp

1. أضف حزمة NuGet:

dotnet add package Aspose.3D --version 26.1.0

1. تحقق من أن الإشارة تُترجم بنجاح:

using Aspose.ThreeD;

var scene = new Scene();
Console.WriteLine("Aspose.3D loaded successfully.");

dotnet run

انظر دليل التثبيت لمزيد من التفاصيل حول إعداد المشروع والتحقق.

ما يمكنك القيام به

بعد التثبيت يمكنك فورًا:

• تحميل ملفات OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA, PLY, و 3MF عبر Scene.Open()
• فحص تسلسلات المشهد: استعراض Node الأشجار، قراءة Mesh الهندسة، الوصول إلى القمم العادية وإحداثيات UV
• تحويل العقد: تعيين Translation, Rotation (عبر Quaternion), و Scale من خلال Transform الفئة
• تطبيق المواد: تعيين LambertMaterial, PhongMaterial, أو PbrMaterial إلى العقد
• تصدير إلى أي تنسيق مدعوم مع per-format SaveOptions
• بناء الهندسة: إنشاء Box, Sphere, و Cylinder الأشكال الأولية وتحويلها إلى Mesh عبر ToMesh()

البدء السريع

حمّل ملفًا ثلاثي الأبعاد، اطبع تسلسل المشهد، وأعد حفظه بتنسيق GLB:

using Aspose.ThreeD;

var scene = new Scene();
scene.Open("input.obj");

Console.WriteLine($"Root children: {scene.RootNode.ChildNodes.Count}");
foreach (var node in scene.RootNode.ChildNodes)
{
    var entityType = node.Entity?.GetType().Name ?? "no entity";
    Console.WriteLine($"  {node.Name} [{entityType}]");
}

scene.Save("output.glb");
Console.WriteLine("Saved output.glb");

الخطوات التالية

• دليل التثبيت: إعداد NuGet التفصيلي، تكوين المشروع، والتحقق
• دليل المطور: دعم الصيغ، عمليات الشبكة، المواد، والتحويلات
• الميزات والوظائف: استكشاف عميق لكل مجال من المجالات مع أمثلة C#