Instancing QML Type

Tipo base para tablas de instancia. Más...

Import Statement:	`import QtQuick3D`
Since:	Qt 6.2
In C++:	QQuick3DInstancing
Inherits:	Object3D
Inherited By:	FileInstancing, InstanceList, and RandomInstancing

Lista de todos los miembros, incluidos los heredados

Propiedades

depthSortingEnabled : bool
hasTransparency : bool
instanceCountOverride : int
shadowBoundsMaximum : vector3d
shadowBoundsMinimum : vector3d

Métodos

color instanceColor(int index) (since 6.3)
vector3d instanceCustomData(int index) (since 6.3)
vector3d instancePosition(int index) (since 6.3)
quaternion instanceRotation(int index) (since 6.3)
vector3d instanceScale(int index) (since 6.3)

Descripción detallada

El renderizado instanciado permite duplicar un modelo con variaciones.

El tipo Instancing define una tabla que especifica cómo se modifica cada instancia en relación con el 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 por materiales personalizados. Para utilizar el instanciado, establezca la propiedad instancing de un modelo para que haga referencia a un objeto Instanciado.

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

Documentación de propiedades

depthSortingEnabled : bool

Contiene el valor de ordenación de profundidad habilitado para la tabla de instancias. Cuando está activado, las instancias se ordenan y renderizan desde la instancia más alejada de la cámara a la más cercana, es decir, de atrás hacia delante. Si está deshabilitado, que es el valor por defecto, las instancias se renderizan en el orden en que se especifican en la tabla de instancias.

Nota: Las instancias sólo se ordenan entre sí. Las instancias 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 el número de instancias es elevado.

hasTransparency : bool

Establezca esta propiedad a true si la tabla de instanciación contiene valores alfa que deberían utilizarse al renderizar el modelo. Esta propiedad sólo supone una diferencia si el modelo es opaco: Si el modelo tiene un material transparente, o un opacity menor que uno, se utilizará el valor alfa de la tabla.

Nota: Activar la mezcla alfa puede causar problemas de renderizado cuando las instancias se solapan. Consulte la documentación sobre mezcla alfa e instanciación para más detalles.

instanceCountOverride : int

Establezca esta propiedad para limitar el número de instancias sin regenerar o volver a cargar la tabla de instancias. Esto permite una animación muy económica del número de instancias renderizadas.

shadowBoundsMaximum : vector3d

Establece los límites máximos utilizados 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 sólo se activa cuando los componentes respectivos de Instancing::shadowBoundsMinimum son menores que los de Instancing::shadowBoundsMaximum. En caso contrario, los límites se calculan automáticamente.

Véase también shadowBoundsMinimum.

shadowBoundsMinimum : vector3d

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

Valor por defecto: (1, 1, 1)

Véase también shadowBoundsMaximum.