C

Studio3D QML 类型

Qt 3D Studio 演示文稿查看器。 更多...

导入声明import QtStudio3D.OpenGL 2.8
继承

Item

属性

信号

详细说明

此类型允许开发者在 Qt Quick 中嵌入 Qt 3D Studio 演示文稿。

示例用法

Studio3D {
    id: studio3D
    anchors.fill: parent

    Presentation {
        source: "qrc:///presentation.uia"
        SceneElement {
            id: scene
            elementPath: "Scene"
            currentSlideIndex: 2
        }
        Element {
            id: textLabel
            elementPath: "Scene.Layer.myLabel"
        }
    }
    ViewerSettings {
        showRenderStats: true
    }
    onRunningChanged: {
        console.log("Presentation ready!");
    }
}

控制演示文稿

如上例所示，Studio3D 以及在 QtStudio3D 导入下的其他类型不仅提供渲染动画的 Qt 3D Studio 演示文稿，还提供了场景操作，包括

  • 通过 Presentation::getAttribute()、Presentation::setAttribute()， Element 和 DataInput 查询和更改场景对象属性（例如，模型的变换、材质的颜色和其他设置等），
  • 通过 Presentation::goToSlide()， SceneElement 和 DataInput 改变幻灯片（从而开始相关的动画并应用与新幻灯片相关联的场景对象属性更改），
  • 以及通过 Presentation::goToTime()， SceneElement 和 DataInput 在主场景和单个组件节点上控制时间轴（基于关键帧的动画的当前播放位置）。

另请参阅Presentation。

属性文档

asyncInit : bool

如果设置为 true，表示应在辅助线程中异步执行渲染器初始化。这提高了初始化时的 UI 响应性，但可能导致初始化速度变慢。异步初始化可能不会在所有平台上正常工作。

默认为 false。

在创建渲染器之后更改此属性没有任何作用。

此属性在 QtStudio3D.OpenGL 2.5 中引入。


error : string

包含在加载演示文稿期间生成的错误消息文本。如果没有发生错误或没有加载演示文稿，则值是一个空字符串。

此属性为只读。


ignoredEvents : EventIgnoreFlags

此属性可用于忽略鼠标/滚动/键盘事件。默认情况下，所有事件都启用。


presentation : Presentation

presentation 的访问器。预期应用程序为 Studio3D 创建一个单独的 Presentation 子对象。如果省略了此部分，则会自动创建一个 presentation。

此属性为只读。


running : bool

当 presentation 已加载并准备好显示时，此属性值为 true。

此属性为只读。


viewerSettings : ViewerSettings

viewerSettings 的访问器。预期应用程序为 Studio3D 创建一个单独的 ViewerSettings 子对象。如果省略了此部分，则会自动创建 ViewerSettings。

此属性为只读。


信号文档

frameUpdate()

每次渲染帧时都会发出此信号。

注意：相应的处理程序是 onFrameUpdate。


presentationLoaded()

当 presentation 已加载并准备好显示时，会发出此信号。

注意：相应的处理程序是 onPresentationLoaded。


presentationReady()

当 presentation 为第一帧完全初始化 3D 场景时，会发出此信号。

与 presentationLoaded() 不同的是，此信号只在没有必要的异步操作完成时才会发出，以构建 3D 场景和第一帧。

当通过 Loader 项和 Item::visible 属性实现启动画面时，应该使用此信号来触发隐藏启动画面。

注意：相应的处理程序是 onPresentationReady。


在某些 Qt 许可证下可用。
了解更多信息。