RandomInstancing QML Type
Génère une table d'instanciation aléatoire. Plus d'informations...
| Import Statement: | import QtQuick3D.Helpers |
| Since: | Qt 6.2 |
| Inherits: |
Propriétés
- color : InstanceRange
- colorModel : enumeration
- customData : InstanceRange
- gridSpacing : vector3d
(since 6.9) - instanceCount : int
- position : InstanceRange
- randomSeed : int
- rotation : InstanceRange
- scale : InstanceRange
Description détaillée
Le type RandomInstancing permet de générer facilement un grand nombre d'instances aléatoires dans des limites définies. Le nombre d'instances est défini par la propriété instanceCount. Les limites sont définies par les propriétés position, scale, rotation, color, et customData.
Voir également InstanceList.
Documentation sur les propriétés
color : InstanceRange |
La propriété color définit la plage de variation de la couleur pour les instances générées. Le type est color. La valeur par défaut est empty, ce qui signifie que la couleur est blanche.
La définition de la propriété colorModel permet de ne sélectionner que des couleurs saturées, par exemple.
Voir aussi position, rotation, scale, et customData.
colorModel : enumeration |
Cette propriété contrôle la manière dont la gamme de couleurs est interprétée.
Les couleurs de l'instance sont générées composant par composant dans la plage déterminée par les couleurs from et to. Le modèle de couleur détermine la manière dont ces composants sont définis.
| Constante | Description |
|---|---|
RandomInstancing.RGB | Les composantes sont le rouge, le vert, le bleu et l'alpha, conformément au modèle de couleur RVB. |
RandomInstancing.HSV | Les composantes sont la teinte, la saturation, la valeur et l'alpha, selon le modèle de couleur HSV Color Model. |
RandomInstancing.HSL | Les composantes sont la teinte, la saturation, la luminosité et l'alpha, conformément au modèle de couleur HSL Color Model. |
À titre d'exemple, la gamme de couleurs suivante
color: InstanceRange {
from: Qt.hsva(0, 0.1, 0.8, 1)
to: Qt.hsva(1, 0.3, 1, 1)
}générera une gamme complète de couleurs pastel en utilisant le modèle de couleurs HSV, mais seulement des nuances de rose en utilisant le modèle de couleurs RGB.
La valeur par défaut est RandomInstancing.RGB
Voir également RandomInstancing::color.
customData : InstanceRange |
gridSpacing : vector3d |
La propriété gridSpacing définit l'espacement minimal entre les instances, afin de garantir qu'elles ne se chevauchent pas. Chaque position sera séparée par au moins la valeur spécifiée dans gridSpacing.
Si la valeur spécifiée dans gridSpacing ne permet pas d'accueillir le nombre d'instances demandé, la propriété instanceCount sera réduite au nombre d'instances qui peuvent être placées sans se chevaucher.
Remarque : la propriété gridSpacing n'affecte que la position des instances. La rotation et la mise à l'échelle appliquées aux instances ne sont pas prises en compte dans l'algorithme d'espacement.
La valeur par défaut est [0, 0, 0], ce qui n'impose aucune restriction sur le chevauchement des instances.
Cette propriété a été introduite dans Qt 6.9.
Voir également position.
instanceCount : int |
La propriété instanceCount spécifie le nombre d'instances à générer. La modification de cette valeur entraîne la régénération de l'ensemble du tableau.
Voir également randomSeed.
position : InstanceRange |
La propriété position définit les limites géométriques des instances générées. La valeur par défaut est vide, ce qui entraîne une position générée de [0, 0, 0].
Voir également color, rotation, scale, et customData.
randomSeed : int |
Cette propriété définit la graine du générateur de nombres aléatoires. La définition d'une valeur différente de -1 garantit que la table d'instances aura le même contenu à chaque fois qu'elle sera générée. Notez que l'ajout ou la modification d'attributs peut entraîner la génération d'une table complètement différente.
La valeur par défaut est -1, ce qui fait que le tableau reçoit une nouvelle valeur aléatoire à chaque fois qu'il est généré.
rotation : InstanceRange |
La propriété rotation définit la plage de rotation des instances générées. Le type est vector3d, ce qui correspond à un vecteur de rotation d'Euler [xRotation, yRotation, zRotation]. La valeur par défaut est empty, ce qui signifie qu'aucune rotation n'est appliquée.
Voir également position, color, scale, et customData.
scale : InstanceRange |
La propriété scale définit les limites d'échelle des instances générées. Le type est vector3d. Définissez InstanceRange.proportional à true pour une mise à l'échelle uniforme. La valeur par défaut est empty, ce qui signifie qu'aucune mise à l'échelle n'est appliquée.
Voir également position, color, rotation, scale et customData.
© 2025 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.