PySide6.Qt3DRender.Qt3DRender.QSceneLoader¶

class QSceneLoader¶

提供加载现有场景的功能。更多…

概要¶

属性¶

• sourceᅟ

• statusᅟ

方法¶

• def __init__()

• def component()

• def entity()

• def entityNames()

• def source()

• def status()

插槽¶

• def setSource()

信号¶

• def sourceChanged()

• def statusChanged()

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述¶

给定一个3D源文件，QSceneLoader 将尝试解析它并构建一个带有适当 QGeometryRenderer、QTransform 和 QMaterial 组件的 QEntity 对象树。

加载器将尝试根据模型文件的属性确定要使用的最佳材质。如果您希望使用自定义材质，您将需要遍历树并将默认关联的材质替换为您自己的材质。

顾名思义，QSceneLoader 加载一个完整的场景子树。如果你想加载单个几何体，你应该使用 QMesh。

QSceneLoader 内部依赖于使用插件来支持多种3D文件格式。这里是Qt3D支持的格式列表。

注意

此组件不应在多个QEntity实例之间共享。否则会导致未定义的行为。

另请参阅

QMesh QGeometryRenderer

class Status¶

此枚举标识加载的状态

常量	描述
Qt3DRender.QSceneLoader.None	QSceneLoader 尚未被使用。
Qt3DRender.QSceneLoader.Loading	QSceneLoader 当前正在加载场景文件。
Qt3DRender.QSceneLoader.Ready	QSceneLoader 成功加载了场景文件。
Qt3DRender.QSceneLoader.Error	QSceneLoader 在加载场景文件时遇到错误。

class ComponentType¶

此枚举指定了一个组件类型。

常量	描述
Qt3DRender.QSceneLoader.UnknownComponent	未知组件类型
Qt3DRender.QSceneLoader.GeometryRendererComponent	QGeometryRenderer 组件
Qt3DRender.QSceneLoader.TransformComponent	QTransform 组件
Qt3DRender.QSceneLoader.MaterialComponent	QMaterial 组件
Qt3DRender.QSceneLoader.LightComponent	QAbstractLight 组件
Qt3DRender.QSceneLoader.CameraLensComponent	QCameraLens 组件

注意

当使用from __feature__ import true_property时，属性可以直接使用，否则通过访问器函数使用。

property sourceᅟ: QUrl¶

保存要加载的源的URL。

Access functions:

• source()

• setSource()

• 信号 sourceChanged()

property statusᅟ: Qt3DRender.QSceneLoader.Status¶

保存场景加载的状态。

• SceneLoader .无

• SceneLoader .加载中

• SceneLoader .准备就绪

• SceneLoader .错误

另请参阅

状态

Access functions:

• status()

• 信号 statusChanged()

__init__([parent=None])¶

Parameters:

parent – QNode

构造函数创建一个具有指定parent的实例。

component(entityName, componentType)¶

Parameters:

• entityName – str

• componentType – ComponentType

Return type:

QComponent

返回一个与加载实体的componentType匹配的组件，该实体的对象名称与entityName匹配。如果实体有多个匹配的组件，则返回实体组件列表中的第一个匹配项。如果没有匹配项，则返回空指针。

entity(entityName)¶

Parameters:

entityName – str

Return type:

QEntity

返回一个与entityName参数匹配的objectName的加载实体。如果有多个实体具有相同的名称，则返回其中哪一个是不确定的，但始终会返回同一个。

entityNames()¶

Return type:

字符串列表

返回已加载实体的objectNames列表。

setSource(arg)¶

Parameters:

arg – QUrl

另请参阅

source()

属性 sourceᅟ 的设置器。

source()¶

Return type:

QUrl

另请参阅

setSource()

属性 sourceᅟ 的获取器。

sourceChanged(source)¶

Parameters:

source – QUrl

属性 sourceᅟ 的通知信号。

status()¶

Return type:

状态

属性 statusᅟ 的获取器。

statusChanged(status)¶

Parameters:

状态 – Status

属性 statusᅟ 的通知信号。