RandomInstancing QML Type

Genera una tabla de instanciación aleatoria. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

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

Descripción detallada

El tipo RandomInstancing proporciona una forma sencilla de generar un gran número de instancias aleatorias dentro de unos límites definidos. El número de instancias se define mediante la propiedad instanceCount. Los límites se definen mediante las propiedades position, scale, rotation, color, y customData.

Véase también InstanceList.

Documentación de propiedades

color : InstanceRange

La propiedad color define el rango de variación de color para las instancias generadas. El tipo es color. El valor por defecto es vacío, lo que hace que el color sea blanco.

Establecer la propiedad colorModel permite, por ejemplo, seleccionar sólo colores saturados.

Véase también position, rotation, scale, y customData.

colorModel : enumeration

Esta propiedad controla cómo se interpreta la gama de colores.

Los colores de instancia se generan componente a componente dentro del rango determinado por los colores desde y hasta. El modelo de color determina cómo se definen esos componentes.

A modo de ejemplo, la siguiente gama de colores

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

generará una gama completa de colores pastel cuando se utilice el modelo de color HSV, pero sólo tonos de rosa cuando se utilice el modelo de color RGB.

El valor por defecto es RandomInstancing.RGB

Véase también RandomInstancing::color.

customData : InstanceRange

La propiedad customData define el rango de variación de los datos personalizados para las instancias generadas. El tipo es vector4d. El valor por defecto es vacío, provocando que los datos generados sean [0, 0, 0, 0].

Véase también position, color, rotation, y scale.

gridSpacing : vector3d [since 6.9]

La propiedad gridSpacing define el espaciado mínimo entre instancias, asegurando que no se solapen. Cada posición estará separada al menos por el valor especificado en gridSpacing.

Si el gridSpacing especificado no puede acomodar el número de instancias solicitado, la propiedad instanceCount se reducirá al número de instancias que puedan colocarse sin solaparse.

El valor por defecto es [0, 0, 0], que no impone ninguna restricción a la superposición de instancias.

Esta propiedad se introdujo en Qt 6.9.

Véase también position.

instanceCount : int

La propiedad instanceCount especifica el número de instancias a generar. Si se cambia este valor, se regenerará toda la tabla.

Véase también randomSeed.

position : InstanceRange

La propiedad position define los límites geométricos de las instancias generadas. El valor por defecto es vacío, provocando una posición generada de [0, 0, 0].

Véase también color, rotation, scale, y customData.

randomSeed : int

Esta propiedad define la semilla para el generador de números aleatorios. Establecer un valor distinto de -1 garantiza que la tabla de instancia tendrá el mismo contenido cada vez que se genere. Tenga en cuenta que añadir o cambiar atributos puede provocar que se genere una tabla completamente diferente.

El valor por defecto es -1, haciendo que la tabla obtenga un nuevo valor aleatorio cada vez que se genera.

rotation : InstanceRange

La propiedad de rotación define el rango de rotación para las instancias generadas. El tipo es vector3d, que corresponde a un vector de rotación de Euler [xRotation, yRotation, zRotation]. El valor por defecto es vacío, por lo que no se aplica ninguna rotación.

Véase también position, color, scale, y customData.

scale : InstanceRange

La propiedad scale define los límites de escala para las instancias generadas. El tipo es vector3d. Establezca InstanceRange.proportional en true para un escalado uniforme. El valor por defecto es vacío, por lo que no se aplica ninguna escala.

Véase también position, color, rotation, y customData.