RandomInstancing QML Type
Genera una tabla de instanciación aleatoria. Más...
| Import Statement: | import QtQuick3D.Helpers |
| Since: | Qt 6.2 |
| Inherits: |
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 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.
| Constante | Descripción |
|---|---|
RandomInstancing.RGB | Los componentes son el rojo, el verde, el azul y el alfa, según el modelo de color RGB. |
RandomInstancing.HSV | Los componentes son tono, saturación, valor y alfa, según el modelo de color RGB ( HSV Color Model). |
RandomInstancing.HSL | Los 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.