Qt例子学习笔记 - Examples/Qt-6.2.0/qt3d/compute-particles

main.cpp

#include 
#include 
#include 

int main(int argc, char* argv[])
{
    QGuiApplication app(argc, argv);

#if !QT_CONFIG(qt3d_rhi_renderer)
    qputenv("QSG_RHI_BACKEND", "opengl");
#endif
    //QQuickView 类提供了一个用于显示 Qt Quick 用户界面的窗口
    //这是 QQuickWindow 的一个方便的子类，
    //当给定主源文件的 URL 时，它将自动加载和显示 QML 场景。
    //或者，您可以使用 QQmlComponent 实例化您自己的对象并将它们放置在手动设置的 QQuickWindow 中。
    //典型用法：
    /*
        int main(int argc,char *argv[])
        {
            QGuiApplication app(argc,argv);

            QQuickView *view = new  QQuickView;
            view->setSource(QUrl::fromLocalFile("myqmlfile.qml"));
            view->show();
            return app.exe();
        }
    */
    //要接收与使用 QQuickView 加载和执行 QML 相关的错误
    //您可以连接到 statusChanged() 信号并监视 QQuickView::Error。
    //错误可通过 QQuickView::errors() 获得。
    //QQuickView 还管理视图和根对象的大小。
    //默认情况下，resizeMode 是 SizeViewToRootObject，
    //它将加载组件并将其调整为视图的大小。
    //或者，可以将 resizeMode 设置为 SizeRootObjectToView，
    //这会将视图大小调整为根对象的大小。
    QQuickView view;

    view.resize(500, 500);
    view.setResizeMode(QQuickView::SizeRootObjectToView);
    view.setSource(QUrl("qrc:/main.qml"));
    view.show();

    return app.exec();
}

main.qml

import QtQuick 2.0
import QtQuick.Scene3D 2.0
import QtQuick.Controls 2.0
import QtQuick.Layouts 1.1

//一个基本的可视化 QML 类型
//Item 类型是 Qt Quick 中所有可视项的基本类型。
//Qt Quick 中的所有可视项都继承自 Item。
//尽管 Item 对象没有视觉外观，但它定义了所有视觉项的通用属性，
//例如 x 和 y 位置、宽度和高度、锚定和关键处理支持。
//Item 类型可用于将多个项目分组到单个根视觉项目下。 例如：
/*
    import QtQuick 2.0
    Item
    {
        Image
        {
            source: "tile.png"
        }
        Image
        {
            x:80
            width:100
            height:100
            source:"tile.png"
        }
        Image
        {
            x:190
            width:100
            height:100
            fillMode:Image.Tile
            source:"tile.png"
        }
    }
*/
//事件处理
//所有基于 Item 的视觉类型都可以使用 Input Handlers 来处理传入的输入事件（QInputEvent 的子类）
//，例如鼠标、触摸和按键事件。 这是处理事件的首选声明方式。
//处理触摸事件的另一种方法是继承 QQuickItem，
//在构造函数中调用 setAcceptTouchEvents() 并覆盖 touchEvent()。
//接受整个事件以停止向下面的项目交付，并专门抓取所有事件的接触点。
//使用 QPointerEvent::setExclusiveGrabber() 仅抓取某些接触点，并允许进一步传递事件。
//同样，QQuickItem 子类可以调用 setAcceptedMouseButtons() 注册接收鼠标按钮事件
//setAcceptHoverEvents() 接收悬停事件（没有按下按钮时的鼠标移动），
//并覆盖虚拟函数 mousePressEvent()、mouseMoveEvent() 和 mouseReleaseEvent ()。
//那些也可以接受事件以防止进一步交付并同时获得隐式抓取；
//或显式获取 QMouseEvent 携带的单个 QEventPoint。
//通过 Keys 附加属性，所有基于 Item 的视觉类型都可以使用键处理。
//Keys 附加属性提供基本信号，例如按下和释放，以及特定键的信号，例如 spacePressed。
//下面的示例将键盘焦点分配给项目并通过通用 onPressed 处理程序处理左键，
//并通过 onReturnPressed 处理程序处理返回键：
/*
    import QtQuick 2.0
    Item
    {
        focus:true
        Keys.onPressed:(event)=>{
            if(event.key == Qt.Key_Left)
            {
                console.log("move left");
                event.accepted = true;
            }
        }
        Keys.onReturnPressed: console.log("Pressed return");
    }
*/
//有关详细文档，请参阅 Keys 附加属性。
//布局镜像
//可以使用 LayoutMirroring 附加属性来镜像项目布局。
//这会导致锚点水平反转，也会导致布置或定位其子项（例如 ListView 或 Row）的项目水平反转其布局的方向。
//有关更多详细信息，请参阅 LayoutMirroring。
//项目层
//一个 Item 通常会直接渲染到它所属的窗口中
//。 但是，通过设置 layer.enabled，可以将项目及其整个子树委托到offscreen surface。
//只有offscreen surface，一个纹理，才会被绘制到窗口中。
//如果需要与项目的纹理大小不同的纹理大小，可以使用 layer.textureSize。
//要仅将项目的一部分渲染到纹理中，请使用 layer.sourceRect。
//也可以指定 layer.sourceRect 使其超出项目的边界。
//在这种情况下，外部将填充透明像素。
//如果 layer.smooth 设置为 true，
//该项目将使用线性插值进行缩放
//如果 layer.mipmap 设置为 true，则该项目将使用 mipmap 进行下采样。
//Mipmapping 可以提高缩小项目的视觉质量
//对于单个 Image 项的 mipmapping，首选 Image::mipmap。
//图层不透明度与项目不透明度
//将不透明度应用于项目层次结构时，不透明度将单独应用于每个项目。
//当不透明度应用于子树时，这可能会导致不希望的视觉结果。
//考虑以下示例：
/*
    //不分层不透明度
    Item
    {
        id:nonLayered
        opacity:0.5

        width:100
        height:100

        Rectangle{ width:80; height:80;border.width:1}
        Rectangle{ x:20;y:20;width:80;height:80;border.width:1}
    }
    显示透明
*/

