En esta página

RandomInstancing QML Type

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

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

Instancing

Propiedades

Descripción detallada

El tipo RandomInstancing ofrece una forma sencilla de generar un gran número de instancias aleatorias dentro de unos límites definidos. El número de instancias viene definido por la propiedad instanceCount. Los límites vienen definidos por 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 variaciones de color para las instancias generadas. El tipo es «color». El valor por defecto está vacío, lo que hace que el color sea blanco.

Al establecer la propiedad « colorModel », es posible seleccionar únicamente colores saturados, por ejemplo.

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 la instancia se generan componente por componente dentro del rango determinado por los colores «from » y «to ». El modelo de color determina cómo se definen dichos componentes.

ConstanteDescripción
RandomInstancing.RGBLos componentes son el rojo, el verde, el azul y el alfa, según el modelo de color RGB.
RandomInstancing.HSVLos componentes son tono, saturación, valor y alfa, según el modelo de color RGB ( HSV Color Model).
RandomInstancing.HSLLos componentes son tono, saturación, luminosidad y alfa, según el modelo de color « HSL Color Model ».

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 solo 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 está vacío, lo que hace 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, lo que garantiza que no se superpongan. Cada posición estará separada, como mínimo, por el valor especificado en ` gridSpacing`.

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

Nota: La propiedad gridSpacing solo afecta a la posición de las instancias. La rotación y el escalado aplicados a las instancias no se tienen en cuenta en el algoritmo de espaciado.

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 que se van a generar. Si se modifica este valor, se volverá a generar 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, lo que da lugar a una posición generada de [0, 0, 0].

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

randomSeed : int

Esta propiedad define la semilla del generador de números aleatorios. Si se establece un valor distinto de -1, se garantiza que la tabla de instancias tenga el mismo contenido cada vez que se genere. Ten en cuenta que añadir o modificar atributos puede provocar que se genere una tabla completamente diferente.

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

rotation : InstanceRange

La propiedad «rotation» define el rango de rotación de 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, lo que hace que no se aplique ninguna rotación.

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

scale : InstanceRange

La propiedad «scale» define los límites de escalado para las instancias generadas. El tipo es « vector3d ». Establece « InstanceRange.proportional » en « true » para obtener un escalado uniforme. El valor por defecto está vacío, lo que hace que no se aplique ningún escalado.

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

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