FileInstancing QML Type

ファイルからインスタンステーブルを読み込むことができます。詳細...

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

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

詳細な説明

FileInstancing 型を使用すると、ファイルからインスタンステーブルを読み込むことができます。

サポートされているファイル形式は、XML と Qt 独自のバイナリ形式の 2 つです。バイナリファイル形式は、GPU にアップロードされるテーブルと同じレイアウトを使用しているため、メモリに直接マッピングすることができます。インスタンス化ツールは、XML からバイナリ形式への変換を行います。

以下は、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>

XMLファイルが有効であるためには、最上位にInstanceTable 要素が含まれている必要があります。各インスタンスは、InstanceTable 内のInstance 要素によって表されます。未知の要素は黙って無視されます。

Instance 要素には、いくつかの属性を指定できます。color 属性は、通常のQt SVG の色名、または16進数表記で指定します。vector3d および{vector4d}属性は、スペースで区切られた数値の文字列で指定し、末尾の数値が省略されている場合はゼロを意味します。以下の属性がサポートされています：

不明な属性は、何のメッセージも出さずに無視されます。

プロパティのドキュメント

instanceCount : int [since 6.3]

この読み取り専用プロパティには、インスタンステーブル内のインスタンス数が格納されます。

このプロパティは Qt 6.3 で導入されました。

source : url

このプロパティは、インスタンスデータを含むXMLファイルまたはバイナリファイルの場所を保持します。

ファイル名に「.bin」という拡張子がある場合、そのファイルはバイナリファイルであるとみなされます。それ以外の場合は、XMLファイルであるとみなされます。XMLファイル「foo.xml」が指定されており、かつ「foo.xml.bin」というファイルが存在する場合、代わりにバイナリファイル「foo.xml.bin」が読み込まれます。