Qt Quick 3D QML Types

Este es el frontend QML para utilizar el renderizador espacial y el scenegraph. Por el momento, todo el contenido 3D pasa a través de texturas fuera de pantalla (FBO)s para que puedan ser compuestas en escenas Qt Quick (como QQuickItem).

Importa el módulo QtQuick3D con la siguiente sentencia:

import QtQuick3D

QtQuick3D Tipos QML

AddDefine	Añade una definición de preprocesador a la compilación del shader para un pase
BakedLightmap	Especifica la configuración del baked lightmap para un modelo
Buffer	Crea o hace referencia a un búfer de color que se utilizará para una pasada de un Efecto
BufferInput	Define un búfer de entrada que se utilizará como entrada para un pase de un Efecto
Camera	Define una base abstracta para Cámaras
ColorAttachment	Define un archivo adjunto de color para un pase
Command	Supertipo de comandos a realizar como parte de un pase de un Efecto
ContentLayer	Proporciona una enumeración de las capas de contenido disponibles en un QtQuick3D
CubeMapTexture	Define una textura de mapa cúbico para su uso en escenas 3D
CustomCamera	Define una Cámara con una matriz de proyección personalizada
CustomMaterial	Componente base para crear materiales personalizados utilizados para sombrear modelos
DebugSettings	Se utiliza para configurar los ajustes de depuración
DepthStencilAttachment	Define un accesorio de plantilla de profundidad para un RenderPass
DepthTextureAttachment	Define un accesorio de textura de profundidad para un pase
DirectionalLight	Define una luz direccional en la escena
Effect	Componente base para crear un efecto de post-procesado
FileInstancing	Permite leer tablas de instancias desde un archivo
Fog	Especifica los ajustes de niebla para una escena
FrustumCamera	Define una PerspectiveCamera con un frustum personalizado
Geometry	Tipo base para geometría personalizada
InstanceList	Permite especificar instancias manualmente en QML
InstanceListEntry	Especifica una instancia en una InstanceList
Instancing	Tipo base para tablas de instancias
Joint	Define un nodo en una jerarquía de animación esquelética
Light	Un tipo base abstracto no creable para todas las luces
Lightmapper	Especifica los ajustes de horneado del mapa de luces para una escena
Loader3D	Permite la carga dinámica de un subárbol 3D desde una URL o un componente
Material	Tipo base abstracto que proporciona una funcionalidad común a los materiales
Model	Permite cargar los datos de un modelo 3D
MorphTarget	Define las propiedades de un objetivo morph
Node	Componente base para un objeto que existe en una escena 3D
Object3D	Tipo base abstracto de todos los nodos y recursos 3D
OrthographicCamera	Define una Cámara con una matriz de proyección ortográfica
Pass	Define un pase de renderizado en un efecto
PerspectiveCamera	Define una cámara de perspectiva para ver el contenido de una escena 3D
PipelineStateOverride	Define las anulaciones de estado del pipeline para un único pase
PointLight	Define una luz puntual en la escena
PrincipledMaterial	Permite definir un material para elementos 3D utilizando el flujo de trabajo metal/rugosidad
Quaternion	Proporciona funciones de utilidad para quaternion
QuaternionAnimation	Una PropertyAnimation para quaternions
ReflectionProbe	Define una sonda de reflexión en la escena
RenderExtension	Un tipo base abstracto no creable para extensiones de renderizado
RenderPass	El tipo define un pase de renderizado personalizado para renderizar contenido 3D
RenderPassTexture	Define una textura que se utilizará como objetivo de renderizado en un pase
RenderStats	Proporciona información del renderizado de la escena
RenderablesFilter	Define un filtro para seleccionar a qué renderizables afectar en un pase
Repeater3D	Instancia de una serie de componentes basados en nodos utilizando un modelo proporcionado.
ResourceLoader	Permite precargar los recursos 3D
SceneEnvironment	Permite configurar cómo se renderiza una escena
SetUniformValue	Define un valor que se establecerá durante un único pase
Shader	Componente contenedor para definir el código de sombreado utilizado por los efectos de postprocesamiento
Skeleton	Define una jerarquía de animación esquelética
Skin	Define una animación de esqueleto
SpecularGlossyMaterial	Permite definir un material para elementos 3D utilizando el flujo de trabajo especular/brillo.
SpotLight	Define una luz puntual en la escena
Texture	Define una textura para su uso en escenas 3D
TextureData	Tipo base para datos de textura personalizados
TextureInput	Especifica una textura expuesta a los shaders de un CustomMaterial o Efecto
TextureProviderExtension	Un tipo base abstracto no creable para extensiones de proveedores de texturas
View3D	Proporciona una ventana en la que renderizar una escena 3D
renderTargetBlend	Define los parámetros de mezcla para un único color adjunto de un pase de renderizado

