FileInstancing QML Type

Permet de lire les tables d'instance à partir d'un fichier. En savoir plus...

• 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 des tables d'instances à partir de fichiers.

Deux formats de fichiers sont pris en charge : XML et un format binaire spécifique à Qt. Le format de fichier binaire utilise la même structure que la table chargée sur le GPU, ce qui permet de la mapper directement en mémoire. L'outil « instancer » effectue la conversion du format XML vers le format binaire.

Voici un exemple de fichier au format 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'InstanceTable. Les éléments inconnus sont ignorés sans message d'erreur.

Un élément Instance peut comporter plusieurs attributs. Les attributs color sont spécifiés à l’aide des noms de couleurs standard de Qt SVG ou en notation hexadécimale. Les attributs vector3d et {vector4d} sont spécifiés par une chaîne de chiffres séparés par des espaces, les chiffres manquants à la fin indiquant des zéros. Les attributs suivants sont pris en charge :

Les attributs inconnus sont ignorés sans message d’erreur.

Documentation des propriétés

instanceCount : int [since 6.3]

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

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

source : url

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

Si le nom du fichier porte l'extension « .bin », on considère qu'il s'agit d'un fichier binaire. Dans le cas contraire, on considère qu'il s'agit d'un fichier XML. Si un fichier XML foo.xml est spécifié et que le fichier foo.xml.bin existe, c'est le fichier binaire foo.xml.bin qui sera chargé à la place.