随机实例化 QML 类型

生成一个随机实例化表。更多信息...

导入说明import QtQuick3D.Helpers
Qt 6.2
继承

Instancing

属性

详细描述

RandomInstancing 类型提供了一种简单的方式在定义的范围内生成大量随机实例。实例数量由 instanceCount 属性定义。范围由属性 positionscalerotationcolor 以及 customData 定义。

参见 InstanceList.

属性文档

颜色 : 实例范围

颜色属性定义了生成的实例的颜色变化范围。类型是颜色。默认值是空,导致颜色为白色。

设置 颜色模型 属性可以仅选择饱和的颜色,例如。

参见 位置旋转缩放 以及 自定义数据.


颜色模型 : 枚举类型

该属性控制如何解释颜色范围。

实例颜色在由颜色指定范围内生成,颜色模型决定了这些组件的定义方式。

常量描述
RandomInstancing.RGB组件包括红色、绿色、蓝色和透明度,根据RGB颜色模型。
RandomInstancing.HSV组件包括色调、饱和度、亮度和透明度,根据HSV颜色模型
RandomInstancing.HSL组件包括色调、饱和度、明度和透明度,根据HSL颜色模型

例如,以下颜色范围

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属性定义了生成的实例的自定义数据变化范围。类型是向量4d。默认值是空的,导致生成数据为[0, 0, 0, 0]

参考positioncolorrotationscale和customData。


instanceCount : int

instanceCount属性指定要生成的实例数。更改此值将重新生成整个表格。

参考randomSeed


position : InstanceRange

position属性定义生成的实例的几何边界。默认值是空的,导致生成的位置为[0, 0, 0]

参考colorrotationscalecustomData


randomSeed : int

此属性定义随机数生成器的种子。将其设置为与-1不同的值将确保实例表在每次生成时都具有相同的内容。请注意,添加或更改属性可能会生成完全不同的表格。

默认值是-1,导致每次生成表格时都获得新的随机值。


rotation : InstanceRange

rotation属性定义生成实例的旋转范围。类型是向量3d,对应Euler旋转向量[xRotation, yRotation, zRotation]。默认值是空的,导致不应用旋转。

参考positioncolorscalecustomData


scale : InstanceRange

scale属性定义生成实例的比例限制。类型是向量3d。将InstanceRange.proportional设置为true进行均匀缩放。默认值是空的,导致不应用缩放。

另请参阅 位置颜色旋转,缩放以及自定义数据


© 2024 Qt公司有限公司。本文件中包含的文档贡献版权属于各自所有者。本文件提供的文档是根据自由软件基金会发布的GNU自由文档许可协议版本1.3授予许可的。Qt和相应的标志是Qt公司有限公司在芬兰和/或世界其他国家的商标。所有其他商标均为各自所有者的财产。