Tipos de valor QML

bounds	Especifica los límites de un modelo
pickResult	Contiene los resultados de una selección

Tipos QML QtQuick3D.Helpers

Importa el módulo QtQuick3D.Helpers con la siguiente sentencia:

import QtQuick3D.Helpers

AxisHelper	Ayudante visual para mostrar los 3 ejes y una rejilla en una escena 3D
CapsuleGeometry	Proporciona geometría para una cápsula
ConeGeometry	Proporciona geometría para un cono
CuboidGeometry	Proporciona geometría para un cuboide
CylinderGeometry	Proporciona geometría para un cilindro
DebugView	Vista para mostrar estadísticas de renderizado y realizar acciones de depuración y desarrollo
ExtendedSceneEnvironment	Un SceneEnvironment que proporciona efectos de renderizado de uso común
ExtrudedTextGeometry	Proporciona geometría para texto extruido
GridGeometry	Un proveedor de geometría personalizada para renderizar rejillas
HeightFieldGeometry	Una geometría de campo de altura
InfiniteGrid	Muestra una cuadrícula infinita
InstanceModel	Define un modelo de datos basado en una tabla de instancias
InstanceRange	Especifica un rango para RandomInstancing
InstanceRepeater	Instancia de componentes basados en una tabla de instancias
LodManager	Gestor que gestiona los cambios de visibilidad del nivel de detalle
LookAtNode	Nodo ayudante que se mantiene automáticamente apuntando a otro nodo
OrbitCameraController	Controlador de cámara que rota alrededor de un origen
PlaneGeometry	Proporciona geometría para un plano
ProceduralMesh	Permite la creación de geometría a partir de QML
ProceduralMeshSubset	Define un subconjunto de ProceduralMesh
ProceduralSkyTextureData	Genera un cubemap HDR skybox
ProceduralTextureData	Permite la creación y población de TextureData desde QML
RandomInstancing	Genera una tabla de instanciación aleatoria
SphereGeometry	Proporciona geometría para una esfera
TorusGeometry	Proporciona geometría para un toroide
WasdController	Controla la posición y orientación de los nodos con las teclas y el ratón

Tipos QML de QtQuick3D.AssetUtils

Importa el módulo QtQuick3D.AssetUtils con la siguiente sentencia:

import QtQuick3D.AssetUtils

RuntimeLoader

Importa un asset 3D en tiempo de ejecución

Tipos QML QtQuick3D.Particles3D

Importa el módulo QtQuick3D.Particles3D con la siguiente declaración:

import QtQuick3D.Particles3D

