FileInstancing QML Type

Ermöglicht das Einlesen von Instanztabellen aus einer Datei. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

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

Ausführliche Beschreibung

Der Typ „FileInstancing“ ermöglicht das Einlesen von Instanztabellen aus Dateien.

Es werden zwei Dateiformate unterstützt: XML und ein Qt-spezifisches Binärformat. Das Binärdateiformat verwendet denselben Aufbau wie die Tabelle, die auf die GPU hochgeladen wird, sodass es direkt in den Speicher abgebildet werden kann. Das Instancer-Tool konvertiert XML in das Binärformat.

Hier ein Beispiel für das XML-Dateiformat:

<?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>

Um gültig zu sein, muss die XML-Datei ein Element „ InstanceTable “ auf oberster Ebene enthalten. Jede Instanz wird durch ein „ Instance “-Element innerhalb des „ InstanceTable “-Elements dargestellt. Unbekannte Elemente werden stillschweigend ignoriert.

Ein „ Instance “-Element kann eine Reihe von Attributen aufweisen. „ color “-Attribute werden durch die üblichen „ Qt SVG “-Farbnamen oder in hexadezimaler Notation angegeben. „ vector3d “- und „{vector4d}“-Attribute werden durch eine Zeichenkette aus durch Leerzeichen getrennten Zahlen angegeben, wobei fehlende Ziffern am Ende Nullen bedeuten. Die folgenden Attribute werden unterstützt:

Unbekannte Attribute werden stillschweigend ignoriert.

Dokumentation zu den Eigenschaften

instanceCount : int [since 6.3]

Diese schreibgeschützte Eigenschaft enthält die Anzahl der Instanzen in der Instanztabelle.

Diese Eigenschaft wurde in Qt 6.3 eingeführt.

source : url

Diese Eigenschaft enthält den Speicherort einer XML- oder Binärdatei, die die Instanzdaten enthält.

Wenn der Dateiname die Erweiterung „.bin“ hat, wird davon ausgegangen, dass es sich um eine Binärdatei handelt. Andernfalls wird davon ausgegangen, dass es sich um eine XML-Datei handelt. Wenn eine XML-Datei „foo.xml“ angegeben wird und die Datei „foo.xml.bin“ existiert, wird stattdessen die Binärdatei „foo.xml.bin“ geladen.