FileInstancing QML Type
Permite leer tablas de instancias desde un archivo. Más...
| Import Statement: | import QtQuick3D |
| Since: | Qt 6.2 |
| Inherits: |
Propiedades
- instanceCount : int
(since 6.3) - source : url
Descripción detallada
El tipo FileInstancing permite leer tablas de instancias desde archivos.
Hay dos formatos de archivo compatibles: XML y un formato binario específico de Qt. El formato de archivo binario utiliza la misma estructura que la tabla que se carga en la GPU, por lo que puede asignarse directamente a la memoria. La herramienta Instancer convierte el 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 que sea válido, el archivo XML debe contener un elemento de nivel superior ` InstanceTable `. Cada instancia está representada por un elemento ` Instance ` dentro de ` InstanceTable`. Los elementos desconocidos se ignoran sin aviso.
Un elemento ` Instance ` puede tener varios atributos. Los atributos ` color ` se especifican mediante los nombres de color habituales 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 finales que falten indican ceros. Se admiten los siguientes atributos:
| name | type |
|---|---|
position | vector3d |
scale | vector3d |
eulerRotation | vector3d |
quaternion | vector4d |
custom | vector4d |
color | color |
Los atributos desconocidos se ignoran sin aviso.
Documentación de propiedades
instanceCount : int [since 6.3]
Esta propiedad de solo lectura contiene el número de instancias de 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 trata de un archivo binario. En caso contrario, se supone que se trata de un archivo XML. Si se especifica un archivo XML llamado foo.xml y existe el archivo foo.xml.bin, se cargará en su lugar el archivo binario foo.xml.bin.
© 2026 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.