RandomInstancing QML Type

ランダムなインスタンステーブルを生成します。詳細...

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

Instancing

プロパティ

詳細説明

RandomInstancing 型は、定義された範囲内で多数のランダムなインスタンスを生成する簡単な方法を提供します。インスタンスの数はinstanceCount プロパティで定義される。境界はposition,scale,rotation,color,customData プロパティで定義されます。

InstanceListも参照のこと

プロパティの説明

color : InstanceRange

color プロパティは、生成されるインスタンスの色の変化範囲を定義します。型は color です。デフォルト値は空で、色は白になります。

colorModel プロパティを設定すると、例えば飽和色のみを選択することが可能になります。

position,rotation,scale,customDataも参照してください


colorModel : enumeration

このプロパティは、色範囲の解釈方法を制御します。

インスタンスカラーは、fromカラーとtoカラーで決定された範囲内でコンポーネントごとに生成されます。色モデルによって、これらの成分がどのように定義されるかが決まります。

定数説明
RandomInstancing.RGBコンポーネントは、RGB カラーモデルに従って、赤、緑、青、およびアルファです。
RandomInstancing.HSV構成要素は、HSV Color Model に従っ た色相 ・ 彩度 ・ 値 ・ アルフ ァ です。
RandomInstancing.HSL構成要素は、HSL Color Model に従った、色相、彩度、明度、およびアルファです。

例として、次の色域

color: InstanceRange {
    from: Qt.hsva(0, 0.1, 0.8, 1)
    to: Qt.hsva(1, 0.3, 1, 1)
}

は、HSV カラーモデルを使った場合はパステルカラーの全範囲を生成しますが、RGB カラーモデルを使った場合はピンクの濃淡のみを生成します。

デフ ォル ト 値はRandomInstancing.RGB

RandomInstancing::colorも参照


customData : InstanceRange

customData プロパティは、生成されるインスタンスのカスタムデータのバリエーション範囲を定義します。型はvector4d です。デフォルト値は空で、生成されるデータは[0, 0, 0, 0] になります。

position,color,rotation,scale, および customDataも参照してください


instanceCount : int

instanceCount プロパティは、生成するインスタンスの数を指定します。この値を変更すると、テーブル全体が再生成されます。

randomSeedも参照してください


position : InstanceRange

position プロパティは、生成されるインスタンスの幾何学的境界を定義します。デフォルト値は空で、生成される位置は[0, 0, 0] になります。

color,rotation,scale,customDataも参照のこと


randomSeed : int

このプロパティは乱数生成器のシードを定義します。これを -1 以外の値に設定すると、インスタンス・テーブルが生成されるたびに同じ内容になることが保証されます。属性を追加または変更すると、まったく異なるテーブルが生成される可能性があることに注意してください。

デフォルト値は-1で、テーブルが生成されるたびに新しいランダムな値が取得されます。


rotation : InstanceRange

rotationプロパティは、生成されるインスタンスの回転範囲を定義します。型はvector3d で、オイラー回転ベクトル[xRotation, yRotation, zRotation] に対応します。デフォルト値は空で、回転は適用されません。

position,color,scale,customDataも参照してください


scale : InstanceRange

scale プロパティは、生成されるインスタンスのスケーリング限界を定義します。型はvector3d です。一様なスケーリングを行うには、InstanceRange.proportionaltrue に設定します。デフォルト値は空で、スケーリングは適用されません。

position,color,rotation, scale およびcustomDataも参照してください


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