FileInstancing QML Type

Permite leer tablas de instancia desde un archivo. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

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

Descripción detallada

El tipo FileInstancing permite leer tablas de instancia desde archivos.

Hay dos formatos de archivo soportados: XML, y un formato binario específico de Qt. El formato de archivo binario utiliza el mismo diseño que la tabla que se carga en la GPU, por lo que puede asignarse directamente a la memoria. La herramienta instancer convierte de XML al formato binario.

Este es un ejemplo del formato de archivo 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>

Para ser válido, el archivo XML debe tener un elemento de nivel superior InstanceTable. Cada instancia está representada por un elemento Instance dentro del elemento InstanceTable. Los elementos desconocidos se ignoran silenciosamente.

Un elemento Instance puede tener varios atributos. Los atributos color se especifican mediante los nombres de color normales de Qt SVG o mediante notación hexadecimal. Los atributos vector3d y {vector4d} se especifican mediante una cadena de números separados por espacios, donde los números que faltan al final indican ceros. Se admiten los siguientes atributos:

Los atributos desconocidos se ignoran silenciosamente.

Documentación de propiedades

instanceCount : int [since 6.3]

Esta propiedad de sólo lectura contiene el número de instancias en la tabla de instancias.

Esta propiedad se introdujo en Qt 6.3.

source : url

Esta propiedad contiene la ubicación de un archivo XML o binario que contiene los datos de la instancia.

Si el nombre del archivo tiene la extensión ".bin", se supone que se refiere a un archivo binario. En caso contrario, se supone que se refiere a un archivo XML. Si se especifica un archivo XML foo.xml, y el archivo foo.xml.bin existe, se cargará en su lugar el archivo binario foo.xml.bin.