En esta página

Instancing QML Type (Uncreatable)

Tipo base para tablas de instancias. Más información...

Import Statement: import QtQuick3D
Since: Qt 6.2
In C++: QQuick3DInstancing
Inherits:

Object3D

Inherited By:

FileInstancing, InstanceList, and RandomInstancing

Nota: Se trata de un tipo que no se puede crear. No se puede instanciar en QML.

Propiedades

Métodos

Descripción detallada

El renderizado por instancias permite duplicar un modelo con variaciones.

El tipo «Instancing» define una tabla que especifica cómo se modifica cada instancia con respecto al modelo base. La tabla tiene una entrada para cada índice, que contiene una matriz de transformación, un color y datos genéricos para su uso en materiales personalizados. Para utilizar la instanciación, configura la propiedad « instancing » de un modelo para que haga referencia a un objeto «Instancing».

Una aplicación puede definir un objeto «Instancing» en C++ creando una subclase de « QQuick3DInstancing », o bien puede utilizar uno de los tipos QML predefinidos: « InstanceList », « FileInstancing » o « RandomInstancing ». Además, es posible utilizar un « particle system » para definir una tabla de instanciación mediante la propiedad « ModelParticle3D.instanceTable ».

Documentación de la propiedad

depthSortingEnabled : bool

Almacena el valor de activación de la ordenación por profundidad para la tabla de instancias. Cuando está activada, las instancias se ordenan y se renderizan desde la más alejada de la cámara hasta la más cercana, es decir, de atrás hacia delante. Si está desactivada, que es la configuración por defecto, las instancias se renderizan en el orden en que aparecen especificadas en la tabla de instancias.

Nota: Las instancias solo se ordenan entre sí. No se ordenan con respecto a otros objetos de la escena.

Nota: La ordenación aumenta el tiempo de preparación de los fotogramas, especialmente cuando hay un gran número de instancias.

hasTransparency : bool

Establece esta propiedad en «true» si la tabla de instanciación contiene valores alfa que deben utilizarse al renderizar el modelo. Esta propiedad solo tiene efecto si el modelo es opaco: si el modelo tiene un « material » transparente o un « opacity » inferior a uno, se utilizará el valor alfa de la tabla en cualquier caso.

Nota: Habilitar la mezcla alfa puede provocar problemas de renderizado cuando las instancias se superponen. Consulta la documentación sobre mezcla alfa e instanciación para obtener más detalles.

instanceCountOverride : int

Establece esta propiedad para limitar el número de instancias sin necesidad de regenerar ni volver a cargar la tabla de instancias. Esto permite animar de forma muy económica el número de instancias renderizadas.

shadowBoundsMaximum : vector3d

Establece los límites máximos que se utilizan al calcular los límites del mapa de sombras de los modelos de la tabla de instancias.

Valor por defecto: (-1, -1, -1)

Nota: Esta propiedad solo está habilitada cuando los componentes correspondientes de « Instancing::shadowBoundsMinimum » son menores que los de «Instancing::shadowBoundsMaximum». De lo contrario, los límites se calculan automáticamente.

Véase también « shadowBoundsMinimum ».

shadowBoundsMinimum : vector3d

Establece los límites mínimos que se utilizan al calcular los límites del mapa de sombras de los modelos de la tabla de instancias.

Valor por defecto: (1, 1, 1)

Nota: Esta propiedad solo está habilitada cuando los componentes correspondientes de Instancing::shadowBoundsMinimum son menores que los de Instancing::shadowBoundsMaximum. De lo contrario, los límites se calculan automáticamente.

Véase también shadowBoundsMaximum.

Documentación del método

[since 6.3] color instanceColor(int index)

Devuelve el color de la instancia en index

Este método se introdujo en Qt 6.3.

Véase también instancePosition, instanceScale, instanceRotation, instanceColor y instanceCustomData.

[since 6.3] vector3d instanceCustomData(int index)

Devuelve los datos personalizados de la instancia en index

Este método se introdujo en Qt 6.3.

Véase también instancePosition, instanceScale, instanceRotation, instanceColor e instanceCustomData.

[since 6.3] vector3d instancePosition(int index)

Devuelve la posición de la instancia en index

Este método se introdujo en Qt 6.3.

Véase también instanceScale, instanceRotation, instanceColor y instanceCustomData.

[since 6.3] quaternion instanceRotation(int index)

Devuelve un cuaternión que representa la rotación de la instancia en index

Este método se introdujo en Qt 6.3.

Véase también instancePosition, instanceScale, instanceRotation, instanceColor y instanceCustomData.

[since 6.3] vector3d instanceScale(int index)

Devuelve la escala de la instancia en index

Este método se introdujo en Qt 6.3.

Véase también instancePosition, instanceScale, instanceRotation, instanceColor y instanceCustomData.

© 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.