FileInstancing QML Type

ファイルからインスタンステーブルを読み込めるようにする。詳細...

Import Statement: import QtQuick3D
Since: Qt 6.2
Inherits:

Instancing

プロパティ

詳細説明

FileInstancing 型は、ファイルからインスタンステーブルを読み込むことを可能にします。

サポートされているファイル形式は2つあります:XML形式とQt固有のバイナリ形式です。バイナリファイル形式は、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} 属性はスペースで区切られた数値の文字列で指定され、末尾に数値がない場合は 0 を表します。以下の属性がサポートされています:

名前
positionvector3d
scalevector3d
eulerRotationvector3d
quaternionvector4d
customvector4d
colorcolor

不明な属性は黙って無視されます。

プロパティ文書

instanceCount : int [since 6.3]

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

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


source : url

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

ファイル名の拡張子が".bin "の場合、バイナリファイルを参照していると見なされます。そうでない場合は、XML ファイルを参照していると見なされます。XMLファイルfoo.xmlが指定され、ファイルfoo.xml.binが存在する場合、代わりにバイナリファイルfoo.xml.binがロードされます。


©2024 The Qt Company Ltd. 本書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。