FileInstancing QML Type

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

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

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

Detaillierte Beschreibung

Der Typ FileInstancing ermöglicht es, Instanztabellen aus Dateien zu lesen.

Es gibt zwei unterstützte Dateiformate: XML, und ein Qt-spezifisches Binärformat. Das binäre Dateiformat verwendet das gleiche Layout wie die Tabelle, die auf die GPU hochgeladen wird, so dass sie direkt in den Speicher abgebildet werden kann. Das Instanzierungswerkzeug konvertiert von XML in das Binärformat.

Dies ist 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 Top-Level-Element InstanceTable 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 haben. color -Attribute werden durch die normalen Qt SVG -Farbnamen oder durch hexadezimale Notation angegeben. vector3d - und {vector4d}-Attribute werden durch eine Zeichenkette aus durch Leerzeichen getrennten Zahlen angegeben, wobei fehlende Zahlen am Ende Nullen bedeuten. Die folgenden Attribute werden unterstützt:

Unbekannte Attribute werden stillschweigend ignoriert.

Eigenschaft Dokumentation