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