文件实例化 QML 类型

允许从文件中读取实例表。更多信息...

导入语句	import QtQuick3D
自从	Qt 6.2
继承	实例化

所有成员的列表，包括继承成员

属性

instanceCount : int (since 6.3)
source : url

详细说明

FileInstancing 类型可从文件中读取实例表。

支持两种文件格式：XML 和 Qt 特定的二进制格式。二进制文件格式使用与上传到 GPU 的表相同的布局，因此可以将其直接映射到内存中。instancer 工具将 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 颜色名称或十六进制表示法指定。 vector3d 和 vector4d 属性由一系列以空格分隔的数字字符串指定，缺失的尾随数字表示零。以下属性被支持

name	type
`position`	`vector3d`
`scale`	`vector3d`
`eulerRotation`	`vector3d`
`quaternion`	`vector4d`
`custom`	`vector4d`
`color`	`color`

未知属性被静默忽略。

属性文档

instanceCount : int [since 6.3]

此只读属性包含实例表中实例的数量。

此属性在 Qt 6.3 中引入。

source : url

此属性包含包含实例数据的位置的 XML 或二进制文件。

如果文件名具有 ".bin" 扩展名，则假定它指的是二进制文件。否则假定它指的是 XML 文件。如果指定了 XML 文件 foo.xml，并且存在文件 foo.xml.bin，则将加载二进制文件 foo.xml.bin。