En esta página

Qt Quick 3D QML Types

Esta es la interfaz QML para utilizar el renderizador espacial y el grafo de escena. Por el momento, todo el contenido 3D pasa por texturas fuera de pantalla (FBO) para que puedan integrarse en escenas de « Qt Quick » (como un « QQuickItem »).

Importa el módulo QtQuick3D con la siguiente instrucción:

import QtQuick3D

Tipos QML de QtQuick3D

AddDefine

Añade una definición de preprocesador a la compilación del sombreador para una pasada

BakedLightmap

Especifica la configuración del mapa de luces precalculado 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 una pasada de un efecto

Camera

Define una clase base abstracta para cámaras

ColorAttachment

Define un complemento de color para un paso de renderizado

Command

Supertipo de comandos que se ejecutarán como parte de un paso en un efecto

ContentLayer

Singleton que proporciona constantes de indicadores de capa para agrupar y filtrar nodos de escena

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 el sombreado de modelos

DebugSettings

Se utiliza para configurar los ajustes de depuración

DepthStencilAttachment

Define un accesorio de profundidad-plantilla para un RenderPass

DepthTextureAttachment

Define un accesorio de textura de profundidad para un paso

DirectionalLight

Define una luz direccional en la escena

Effect

Componente base para crear un efecto de posprocesamiento

FileInstancing

Permite leer tablas de instancias desde un archivo

Fog

Especifica la configuración de la niebla para una escena

FrustumCamera

Define una PerspectiveCamera con un frustum personalizado

Geometry

Tipo base para geometría personalizada

InstanceList

Permite especificar manualmente la instanciación 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 la configuración de horneado de mapas de luz 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 funcionalidades comunes a los materiales

Model

Permite cargar datos de un modelo 3D

MorphTarget

Define las propiedades de un objetivo de morfo

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 paso de renderizado en un efecto

PerspectiveCamera

Define una cámara en perspectiva para visualizar el contenido de una escena 3D

PipelineStateOverride

Define las modificaciones del estado del proceso para un único paso

PointLight

Define una luz puntual en la escena

PrincipledMaterial

Permite definir un material para elementos 3D utilizando el flujo de trabajo de metal/rugosidad

Quaternion

Proporciona funciones de utilidad para cuaterniones

QuaternionAnimation

Una PropertyAnimation para cuaterniones

ReflectionProbe

Define una sonda de reflexión en la escena

RenderExtension

Un tipo base abstracto no creable para extensiones de renderizado

RenderPass

Define un paso de renderizado personalizado para renderizar contenido 3D

RenderPassTexture

Define una textura que se utilizará como destino de renderizado en un paso

RenderStats

Proporciona información sobre el renderizado de la escena

RenderablesFilter

Define un filtro para seleccionar a qué elementos renderizables afecta un paso

Repeater3D

Instancia una serie de componentes basados en nodos utilizando un modelo proporcionado

ResourceLoader

Permite la precarga de recursos 3D

SceneEnvironment

Permite configurar cómo se renderiza una escena

SetUniformValue

Define un valor que se establecerá durante una sola pasada

Shader

Componente contenedor para definir el código de shader utilizado por los efectos de posprocesamiento

Skeleton

Define una jerarquía de animación esquelética

Skin

Define una animación de skinning

SkyMaterial

Renderiza un cielo procedural y genera datos de iluminación basados en imágenes

SpecularGlossyMaterial

Permite definir un material para elementos 3D utilizando el flujo de trabajo de especularidad/brillo

SpotLight

Define un foco en la escena

SubRenderPass

Renderiza una subsección del trabajo dentro del mismo destino de renderizado que el RenderPass principal

Texture

Define una textura para su uso en escenas 3D

TextureData

Tipo base para datos de texturas personalizadas

TextureInput

Especifica una textura expuesta a los sombreadores de un CustomMaterial o un Effect

TextureProviderExtension

Tipo base abstracto para extensiones de renderizado que generan una textura

View3D

Proporciona una ventana de visualización en la que renderizar una escena 3D

Tipos de valor de QML

bounds

Especifica los límites de un modelo

pickResult

Contiene los resultados de una selección

renderTargetBlend

Define los parámetros de mezcla para un único adjunto de color de una pasada de renderizado

Tipos QML de QtQuick3D.Helpers

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

import QtQuick3D.Helpers

AxisHelper

Ayuda visual para mostrar los tres ejes y una cuadrícula en una escena 3D

CapsuleGeometry

Proporciona la geometría de una cápsula

ConeGeometry

Proporciona la geometría de un cono

CuboidGeometry

Proporciona geometría para un paralelepípedo

CylinderGeometry

Proporciona la geometría de 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 personalizado para renderizar cuadrículas

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 componentes basándose en una tabla de instancias

LodManager