//以根项目的不透明度为 1 渲染图层，然后在绘制时将根项目的不透明度应用于纹理。
//这意味着可以在大型项目层次结构中从透明淡化到不透明
//反之亦然，可以在没有正常项目逐项目 alpha 混合所具有的重叠伪影的情况下完成。
//这是启用图层的相同示例：
/*
    分层不透明度
    Item
    {
        id: layered
        opacity:0.5
        layer.enabled:true

        width:100
        height:100

        Rectangle { width:80;height:80;border.width:1}
        Rectangle { x:20;y:20;width:80;height:80;border.width:1}
    }
    显示不透明
*/
//Combined with ShaderEffects
//将 layer.enabled 设置为 true 会将项目转换为纹理提供程序
//，从而可以将项目直接用作纹理，例如与 ShaderEffect 类型结合使用。
//可以在运行时使用 layer.effect 对图层应用效果：
/*
    Item
    {
        id:layerRoot
        layer.enabled = true
        layer.effect:ShaderEffect
        {
            fragmentShader:"effect.frag.qsb"
        }
    }
*/
//有关使用效果的更多信息，请参见 ShaderEffect。
//注意： layer.enabled 实际上只是一种更方便的使用 ShaderEffectSource 的方式。

//内存和性能
//当项目的层被启用时，场景图将在 GPU 中分配等于宽 x 高 x 4 的内存。在内存受限的配置中，应谨慎使用大层。
//在 QPainter / QWidget 世界中，有时在像素图、图像或纹理中缓存复杂内容是有利的。
//在 Qt Quick 中，由于场景图渲染器已经应用了这些技术，因此在大多数情况下并非如此。
//由于批处理已经减少了过多的绘制调用，并且在大多数情况下，缓存最终会混合比原始内容更多的像素。
//因此，渲染到屏幕外的开销以及绘制结果纹理所涉及的混合通常比简单地让项目及其子项正常绘制成本更高。
//此外，在渲染过程中无法对使用图层的项目进行批处理。
//这意味着具有许多分层项目的场景可能存在性能问题。
//分层对于视觉效果来说非常方便和有用
//但在大多数情况下应该在效果的持续时间内启用并在之后禁用。
//Property Documentation

//implicitHeight : real
//implicitWidth : real

//如果未指定宽度或高度，则定义项目的自然宽度或高度。
//大多数项目的默认隐式大小为 0x0，但是有些项目具有无法覆盖的固有隐式大小，例如，图像和文本。
//设置隐式大小对于根据内容定义具有首选大小的组件很有用，例如：
/*
    //Label.qml
    import QtQuick 2.0
    Item
    {
        property alias icon:Image.source
        property alias label:text.text
        implicitWidth: text.implicitWidth + image.implicitWidth
        implicitHeight:Math.max(text.implicitHeight,image.implicitHeight)
        Image{id:image}
        Text
        {
            id:text
            wrapMode:Text.Wrap
            anchors.left:image.right;anchors.right:parent.right
            anchors.verticalCenter:parent.varticalCenter
        }
    }
*/

//注意：使用implicitWidth of Text 或TextEdit 并显式设置宽度会导致性能损失，因为文本必须布局两次

//height : real
//width : real
//x : real
//y : real

//定义项目的位置和大小。 默认值为 0。
//(x,y) 位置是相对于父级的。
//Item{x:100;y:100;width:100;height:100}

//children : list
//resources : list