Instancing QML Type (Uncreatable)

Type de base pour les tables d'instances. En savoir plus...

Remarque : il s'agit d'un type non instanciable. Il ne peut pas être instancié dans QML.

• 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

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

Le type Instancing définit un tableau qui précise comment chaque instance est modifiée par rapport au modèle de base. Ce tableau comporte une entrée pour chaque index, contenant une matrice de transformation, une couleur et des données génériques destinées à être utilisées par des matériaux personnalisés. Pour utiliser l'instanciation, définissez la propriété instancing d'un modèle de manière à ce qu'elle fasse référence à un objet Instancing.

Une application peut définir un objet Instancing en C++ en créant une sous-classe de ` QQuick3DInstancing`, ou elle peut utiliser l’un des types QML prédéfinis : ` InstanceList `, ` FileInstancing` ou ` RandomInstancing`. De plus, il est possible d’utiliser un ` particle system ` pour définir un tableau d’instanciation à l’aide de la propriété ` ModelParticle3D.instanceTable `.

Documentation sur les propriétés

depthSortingEnabled : bool

Contient la valeur indiquant si le tri en profondeur est activé pour le tableau des instances. Lorsque cette option est activée, les instances sont triées et rendues de la plus éloignée de la caméra à la plus proche, c'est-à-dire de l'arrière vers l'avant. Si elle est désactivée (ce qui est le cas par défaut), les instances sont rendues dans l'ordre dans lequel elles sont spécifiées dans le tableau des instances.

hasTransparency : bool

Définissez cette propriété sur « true » si la table d'instanciation contient des valeurs alpha qui doivent être utilisées lors du rendu du modèle. Cette propriété n'a d'incidence que si le modèle est opaque : si le modèle présente une transparence material ou une opacity inférieure à un, la valeur alpha de la table sera utilisée dans tous les cas.

instanceCountOverride : int

Définissez cette propriété pour limiter le nombre d'instances sans avoir à régénérer ni à recharger la table des instances. Cela permet d'animer à moindre coût le nombre d'instances affichées.

shadowBoundsMaximum : vector3d

Définit les limites maximales utilisées pour calculer les limites de la carte d'ombres des modèles de la table d'instances.

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

Voir également shadowBoundsMinimum.

shadowBoundsMinimum : vector3d

Définit les limites minimales utilisées pour calculer les limites de la carte d'ombres des modèles de la table d'instances.

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

Voir également shadowBoundsMaximum.

Documentation des méthodes

[since 6.3] color instanceColor(int index)

Renvoie la couleur de l'instance à l'emplacement index

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

Voir également instancePosition, instanceScale, instanceRotation, instanceColor et instanceCustomData.

[since 6.3] vector3d instanceCustomData(int index)

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

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

Voir également 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 également 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 également 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 également instancePosition, instanceScale, instanceRotation, instanceColor et instanceCustomData.