RandomInstancing QML Type

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

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

• color : InstanceRange
• colorModel : enumeration
• customData : InstanceRange
• gridSpacing : vector3d (since 6.9)
• instanceCount : int
• position : InstanceRange
• randomSeed : int
• rotation : InstanceRange
• scale : InstanceRange

詳細説明

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

InstanceListも参照してください 。

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

color : InstanceRange

color プロパティは、生成されるインスタンスの色バリエーションの範囲を定義します。型は color です。デフォルト値は空であり、この場合、色は白になります。

colorModel プロパティを設定すると、例えば彩度の高い色のみを選択できるようになります。

関連項目： position 、rotation 、scale 、およびcustomData 。

colorModel : enumeration

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

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

例として、以下の色範囲

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も参照してください 。

gridSpacing : vector3d [since 6.9]

gridSpacing プロパティは、インスタンス間の最小間隔を定義し、インスタンスが重ならないようにします。各位置は、gridSpacing で指定された値以上の間隔を空けて配置されます。

指定されたgridSpacing で要求されたインスタンス数を収容できない場合、instanceCount プロパティの値は、重なりなく配置できるインスタンス数まで縮小されます。

デフォルト値は `[0, 0, 0]` であり、インスタンスの重なりに対する制限は課されません。

このプロパティは Qt 6.9 で導入されました。

「position」も参照してください 。

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.proportional をtrue に設定してください。デフォルト値は空であり、この場合スケーリングは適用されません。

「 position 」、「color 」、「rotation 」、および「customData 」も参照してください 。