FileInstancing QML Type
ファイルからインスタンステーブルを読み込めるようにする。詳細...
Import Statement: | import QtQuick3D |
Since: | Qt 6.2 |
Inherits: |
プロパティ
- instanceCount : int
(since 6.3)
- source : url
詳細説明
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 を表します。以下の属性がサポートされています:
名前 | 型 |
---|---|
position | vector3d |
scale | vector3d |
eulerRotation | vector3d |
quaternion | vector4d |
custom | vector4d |
color | color |
不明な属性は黙って無視されます。
プロパティ文書
instanceCount : int |
この読み取り専用プロパティには、インスタンステーブル内のインスタンス数が含まれます。
このプロパティは 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.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。