FileInstancing QML Type

Permet de lire les tables d'instance à partir d'un fichier. Plus d'informations...

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

Propriétés

• instanceCount : int (since 6.3)
• source : url

Description détaillée

Le type FileInstancing permet de lire les tables d'instance à partir de fichiers.

Deux formats de fichier sont pris en charge : XML et un format binaire spécifique à Qtt. Le format de fichier binaire utilise la même disposition que la table qui est téléchargée sur le GPU, de sorte qu'elle peut être directement mappée dans la mémoire. L'outil instancer convertit le format XML en format binaire.

Voici un exemple du format de fichier XML :

<?xml version="1.0" encoding="UTF-8" ?>
<InstanceTable>
  <Instance position="0 200 0"  scale="0.75 0.75 0.75" custom="20 20" color="#ffcf7f"/>
  <Instance position="0 -100 0" scale="0.5 0.5 0.5" color="red"/>
  <Instance position="0 -200 0" eulerRotation="0 0 60" color="darkred" custom="10 40 0 0"/>
</InstanceTable>

Pour être valide, le fichier XML doit comporter un élément de premier niveau InstanceTable. Chaque instance est représentée par un élément Instance à l'intérieur de l'élément InstanceTable. Les éléments inconnus sont ignorés.

Un élément Instance peut avoir un certain nombre d'attributs. Les attributs color sont spécifiés par les noms normaux des couleurs Qt SVG ou par la notation hexadécimale. Les attributs vector3d et {vector4d} sont spécifiés par une chaîne de nombres séparés par des espaces, les nombres manquants à la fin indiquant des zéros. Les attributs suivants sont pris en charge :

Les attributs inconnus sont ignorés.

Documentation sur les propriétés

instanceCount : int [since 6.3]

Cette propriété en lecture seule contient le nombre d'instances dans la table d'instance.

Cette propriété a été introduite dans Qt 6.3.

source : url

Cette propriété contient l'emplacement d'un fichier XML ou binaire contenant les données de l'instance.

Si le nom du fichier a une extension ".bin", il est supposé faire référence à un fichier binaire. Dans le cas contraire, il est supposé faire référence à un fichier XML. Si un fichier XML foo.xml est spécifié et que le fichier foo.xml.bin existe, le fichier binaire foo.xml.bin sera chargé à la place.