ImageParticle QML Type

画像を使って論理パーティクルを可視化する。もっと詳しく...

• 継承されたメンバーを含む全メンバーのリスト

プロパティ

• alpha : real
• alphaVariation : real
• autoRotation : bool
• blueVariation : real
• color : color
• colorTable : url
• colorVariation : real
• entryEffect : EntryEffect
• greenVariation : real
• opacityTable : url
• redVariation : real
• rotation : real
• rotationVariation : real
• rotationVelocity : real
• rotationVelocityVariation : real
• sizeTable : url
• source : url
• sprites : list<Sprite>
• spritesInterpolate : bool
• status : Status
• xVector : StochasticDirection
• yVector : StochasticDirection

詳細説明

この要素は論理パーティクルを画像としてレンダリングします。イメージは

• カラー化
• 回転
• 変形
• スプライトベースのアニメーション

複数の ImageParticles が同じ論理パーティクル グループをペイントしている場合、ImageParticles はパーティクルのデータを暗黙的に共有します。これは、上記の4つの機能に沿って分解されます。そのため、1つのImageParticleがこれらの能力の1つでパーティクルをレンダリングするためのデータを定義し、もう1つが定義していない場合、その面では両方とも自動的に同じようにパーティクルを描画します。これは主に、ペインターを切り替えてもパーティクルにランダムな変化がある場合に便利です。両方のImageParticlesがそのアスペクトに対してどのように表示されるべきかを定義している場合、それらは分岐し、それぞれが定義されたように表示されます。

このデータの共有は、プロパティが暗黙的に設定されたか、明示的に設定されたかに基づいて、舞台裏で行われます。現在の実装の欠点は、能力を全体としてリセットすることしかできないことだ。したがって、redVariation のような色に影響する属性を明示的に設定し、（redVariation を undefined に設定することによって）それをリセットすると、すべての色データがリセットされ、他のイメージパーティクルから共有された色の暗黙的な値を持つようになります。

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

alpha : real

画像に適用するアルファ値。この値には、イメージの値とカラー・プロパティの値が掛け合わされる。

パーティクルには加法混色があるため、単一のパーティクルのアルファ値が低いほど、複数のパーティクルが重なったときに強い効果が得られます。

アルファ値は0.0から1.0の間で測定されます。

デフォルトは1.0です。

alphaVariation : real

パーティクル間のアルファチャンネルのばらつき。

アルファ値は0.0から1.0まで。

デフォルトは0.0。

autoRotation : bool

trueに設定すると、パーティクルの回転の上に、進行方向を向くように回転が適用されます。つまり、進行方向と反対側を向くには、autoRotationをtrueに設定し、rotationを180に設定します。

デフォルトはfalseです。

blueVariation : real

粒子間の青色チャンネルのばらつき。

色はチャンネルごとに0.0から1.0の間で測定されます。

デフォルトは0.0。

color : color

色が指定された場合、提供された画像はその色で着色されます。

デフォルトは白（変化なし）。

colorTable : url

1次元テクスチャとして使用され、寿命の間に色を決定する画像。例えば、パーティクルが寿命の半分を過ぎると、イメージの半分で指定された色になります。

この色は、colorプロパティとソース画像の色とブレンドされます。

colorVariation : real

この数値は、個々のパーティクルに適用されるカラーバリエーションを表します。colorVariation を設定することは、redVariation 、greenVariation 、blueVariation を同じ数値に設定することと同じです。

各チャンネルは、パーティクル間で通常の色から colorVariation まで変化させることができます。

色はチャンネルごとに0.0から1.0の間で測定されます。

デフォルトは 0.0 です。

entryEffect : EntryEffect

このプロパティは、パーティクルの基本的で安価な入口と出口のエフェクトを提供します。きめ細かい制御については、sizeTable とopacityTable を参照してください。

使用可能な値は

デフォルト値はImageParticle.Fade 。

greenVariation : real

粒子間の緑色チャンネルのばらつき。

色はチャンネルごとに0.0から1.0の間で測定される。

デフォルトは0.0。

opacityTable : url

不透明度を1Dテクスチャとして使用し、ライフ上のサイズを決定する画像。

このプロパティは間もなく削除される予定で、カスタムイージングカーブでライフに対する不透明度を決定します。

redVariation : real

粒子間の赤色チャンネルのばらつき。

色はチャンネルごとに0.0から1.0の間で測定される。

デフォルトは0.0。

rotation : real

設定すると、描画前に画像がこの角度だけ回転します。

パーティクル座標は変換されません。

rotationVariation : real

設定した場合、個々のパーティクルの回転はパーティクル間で最大これだけ変化する。

rotationVelocity : real

設定すると、パーティクルはこの速度（度/秒）で回転します。

rotationVelocityVariation : real

rotationVelocity を設定した場合、個々のパーティクルは、パーティクル間で最大これだけ異なる。

sizeTable : url

1Dテクスチャとして使用される不透明度を持つ画像。

このプロパティは間もなく削除され、カスタムイージングカーブでライフ上のサイズを決定するようになる予定です。

source : url

使用するソース画像。

画像がスプライトアニメーションの場合は、代わりに sprite プロパティを使用してください。

Qt 5.2以降、プロトタイピングを支援するために、いくつかのデフォルト画像がリソースとして提供されています：

なお、画像は白色で半透明ですが、これは色付けとアルファレベルが最大の効果を発揮できるようにするためです。

sprites : list<Sprite> [read-only]

パーティクルの描画に使用するスプライト。

スプライト画像は、レンダリングされるパーティクルのサイズに基づいて正方形にスケーリングされることに注意してください。

詳細はスプライトアニメーションの概要を参照してください。

spritesInterpolate : bool

trueに設定すると、スプライトパーティクルはレンダリングフレームごとにスプライトフレーム間を補間し、スプライトをより滑らかに見せます。

デフォルトはtrueです。

status : Status [read-only]

画像の読み込み状況。

xVector : StochasticDirection

描画時にパーティクル画像を変形できるようにします。矩形の画像は、水平方向の辺が (1,0) ではなく、このベクトルの形になるように変形されます。

yVector : StochasticDirection

描画時にパーティクル画像を変形できるようにします。長方形の画像は、垂直方向の辺が (0,1) ではなく、このベクトルの形になるように変形されます。