Back to Qt.io
Contact Us Blog Download Qt

ParticleSystem3D QML Type

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

Import Statement: import QtQuick3D.Particles3D
Since: Qt 6.2
Inherits:

Node

プロパティ

メソッド

詳細説明

この要素はパーティクルシステムのルートで、システムのタイミングを処理し、パーティクル、エミッタ、アフェクタなどの他のすべての関連要素をグループ化します。システム要素をグループ化するには、このように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 がtrue に設定され、パーティクルシステムが動作している場合のみです。

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 に設定され、systemtime が 0 から 1000 までアニメーションする場合、実際のアニメーションは 2000 から 3000ms までのパーティクルを表示します。

デフォルト値は0 です。


time : int

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

注意： time プロパティを変更する場合、通常はrunning をfalse に設定する必要があります。

以下は、手動でシステムを 3 秒間、ループで、半分の速度でアニメートする例です：

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

useRandomSeed : bool

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

デフォルト値はtrue です。

注意： このプロパティはパーティクルアニメーション中に変更しないでください。

seedも参照して ください。


メソッドの説明

reset()

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


©2024 The Qt Company Ltd. 本書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。