このページでは

LineParticle3D QML Type

線粒子。詳細...

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

SpriteParticle3D

プロパティ

詳細な説明

LineParticle3Dは、線状のスプライトパーティクルを生成します。

線は、パーティクルが移動する際の軌跡から生成されます。線の長さは、length パラメータ、またはセグメント数と点間の最小デルタのいずれかによって指定されます。後者の場合、パーティクルの速度が変化すると、線の長さも変化する可能性があります。

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

TexcoordMode : enumeration

ラインパーティクルのテクスチャ座標モードを定義します。

定数説明
LineParticle3D.Absoluteテクスチャ座標は、ワールド座標系を基準として指定されます。
LineParticle3D.Relativeテクスチャ座標は、ラインの最初の点に対する相対座標として指定されます。
LineParticle3D.Fillテクスチャ座標は、テクスチャがライン全体を覆うように指定されます。

alphaFade : real

このプロパティは、線のアルファフェード係数を保持します。alphaFade の値の範囲は [0, 1] です。この値が 0.0 より大きい場合、最初のパーティクルセグメントから離れるほど、線のフェードが進みます。 セグメントのアルファ値は、次のように計算されます:segmentAlpha(s) = (1.0 - alphaFade) ^ s(ここで、s はセグメントのインデックスです)。デフォルト値は 0.0 です。

eolFadeOutDuration : int

このプロパティは、ラインの寿命終了時のフェードアウト時間を指定します。このプロパティを設定すると、各ラインはパーティクルの寿命が終了した時点の位置に留まり、その期間中にフェードアウトします。デフォルト値は 0 です。

length : real

このプロパティは線の長さを保持します。値が設定されている場合、線の長さはその値に制限されます。 この場合、線の最小デルタは、長さをセグメント数で割った値になります。値が設定されていない場合、線の長さは、パーティクルの移動速度、セグメント数、および最小デルタに基づいて変化します。デフォルト値は -1.0 です。

lengthDeltaMin : real

このプロパティは、セグメントの点間の最小長さを保持します。このパラメータは、lengthパラメータが設定されている場合は無視されます。デフォルト値は10.0です。

lengthVariation : real

このプロパティは、各線に適用される長さの変動を保持します。変動は、length プロパティも設定されている場合にのみ適用されます。結果として得られる線の長さは、正の値にクリップされます。

デフォルト値は 0.0 です。

scaleMultiplier : real

このプロパティは、線の拡大倍率を保持します。scaleMultiplier の値の範囲は [0, 2] です。scaleMultiplier は、線分の線幅を変更します。 値が 1.0 未満の場合、最初の線分から離れるほど線分が小さくなり、値が 1.0 より大きい場合は線分が大きくなります。線分のサイズは次のように計算されます:size(s) = scaleMultiplier ^ s(ここで、s は線分のインデックスです)。

segmentCount : int

このプロパティは、線のセグメント数を保持します。線は、セグメント数+1個の点を使って描画されます。この「+1」は、パーティクルの現在の位置に由来します。デフォルト値は1です。

texcoordMode : TexcoordMode

このプロパティは、線のテクスチャ座標モードを保持します。

texcoordMultiplier : real

このプロパティには、線のテクスチャ座標の乗数が格納されます。この値は、線のテクスチャ座標値に掛け合わされます。デフォルト値は 1.0 です。

© 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.