Affector3D	Los Affectors modifican los atributos de las partículas durante su tiempo de vida
Attractor3D	Atrae partículas hacia una posición o una forma
Direction3D	Las direcciones asignan velocidad a las partículas emitidas
DynamicBurst3D	Ráfagas emisoras dinámicas
EmitBurst3D	Ráfagas emisoras declarativas
Gravity3D	Acelera las partículas hacia un vector de la magnitud especificada en la dirección especificada
LineParticle3D	Partícula de línea
ModelBlendParticle3D	Mezcla el efecto de partículas con un modelo 3D
ModelParticle3D	Partícula que utiliza un modelo 3D Qt Quick
Particle3D	Partícula lógica abstracta
ParticleAbstractShape3D	Tipo base abstracto de formas de partículas
ParticleCustomShape3D	Carga formas de partículas personalizadas para emisores y afectadores
ParticleEmitter3D	Emisor para partículas lógicas
ParticleModelShape3D	Ofrece forma de partícula desde el modelo para emisores y afectadores
ParticleSceneShape3D	Ofrece formas de partículas a partir de una escena para emisores y efectores
ParticleShape3D	Ofrece formas 3D para emisores y efectores
ParticleSystem3D	Un sistema que incluye tipos de partículas, emisores y afectores
ParticleSystem3DLogging	Proporciona información del sistema de partículas
PointRotator3D	Rota partículas alrededor de un punto de giro
Repeller3D	Repelente de partículas
ScaleAffector3D	Afector de escala de partículas
SpriteParticle3D	Partícula que utiliza una textura sprite 2D
SpriteSequence3D	Proporciona características de secuencia de imágenes para las partículas Sprite
TargetDirection3D	Para especificar una dirección hacia la posición objetivo
TrailEmitter3D	Emisor para partículas lógicas de otras partículas
VectorDirection3D	Para especificar una dirección hacia la dirección objetivo
Wander3D	Aplica curvas de onda aleatorias a las partículas

Tipos QML de QtQuick3D.Xr

Importa el módulo QtQuick3D.Xr con la siguiente declaración:

import QtQuick3D.Xr

XrCamera	Rastrea la posición espacial y la orientación desde la que el usuario ve una escena XR
XrController	Un nodo espacial rastreado que rastrea la posición y orientación de un controlador de entrada
XrErrorDialog	Diálogo de error personalizado para aplicaciones PCVR
XrHandModel	Representa un modelo 3D de una mano
XrHapticEffect	Representa un efecto háptico
XrHapticFeedback	Controla la retroalimentación háptica para un controlador XR
XrInputAction	Representa una acción de un controlador de entrada
XrItem	Una superficie virtual en el espacio 3D que puede contener contenido de interfaz de usuario 2D
XrOrigin	Ubicación de origen para el XrView
XrRuntimeInfo	Muestra información sobre el tiempo de ejecución XR
XrSimpleHapticEffect	Permite configurar la háptica del controlador mediante amplitud, duración y frecuencia
XrSpatialAnchor	Rastrea una ubicación específica o un objeto en el espacio real
XrSpatialAnchorListModel	Proporciona un modelo que contiene anclajes espaciales
XrView	Configura la vista de una aplicación XR
XrVirtualMouse	Asigna la entrada del controlador 3D a la entrada del ratón en elementos 2D

Tipos QML obsoletos

Los siguientes tipos QML han quedado obsoletos. Los tipos obsoletos ya no se mantienen. Se proporcionan para que el código fuente antiguo siga funcionando, pero pueden eliminarse en una futura versión. Desaconsejamos encarecidamente el uso de estas clases en código nuevo.

A: AdditiveColorGradient

B: Blur; BrushStrokes

C: ChromaticAberration; ColorMaster

D: DefaultMaterial; DepthOfFieldHQBlur; Desaturate; DistortionRipple; DistortionSphere; DistortionSpiral

E: EdgeDetect; Emboss

F: Flip; Fxaa

G: GaussianBlur

H: HDRBloomTonemap

M: MotionBlur

S: Scatter; SCurveTonemap; Settings

T: TiltShift

V: Vignette

Tipos QML con propiedades o métodos obsoletos

Los siguientes tipos QML contienen una o más propiedades o métodos que han quedado obsoletos. Los miembros obsoletos ya no se mantienen. Se proporcionan para que el código fuente antiguo siga funcionando, pero pueden eliminarse en una versión futura. Desaconsejamos encarecidamente el uso de estos miembros obsoletos en código nuevo. Haga clic en un tipo para ver sus miembros obsoletos.

A: Application

B: BakedLightmap

C: Canvas

D: DragHandler

G: Gravity

H: HeightFieldGeometry

L: Light; Locale

M: Model; MouseEvent

P: PinchHandler

Q: Qt

S: Screen

T: TableView; Text; TouchPoint

X: XrInputAction

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