כיצד להתחיל עם Aspose.3D FOSS עבור .NET

Aspose.3D FOSS עבור .NET הוא ספרייה חינם, מורשה על ידי MIT להורדה, ניתוח, והצלת קבצים 3D – אין בינאריות מקומיות נדרשת, C# טהור מ NuGet.

מדריך שלב‑אחר‑שלב

שלב 1: התקנת החבילה

התקנה מ- NuGet ( .NET 10.0 או מאוחר יותר נדרש):

dotnet add package Aspose.3D --version 26.1.0

בדוק את ההתקנה הנכונה:

using Aspose.ThreeD;
Console.WriteLine("Aspose.3D loaded.");

שלב 2: ייבוא שטחי שמות נדרשים

ייבוא שטחי השם עבור המופע וקטגוריות פורמט:

using Aspose.ThreeD;
using Aspose.ThreeD.Formats;

שלב 3: הורד קובץ 3D

שימוש Scene.Open() כדי להעלות כל פורמט תומך.הספרייה מזהה את הפורמט באופן אוטומטי מתוך הרחבה של הקובץ:

using Aspose.ThreeD;

var scene = new Scene();
scene.Open("model.obj");
Console.WriteLine($"Loaded scene with root node: {scene.RootNode.Name}");

או להשתמש בשיטה סטטית מפעל:

var scene = Scene.FromFile("model.glb");

שלב 4: חוצה את הקריקטורה

עץ שורש הוא עצי Node אובייקטים שורשים ב scene.RootNode:

using Aspose.ThreeD;

void Walk(Node node, int depth = 0)
{
    var indent = new string(' ', depth * 2);
    Console.WriteLine($"{indent}Node: {node.Name}");
    foreach (var child in node.ChildNodes)
        Walk(child, depth + 1);
}

var scene = Scene.FromFile("model.obj");
Walk(scene.RootNode);

שלב 3: שמור לפורמט היעד

שימוש Scene.Save() כל תפריט ייצוא נתמך.הספרייה מזהה את התפריטים פורמט היציאה מתוך הרחבת הקובץ:

using Aspose.ThreeD;

var scene = Scene.FromFile("model.obj");
scene.Save("output.glb");
Console.WriteLine("Saved as GLB.");

בעיות נפוצות ותיקונים

FileNotFoundException כאשר קוראים Scene.Open() הדרך שעברת אינה קיימת או משתמשת בחלק הלא נכון. Path.Combine() כדי להבטיח כי מסלול הקובץ הוא נכון.

UnsupportedOperationException על שיטות מסוימות שיטות מסוימות (הצגת סצנה, סימני מים) אינן זמינות בגרסה FOSS. בדוק את תיעוד הגבלות לפני השימוש בתכונות מתקדמות.

שגיאה פורמט לא ידוע להבטיח שהרחבה של הקובץ תואמת את התבנית האמיתית.הספרייה מזהה את הפורמט על ידי הרחבה עבור Scene.Open() ו Scene.FromFile().עשה את ההסבר המפורט FileFormat הפרומטרים להגדרה מוגזמת.

סצנה ריקה לאחר ההעלאה כמה פורמטים בינאריים עשויים לדרוש אפשרויות משאבה ספציפיות. עם ObjLoadOptions או GltfLoadOptions אם העומס הנדרש יוצר סצנה ריקה.

שאלות נפוצות

האם Aspose.3D FOSS דורש Microsoft Office או כל DLL המקומי?

הספרייה היא C# טהור ללא תלויות מקומיות או בינאריות חיצוניות נדרשות.

אילו גרסאות .NET תומכות?

.NET 10.0 או מאוחר יותר.הספרייה פועלת על Windows, macOS, Linux ו- Docker.

האם הספרייה חופשית לשימוש מסחרי?

כן, הוא שוחרר תחת רישיון MIT. אתה יכול להשתמש בו, לשנות אותו ולהפיץ מחדש לכל מטרה, כולל יישומים מסחריים.

אילו פורמטים 3D אני יכול לקרוא ולכתוב?

הספרייה תומכת OBJ, STL, GLTF 2.0 / GLB, FBX, COLLADA ו 3MF עבור שניהם. קרא וכתוב. PLY הוא ייבוא בלבד. FileFormat.GetFormatByExtension() ל תמיכה בפורמטים בזמן עבודה.

האם אני יכול ליצור סצנה 3D מתוך סקרטש?

תגית: יצירת A Scene ללא תובנות, הוסף נוזלים לילדים scene.RootNode, ו להשאיר את זה בפורמט הרצוי.