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。

访问函数

• source()

• setSource()

• 信号 sourceChanged()

property statusᅟ: Qt3DRender.QSceneLoader.Status

包含场景加载状态。

• SceneLoader .None

• SceneLoader .Loading

• SceneLoader .Ready

• SceneLoader .Error

另请参阅

Status

访问函数

• status()

• 信号 statusChanged()

__init__([parent=None])

参数:

parent – QNode

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

component(entityName, componentType)

参数:

• entityName – str

• componentType – ComponentType

返回类型:

QComponent

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

entity(entityName)

参数:

entityName – str

返回类型:

QEntity

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

entityNames()

返回类型:

字符串列表

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

setSource(arg)

参数:

arg – QUrl

另请参阅

source()

设置属性 source 的值。

source()

返回类型:

QUrl

另请参阅

setSource()

获取属性 source 的值。

sourceChanged(source)

参数:

source – QUrl

当属性 source 发生变化时发出的通知信号。

状态()

返回类型:

Status

属性 status 的获取器。

statusChanged(状态)

参数:

状态 – Status

属性 status 的通知信号。