このページでは

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]

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

注意: このプロパティに正しいデータが含まれるのは、loggingtrue に設定され、パーティクルシステムが動作している場合のみです。

loggingも参照して ください。

paused : bool

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

デフォルト値はfalse です。

running : bool

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

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

デフォルト値はtrue です。

seed : int

このプロパティは、パーティクルのランダム化に使用するシード値を定義します。同じシードを使用すると、パーティクルの効果はすべての実行で同じになります。これはランダムな動作よりも決定論的な動作が望まれる場合に便利です。

デフォルト値は、useRandomSeedfalse に設定されているときは0 で、useRandomSeedtrue に設定されているときは1..INT32_MAX の中間の値です。

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

useRandomSeedも参照して ください。

startTime : int

このプロパティは、システムが開始する時間をミリ秒単位で定義します。これは、パーティクルのセットがすでに放出されているようにシステムをウォームアップするのに便利です。例えば startTime が 2000 に設定され、systemtime が 0 から 1000 までアニメーションする場合、実際のアニメーションは 2000 から 3000ms までのパーティクルを表示します。

デフォルト値は0 です。

time : int

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

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

以下は、手動でシステムを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 のときにシステムをリセットするために使用できます。runningtrue の場合は、システムが内部状態を管理しているため、このメソッドを呼び出す必要はありませんが、false の場合は、システムがいつリセットされるべきかを知る必要があります。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.