ParticleSystem3D QML Type

パーティクル、エミッター、アフェクターの各タイプを含むシステム。詳細...

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

• logging : bool
• loggingData : ParticleSystem3DLogging
• paused : bool
• running : bool
• seed : int
• startTime : int
• time : int
• useRandomSeed : bool

方法

• void reset()

詳細説明

この要素はパーティクルシステムのルートであり、システムのタイミングを管理するとともに、パーティクル、エミッター、アフェクターなど、他の関連するすべての要素をまとめて管理します。システム要素をグループ化するには、次のように ParticleSystem3D の直接の子要素にする必要があります：

ParticleSystem3D {
    ParticleEmitter3D {
        ...
    }
    SpriteParticle3D {
        ...
    }
}

あるいは、システム要素が直接の子要素でない場合は、system プロパティを使用して、どのParticleSystem3Dに属するかを指定する必要があります。次のように設定します：

ParticleSystem3D {
    id: psystem
}
ParticleEmitter3D {
    system: psystem
    ...
}
SpriteParticle3D {
    system: psystem
    ...
}

プロパティのドキュメント

logging : bool

loggingData を収集するには、これを true に設定してください。

デフォルト値は `false` です。

「loggingData」も参照してください 。

loggingData : ParticleSystem3DLogging [read-only]

このプロパティには、パーティクルエフェクトの開発や最適化の際に役立つログデータが含まれています。

「logging」も参照してください 。

paused : bool

このプロパティは、システムが現在一時停止中であるかどうかを定義します。「paused」が「true 」に設定されている場合、パーティクルシステムはシミュレーションを進めません。「paused」が再び「false 」に設定されると、シミュレーションは一時停止した時点から再開されます。

デフォルト値は「false 」です。

running : bool

このプロパティは、システムが現在実行中かどうかを定義します。「running」が「false 」に設定されている場合、パーティクルシステムのシミュレーションは停止します。システムが再び「running」に設定されると、すべてのパーティクルが破棄されます。

time プロパティを手動で変更またはアニメーション化する場合は、Runningをfalse に設定する必要があります。

デフォルト値は「true 」です。

seed : int

このプロパティは、パーティクルのランダム化に使用されるシード値を定義します。同じシード値を使用すれば、実行するたびにパーティクルエフェクトは同一になります。これは、ランダムな挙動よりも決定論的な挙動が求められる場合に役立ちます。

デフォルト値は、useRandomSeed がfalse に設定されている場合は0 となり、useRandomSeed がtrue に設定されている場合は1..INT32_MAX の間となります。

useRandomSeedも参照してください 。

startTime : int

このプロパティは、システムが起動するまでの時間をミリ秒単位で定義します。これは、一連のパーティクルがすでに放出されている状態にシステムをウォームアップさせるのに役立ちます。 たとえば、startTime が 2000 に設定され、システム「time 」が 0 から 1000 までアニメーションする場合、実際には 2000 から 3000 ミリ秒の間、パーティクルが表示されます。

デフォルト値は0 です。

time : int

このプロパティは、システムの時間をミリ秒単位で定義します。

以下は、システムを半分の速度で3秒間、ループして手動でアニメーションさせる例です。

ParticleSystem3D {
    running: false
    NumberAnimation on time {
        loops: Animation.Infinite
        from: 0
        to: 3000
        duration: 6000
    }
}

useRandomSeed : bool

このプロパティは、パーティクルシステムのシード値をランダムにするか、ユーザー定義にするかを指定します。「true 」に設定すると、パーティクルシステムが再起動されるたびに、「seed 」の新しいランダム値が生成されます。

デフォルト値は「true 」です。

「seed」も参照してください 。

メソッドのドキュメント

void reset()

このメソッドは、パーティクルシステムの内部状態を初期状態にリセットします。これは、running プロパティがfalse に設定されている場合に、システムをリセットするために使用できます。running がtrue に設定されている場合、システムが内部状態を管理しているため、このメソッドを呼び出す必要はありません。しかし、false に設定されている場合は、システムをいつリセットすべきかをシステムに通知する必要があります。