创建并读取现有 3D 场景

概述

本文介绍了以下使用 C# 3D 文件格式操作库的主题。

• 从头开始在 C# 中创建一个空的 3D 场景
• 读取或加载 C# 中现有的 3D 场景
• 使用 C# 以支持的 3D 格式保存 3D 场景
• 使用 C# 中的 3D 场景属性

创建一个空的 3D 场景并以支持的 3D 文件格式保存

Aspose。3D API 支持从头开始创建新的 3D 场景，然后以任何支持的文件格式保存。开发人员还可以加载现有的 3D 场景以进行修改、添加或处理。

创建 3D 场景文档

请按照 C# 中的以下步骤使用 Aspose.3D api创建 3D 场景文档:

1. 创建表示 3D 场景文档的 Scene 类的实例。
2. 通过调用Scene类对象的 Save 方法生成 3D Scene文档。

// For complete examples and data files, please go to https://github.com/aspose-3d/Aspose.3D-for-.NET

// Create an object of the Scene class
Scene scene = new Scene();
// Save 3D scene document
scene.Save("document.fbx");

正在读取 3D 场景

使用 Aspose.3D API，开发人员可以加载所有受支持的 3D 文档。Scene 类的可用构造函数允许这样做，并且它们接受有效的文件路径字符串。支持的可读文件格式如下:

1. FBX 7.5 (ASCII，二进制)
2. FBX 7.4 (ASCII，二进制)
3. FBX 7.3 (ASCII，二进制)
4. FBX 7.2 (ASCII，二进制)
5. FBX 6.1 (ASCII，二进制)
6. STL (ASCII，二进制)
7. WavefrontOBJ
8. Discreet3DS
9. Universal3D
10. Collada
11. glTF (ASCII，二进制)
12. Maya (ASCII，二进制)
13. OpenUSD (USD, USDZ)
14. 搅拌机
15. DXF
16. PLY (ASCII，二进制)
17. X (ASCII，二进制)
18. Draco
19. 3MF
20. RVM (文本，二进制)
21. ASE

Scene 类的构造函数在内部检测 3D 文档格式。

// For complete examples and data files, please go to https://github.com/aspose-3d/Aspose.3D-for-.NET
// The path to the documents directory.

// Initialize a Scene class object
Scene scene = new Scene();
// Load an existing 3D document
scene.Open("document.fbx");

使用 3D 场景属性

Aspose.3D API 允许您使用场景的子节点读取 3D 场景属性。下面的 C# 代码示例演示了此功能的用法。

// For complete examples and data files, please go to https://github.com/aspose-3d/Aspose.3D-for-.NET
Scene scene = Scene.FromFile("EmbeddedTexture.fbx");
Material material = scene.RootNode.ChildNodes[0].Material;
PropertyCollection props = material.Properties;
//List all properties using foreach
foreach (var prop in props)
{
    Console.WriteLine("{0} = {1}", prop.Name, prop.Value);
}
//or using ordinal for loop
for (int i = 0; i < props.Count; i++)
{
    var prop = props[i];
    Console.WriteLine("{0} = {1}", prop.Name, prop.Value);
}
//Get property value by name
var diffuse = props["Diffuse"];
Console.WriteLine(diffuse);
//modify property value by name
props["Diffuse"] = new Vector3(1, 0, 1);
//Get property instance by name
Property pdiffuse = props.FindProperty("Diffuse");
Console.WriteLine(pdiffuse);
//Since Property is also inherited from A3DObject
//It's possible to get the property of the property
Console.WriteLine("Property flags = {0}", pdiffuse.GetProperty("flags"));
//and some properties that only defined in FBX file:
Console.WriteLine("Label = {0}", pdiffuse.GetProperty("label"));
Console.WriteLine("Type Name = {0}", pdiffuse.GetProperty("typeName"));
//so traversal on property's property is possible
foreach (var pp in pdiffuse.Properties)
{
    Console.WriteLine("Diffuse.{0} = {1}", pp.Name, pp.Value);
}