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} 属性はスペースで区切られた数値の文字列で指定され、末尾に数値がない場合はゼロを表します。以下の属性がサポートされています:
名前 | 型 |
---|---|
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がロードされます。
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.