Instancing QML Type

Type de base pour les tables d'instance. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• depthSortingEnabled : bool
• hasTransparency : bool
• instanceCountOverride : int
• shadowBoundsMaximum : vector3d
• shadowBoundsMinimum : vector3d

Méthodes

• color instanceColor(int index) (since 6.3)
• vector3d instanceCustomData(int index) (since 6.3)
• vector3d instancePosition(int index) (since 6.3)
• quaternion instanceRotation(int index) (since 6.3)
• vector3d instanceScale(int index) (since 6.3)

Description détaillée

Lerendu instancié permet de dupliquer un modèle avec des variations.

Le type Instancing définit une table qui spécifie comment chaque instance est modifiée par rapport au modèle de base. La table comporte une entrée pour chaque index, contenant une matrice de transformation, une couleur et des données génériques à utiliser par les matériaux personnalisés. Pour utiliser l'instanciation, définissez la propriété instancing d'un modèle pour qu'elle fasse référence à un objet d'instanciation.

Une application peut définir un objet d'instanciation en C++ en sous-classant QQuick3DInstancing, ou elle peut utiliser l'un des types QML prédéfinis : InstanceList FileInstancing RandomInstancing En outre, il est possible d'utiliser un type particle system pour définir une table d'instanciation en utilisant la propriété ModelParticle3D.instanceTable.

Documentation sur les propriétés

depthSortingEnabled : bool

Contient la valeur d'activation du tri en profondeur pour la table d'instances. Lorsque cette valeur est activée, les instances sont triées et rendues de l'instance la plus éloignée de la caméra à la plus proche, c'est-à-dire de l'arrière vers l'avant. S'il est désactivé, ce qui est la valeur par défaut, les instances sont rendues dans l'ordre où elles sont spécifiées dans la table d'instances.

hasTransparency : bool

Attribuer la valeur true à cette propriété si la table d'instanciation contient des valeurs alpha qui doivent être utilisées lors du rendu du modèle. Cette propriété ne fait une différence que si le modèle est opaque : Si le modèle est transparent ( material) ou si l'adresse opacity est inférieure à un, la valeur alpha de la table sera utilisée de toute façon.

instanceCountOverride : int

Cette propriété permet de limiter le nombre d'instances sans régénérer ou recharger la table des instances. Cela permet une animation très peu coûteuse du nombre d'instances rendues.

shadowBoundsMaximum : vector3d

Définit les limites maximales utilisées lors du calcul des limites de la carte des ombres des modèles dans la table d'instance.

Valeur par défaut : (-1, -1, -1)

Voir également shadowBoundsMinimum.

shadowBoundsMinimum : vector3d

Définit les limites minimales utilisées lors du calcul des limites de la carte des ombres des modèles dans la table d'instance.

Valeur par défaut : (1, 1, 1)

Voir également shadowBoundsMaximum.

Documentation de la méthode

[since 6.3] color instanceColor(int index)

Renvoie la couleur de l'instance à index

Cette méthode a été introduite dans Qt 6.3.

Voir aussi instancePosition, instanceScale, instanceRotation, instanceColor, et instanceCustomData.

[since 6.3] vector3d instanceCustomData(int index)

Renvoie les données personnalisées de l'instance à index

Cette méthode a été introduite dans Qt 6.3.

Voir aussi instancePosition, instanceScale, instanceRotation, instanceColor, et instanceCustomData.

[since 6.3] vector3d instancePosition(int index)

Renvoie la position de l'instance à index

Cette méthode a été introduite dans Qt 6.3.

Voir aussi instanceScale, instanceRotation, instanceColor, et instanceCustomData.

[since 6.3] quaternion instanceRotation(int index)

Renvoie un quaternion représentant la rotation de l'instance à index

Cette méthode a été introduite dans Qt 6.3.

Voir aussi instancePosition, instanceScale, instanceRotation, instanceColor, et instanceCustomData.

[since 6.3] vector3d instanceScale(int index)

Renvoie l'échelle de l'instance à index

Cette méthode a été introduite dans Qt 6.3.

Voir aussi instancePosition, instanceScale, instanceRotation, instanceColor, et instanceCustomData.