ניהול סצנה
ניהול סצנות
המחלקה Scene היא נקודת הכניסה לכל תוכן תלת-ממדי ב-Aspose.3D עבור .NET. היא מספקת שיטות ליצירת סצנות מאפס, לטעון קבצים קיימים בכל פורמט נתמך, לשמור לכל פורמט יעד, ולבדוק מטא-נתוני סצנה.
יצירת ופתיחת סצנות
צור סצנה ריקה עם new Scene(), או טען מקובץ:
using Aspose.ThreeD;
// Empty scene
var empty = new Scene();
// Load from file — format is detected automatically
var scene = Scene.FromFile("model.fbx");
// Load using Scene.Open with explicit format
var scene2 = new Scene();
scene2.Open("model.obj", FileFormat.WavefrontOBJ);
// Load from a stream (useful when reading from memory or network)
using var stream = System.IO.File.OpenRead("model.stl");
var scene3 = new Scene();
scene3.Open(stream, FileFormat.STLBinary);Scene.FromFile מזהה אוטומטית את הפורמט מהרחבה של הקובץ ובתים קוסמים. השתמש בגרסת FileFormat כאשר ההרחבה אינה חד-משמעית או חסרה.
שמירת סצנות
שמור סצנה לקובץ או לזרם בכל פורמט פלט נתמך:
// Save to file — format determined from extension
scene.Save("output.gltf");
// Save with explicit format
scene.Save("output.bin", FileFormat.GLTF2_Binary);
// Save to a stream
using var output = System.IO.File.Create("output.fbx");
scene.Save(output, FileFormat.FBX7700Binary);
// Save with format-specific options
var opts = new Aspose.ThreeD.Formats.ObjSaveOptions();
opts.PointCloud = false;
scene.Save("output.obj", opts);מחיקת תוכן הסצנה
כדי להסיר את כל הצמתים והמשאבים מסצנה תוך שמירת האובייקט Scene:
// Remove all direct children of the root node
scene.RootNode.ChildNodes.Clear();
// Or replace the scene entirely
scene = new Scene();Scene.Clear() זמין ומנקה את תוכן הסצנה, משחזר את ההגדרות ברירת המחדל; לחלופין, צור מופע Scene חדש כפי שמוצג למעלה.
מטא-נתונים של סצנה
המאפיין AssetInfo ב-Scene חושף מטה-נתונים משובצים בתבניות נתמכות (FBX, Collada, glTF):
var info = scene.AssetInfo;
Console.WriteLine("Author: " + info.Author);
Console.WriteLine("Creation UTC: " + info.CreationTime);
Console.WriteLine("Units: " + info.UnitName + " @ " + info.UnitScaleFactor);הגדר מטה-נתונים לפני השמירה כדי לשמר אותם בקובץ הפלט:
scene.AssetInfo.ApplicationName = "My Application 1.0";
scene.AssetInfo.UnitName = "meter";
scene.AssetInfo.UnitScaleFactor = 1.0;
scene.Save("output_with_meta.fbx");API Quick Reference
| Member | תיאור |
|---|---|
new Scene() | צור סצנה ריקה |
Scene.FromFile(path) | עזר סטטי: פתח קובץ והחזר את הסצנה שהוטענה |
scene.Open(path, format?) | טען קובץ לתוך סצנה קיימת |
scene.Open(stream, format) | טען מזרם |
scene.Save(path, format?) | שמור לקובץ |
scene.Save(stream, format) | שמור לזרם |
scene.RootNode | שורש Node של היררכיית הסצנה |
scene.AssetInfo | בלוק מטא-נתונים (יוצר, חותמות זמן, יחידות) |
scene.AssetInfo.ApplicationName | שם היישום מוטמע בקובץ |
scene.AssetInfo.UnitScaleFactor | קנה מידה של יחידת הסצנה יחסית למטרים |
ראה גם
- Aspose.3D for .NET — Enterprise Documentation
- עבודה עם גרף הסצנה — נווט ושנה את היררכיית הצמתים
- תמיכת פורמטים — כל פורמטים נתמכים של קלט ופלט