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

詳細説明

この要素は、論理的な粒子を画像としてレンダリングします。この画像は

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

複数の ImageParticle が同じ論理パーティクルグループを描画している場合、ImageParticle はパーティクルに関するデータを暗黙的に共有します。これは、上記の 4 つの機能ごとに細分化されます。したがって、ある ImageParticle がそれらの機能のいずれかについてパーティクルをレンダリングするためのデータを定義しており、もう一方が定義していない場合、その点に関しては両方が自動的に同じようにパーティクルを描画します。 これは主に、パーティクルに何らかのランダムな変動があり、描画元が切り替わってもその変動を維持する必要がある場合に役立ちます。もし両方の ImageParticle がその側面についてどのように表示されるかを定義している場合、両者の挙動は分岐し、それぞれが定義された通りに表示されます。

このデータの共有は、プロパティが暗黙的に設定されたか明示的に設定されたかに基づいて、バックグラウンドで行われます。 現在の実装における欠点の1つは、機能（capabilities）をまとめてのみリセットできる点です。したがって、redVariation のような色に影響を与える属性を明示的に設定した後、それをリセット（redVariation をundefinedに設定）すると、すべての色データがリセットされ、他のImageParticlesから共有されている任意の色の暗黙的な値を持つようになります。

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

alpha : real

画像に適用されるアルファ値です。この値は、画像の値および「color」プロパティの値と掛け合わされます。

パーティクルは加算合成されるため、個々のパーティクルのアルファ値を低く設定すると、複数のパーティクルが重なった際に効果が強くなります。

アルファの値は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

不透明度が1次元テクスチャとして使用され、ライフサイクルにわたるサイズを決定する画像。

このプロパティは、ライフサイクルにわたる不透明度の変化を決定するためのカスタムイージングカーブに取って代わられるため、まもなく削除される予定です。

redVariation : real

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

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

デフォルト値は0.0です。

rotation : real

この設定を行うと、画像は描画される前にこの角度分だけ回転されます。

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

rotationVariation : real

この設定を行うと、個々の粒子の回転は、粒子ごとに最大この程度までばらつきが生じます。

rotationVelocity : real

設定された場合、パーティクルはこの速度（度/秒）で回転します。

rotationVelocityVariation : real

この設定を行うと、個々の粒子のrotationVelocity は、粒子間で最大この程度まで変動することになります。

sizeTable : url

不透明度が1次元テクスチャとして使用され、ライフサイクルにわたるサイズを決定する画像。

このプロパティは、ライフサイクルにわたるサイズを決定するためのカスタムイージングカーブに取って代わられるため、まもなく削除される予定です。

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) ではなく、このベクトルの形状になるように変形されます。