Gestor que se encarga de los cambios en la visibilidad del nivel de detalle

LookAtNode

Un nodo auxiliar que se mantiene automáticamente apuntando a otro nodo

OrbitCameraController

Controlador de cámara que gira alrededor de un origen

PlaneGeometry

Proporciona geometría para un plano

ProceduralMesh

Permite crear geometría a partir de QML

ProceduralMeshSubset

Define un subconjunto de un ProceduralMesh

ProceduralSkyTextureData

Genera un mapa cúbico de cielo HDR (skybox)

ProceduralTextureData

Permite crear y rellenar datos de textura (TextureData) desde QML

QuadTextureProvider

Se utiliza para renderizar una textura cuadrangular utilizando un sombreador de fragmentos personalizado

RandomInstancing

Genera una tabla de instanciación aleatoria

RenderOutputProvider

Se utiliza como puente para acceder a las texturas proporcionadas en los pases

SimpleQuadRenderer

Renderiza un cuadrilátero con textura a pantalla completa en el destino de renderizado principal

SphereGeometry

Proporciona geometría para una esfera

TorusGeometry

Proporciona geometría para un toro

WasdController

Controla la posición y la 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 instrucción:

import QtQuick3D.AssetUtils

RuntimeLoader

Importa un recurso 3D en tiempo de ejecución

Tipos QML de QtQuick3D.Particles3D

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

import QtQuick3D.Particles3D

Affector3D

Los afectores modifican los atributos de las partículas durante su ciclo de vida

Attractor3D

Atrae a las partículas hacia una posición o una forma

Direction3D

Las direcciones asignan velocidad a las partículas emitidas

DynamicBurst3D

Ráfagas de emisores dinámicos

EmitBurst3D

Ráfagas de emisores declarativas

Gravity3D

Acelera las partículas hacia un vector de la magnitud especificada en la dirección indicada

LineParticle3D

Partícula lineal

ModelBlendParticle3D

Combina un 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 afectores

ParticleEmitter3D

Emisor para partículas lógicas

ParticleModelShape3D

Ofrece formas de partículas a partir de modelos para emisores y afectores

ParticleSceneShape3D

Ofrece formas de partículas a partir de una escena para emisores y afectores

ParticleShape3D

Ofrece formas 3D para emisores y afectores

ParticleSystem3D

Un sistema que incluye tipos de partículas, emisores y afectores

ParticleSystem3DLogging

Proporciona información sobre el sistema de partículas

PointRotator3D

Gira las partículas alrededor de un punto de pivote

Repeller3D

Repelente de partículas

ScaleAffector3D

Afector de escala de partículas

SpriteParticle3D

Partícula que utiliza una textura de sprite 2D

SpriteSequence3D

Ofrece funciones de secuencia de imágenes para las partículas de sprite

TargetDirection3D

Para especificar una dirección hacia la posición de destino

TrailEmitter3D

Emisor de partículas lógicas procedentes de otras partículas

VectorDirection3D

Para especificar una dirección hacia la posición de destino

Wander3D

Aplica curvas de onda aleatorias a las partículas

Tipos QML de QtQuick3D.Xr

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

import QtQuick3D.Xr

XrCamera

Realiza un seguimiento de la posición espacial y la orientación desde las que el usuario visualiza una escena XR

XrController

Un nodo espacial rastreado que realiza un seguimiento de la posición y la orientación de un controlador de entrada

XrErrorDialog

Cuadro de 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 de un controlador XR

XrInputAction

Representa una acción de un mando de entrada

XrItem

Una superficie virtual en el espacio 3D que puede albergar contenido de interfaz de usuario en 2D

XrOrigin

Ubicación de origen para XrView

XrRuntimeInfo

Muestra información sobre el entorno de ejecución XR

XrSimpleHapticEffect

Permite configurar la háptica del mando mediante amplitud, duración y frecuencia

XrSpatialAnchor

Realiza un seguimiento de una ubicación u objeto específico en el espacio real

XrSpatialAnchorListModel

Proporciona un modelo que contiene anclajes espaciales

XrView

Configura la vista para una aplicación XR

XrVirtualMouse

Asigna las entradas del controlador 3D a las del ratón en elementos 2D

Tipos QML obsoletos

Los siguientes tipos QML han quedado obsoletos. Los tipos obsoletos ya no reciben mantenimiento. Se proporcionan para que el código fuente antiguo siga funcionando, pero podrían eliminarse en una versión futura. Recomendamos encarecidamente no utilizar estas clases en código nuevo.

Tipos QML con propiedades o métodos obsoletos

Los siguientes tipos QML contienen una o más propiedades o métodos que ahora están 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. Recomendamos encarecidamente no utilizar estos miembros obsoletos en código nuevo. Haz clic en un tipo para ver sus miembros obsoletos.

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