qml AngleDirection详解

news2025/5/19 12:01:37

1、概述

AngleDirection 是 QML（Qt Meta Language）中用于定义粒子发射方向的一个类，它属于 Qt Quick Particles 模块。AngleDirection 通过设置角度范围来控制粒子从发射器射出时的初始方向。这个类在创建具有特定发射模式的粒子效果时非常有用，比如模拟火焰、喷泉或爆炸等场景。

2、重要属性

angle：定义一个单独的发射角度（以度为单位）。当设置了此属性时，angleSpread 属性将被忽略。
angleSpread：定义一个角度范围（以度为单位），粒子将在这个范围内随机选择一个发射角度。这有助于创建更自然的粒子效果，因为每个粒子的发射方向都会略有不同。
direction：定义一个二维向量，用于指定粒子的发射方向。这个属性通常与 directionVariance 一起使用来创建更复杂的发射模式。
directionVariance：定义一个二维向量的方差，用于在 direction 指定的方向上添加随机变化。这可以使得粒子的发射方向更加多样化。

Window {
    width: 480; height: 240
    visible: true

    Rectangle {
        id: root
        width: 480; height: 240
        color: "#1F1F1F"

        ParticleSystem {
            id: particleSystem
        }

        ImageParticle {
            source: "res/star.png"
            system: particleSystem
            color: '#FFD700'
            colorVariation: 0.2
            rotation: 0
            rotationVariation: 45
            rotationVelocity: 15
            rotationVelocityVariation: 15
            entryEffect: ImageParticle.Scale
        }


        // M1>>
        Emitter {
            id: emitter
            anchors.left: parent.left
            anchors.verticalCenter: parent.verticalCenter
            width: 1; height: 1
            system: particleSystem
            lifeSpan: 6400
            lifeSpanVariation: 400
            size: 32
            velocity: AngleDirection {
                angle: 0
                angleVariation: 15
                magnitude: 100
                magnitudeVariation: 50
            }
        }
        // <<M1
    }
}