类 Scene

Scene class

场景是一个顶层对象,包含节点、几何体、材质、纹理、动画、姿态、子场景等。场景可以拥有子场景,在 collada、blender、fbx 等文件中充当多文档支持。节点层次结构可通过 RootNodeLibrary 访问,Library 用于在序列化期间保存未附加对象的引用(如元数据或自定义对象),因此可用作库。

public class Scene : SceneObject

构造函数

名称描述
Scene()初始化 Scene 类的新实例。
Scene(Entity)初始化 Scene 类的新实例,并将实体附加到新节点。
Scene(Scene, string)初始化 Scene 类的一个新实例作为子场景。

属性

名称描述
AnimationClips { get; }获取场景中定义的所有 AnimationClip
AssetInfo { get; set; }获取或设置顶层资产信息
CurrentAnimationClip { get; set; }获取或设置活动的 AnimationClip
Library { get; }未直接在场景层次结构中使用的对象可以在 Library 中定义。当使用子场景并将可重用组件放在子场景下时,这非常有用。
virtual Name { get; set; }获取或设置名称。
Poses { get; }获取此场景中使用的所有 Pose
Properties { get; }获取所有属性的集合。
RootNode { get; }获取场景的根节点。
Scene { get; }获取此对象所属的场景
SubScenes { get; }获取所有子场景

方法

名称描述
static FromFile(string)从给定路径打开场景
static FromFile(string, CancellationToken)从给定路径打开场景
static FromFile(string, FileFormat, CancellationToken)使用指定的文件格式从给定路径打开场景。
static FromFile(string, LoadOptions, CancellationToken)使用指定的文件格式从给定路径打开场景。
static FromStream(Stream, CancellationToken)从给定流打开场景
static FromStream(Stream, FileFormat, CancellationToken)使用指定的文件格式从给定流打开场景。
static FromStream(Stream, LoadOptions, CancellationToken)使用指定的 IO 配置从给定流打开场景。
Clear()清除场景内容并恢复默认设置。
CreateAnimationClip(string)一个用于创建并注册 AnimationClip 的简写函数。第一个 AnimationClip 将被分配给 CurrentAnimationClip
FindProperty(string)查找属性。它可以是动态属性(由 CreateDynamicProperty/SetProperty 创建)或本地属性(通过其名称识别)
GetAnimationClip(string)获取具名的 AnimationClip
GetProperty(string)获取指定属性的值
Open(Stream)从给定流打开场景
Open(string)从给定路径打开场景
Open(Stream, CancellationToken)从给定流打开场景
Open(string, CancellationToken)从给定路径打开场景
Open(string, LoadOptions)使用指定的文件格式从给定路径打开场景。
Open(Stream, FileFormat, CancellationToken)使用指定的文件格式从给定流打开场景。
Open(Stream, LoadOptions, CancellationToken)使用指定的 IO 配置从给定流打开场景。
Open(string, FileFormat, CancellationToken)使用指定的文件格式从给定路径打开场景。
Open(string, LoadOptions, CancellationToken)使用指定的文件格式从给定路径打开场景。
RemoveProperty(Property)移除动态属性。
RemoveProperty(string)移除通过名称识别的指定属性
Render(Camera, string)从给定相机的视角将场景渲染为外部文件。默认输出尺寸为 1024x768,输出格式为 png。
Render(Camera, TextureData)从给定相机的视角将场景渲染为位图。
Render(Camera, TextureData, ImageRenderOptions)从给定相机的视角将场景渲染为位图。
Render(Camera, string, Vector2, string)从给定相机的视角将场景渲染为外部文件。
Render(Camera, string, Vector2, string, ImageRenderOptions)从给定相机的视角将场景渲染为外部文件。
Save(string)使用指定的文件格式将场景保存到指定路径。
Save(Stream, FileFormat)使用指定的文件格式将场景保存到流。
Save(Stream, SaveOptions)使用指定的文件格式将场景保存到流。
Save(string, FileFormat)使用指定的文件格式将场景保存到指定路径。
Save(string, SaveOptions)使用指定的文件格式将场景保存到指定路径。
Save(Stream, FileFormat, CancellationToken)使用指定的文件格式将场景保存到流。
Save(Stream, SaveOptions, CancellationToken)使用指定的文件格式将场景保存到流。
Save(string, FileFormat, CancellationToken)使用指定的文件格式将场景保存到指定路径。
Save(string, SaveOptions, CancellationToken)使用指定的文件格式将场景保存到指定路径。
SetProperty(string, object)设置指定属性的值

字段

名称描述
const Version获取当前发布版本

另请参见