En esta página

Qt 3D Render C++ Classes

El módulo Qt 3D Render contiene funcionalidad para soportar renderizado 2D y 3D usando Qt 3D. Más...

Este módulo está obsoleto desde la versión 6.8. Desaconsejamos su uso en código nuevo.

Espacios de nombres

Qt3DRender

Contiene clases que permiten el renderizado 2D y 3D

Qt3DRender::Render

Espacio de nombres utilizado para acceder a las clases Renderer y QRenderPlugin

Clases

Qt3DRender::QAbstractLight

Encapsula un objeto QAbstractLight en una escena Qt 3D

Qt3DRender::QAbstractRayCaster

Una clase base abstracta para el ray casting en escenas 3D

Qt3DRender::QAbstractTexture

Una clase base para proporcionar texturas

Qt3DRender::QAbstractTextureImage

Encapsula la información necesaria para crear una imagen de textura OpenGL

Qt3DRender::QAlphaCoverage

Habilitar el modo de muestreo múltiple de cobertura alfa

Qt3DRender::QAlphaTest

Especifica la prueba de referencia alfa

Qt3DRender::QBlendEquation

Especifica la ecuación utilizada tanto para la ecuación de mezcla RGB como para la ecuación de mezcla Alfa

Qt3DRender::QBlendEquationArguments

Encapsula la información de mezcla: especifica cómo los valores entrantes (lo que se va a dibujar) van a afectar a los valores existentes (lo que ya está dibujado)

Qt3DRender::QBlitFramebuffer

Nodo FrameGraph para transferir un rectángulo de valores de píxeles de una región de un objetivo de renderizado a otra.

Qt3DRender::QBufferCapture

Intercambia datos de búfer entre la GPU y la CPU

Qt3DRender::QCamera

Define un punto de vista a través del cual se renderizará la escena

Qt3DRender::QCameraLens

Qt3DRender::QCameraLens especifica la matriz de proyección que se usará para definir una Cámara para una escena 3D

Qt3DRender::QCameraSelector

Clase para permitir la selección de la cámara a utilizar

Qt3DRender::QClearBuffers

Clase para limpiar buffers

Qt3DRender::QClipPlane

Permite un plano de recorte OpenGL adicional que puede estar en los shaders usando gl_ClipDistance

Qt3DRender::QColorMask

Permite especificar que componentes de color deben ser escritos en el frame buffer actualmente enlazado

Qt3DRender::QComputeCommand

QComponent para emitir trabajo para el compute shader en GPU

Qt3DRender::QCullFace

Especifica si se activa el culling de la cara frontal o trasera

Qt3DRender::QDebugOverlay

Habilita una superposición visual con detalles de la escena

Qt3DRender::QDepthRange

Habilita la reasignación de valores de profundidad escritos en el búfer de profundidad

Qt3DRender::QDepthTest

Comprueba el valor de profundidad del sombreador de fragmentos con la profundidad de una muestra que se está escribiendo.

Qt3DRender::QDirectionalLight

Encapsula un objeto Luz Direccional en una escena Qt 3D

Qt3DRender::QDispatchCompute

Nodo FrameGraph para emitir trabajo para el compute shader en la GPU

Qt3DRender::QDithering

Habilitar dithering

Qt3DRender::QEffect

Clase base para efectos en una escena Qt 3D

Qt3DRender::QEnvironmentLight

Encapsular un objeto de luz ambiental en una escena Qt 3D

Qt3DRender::QFilterKey

Almacenamiento de claves de filtro y sus valores

Qt3DRender::QFrameGraphNode

Clase base de todos los nodos de configuración de FrameGraph

Qt3DRender::QFrontFace

Define los polígonos frontales y traseros

Qt3DRender::QFrustumCulling

Habilita el frustum culling para el FrameGraph

Qt3DRender::QGeometryRenderer

Encapsula el renderizado de la geometría

Qt3DRender::QGraphicsApiFilter

Identifica la API necesaria para la QTechnique adjunta

Qt3DRender::QLayer

Forma de filtrar las entidades que se renderizarán

Qt3DRender::QLayerFilter

Controla las capas dibujadas en una rama de FrameGraph

Qt3DRender::QLevelOfDetail

Manera de controlar la complejidad de las entidades renderizadas en función de su tamaño en la pantalla

Qt3DRender::QLevelOfDetailBoundingSphere

Volumen esférico simple, definido por su centro y radio

Qt3DRender::QLevelOfDetailSwitch

Permite activar entidades secundarias en función de la distancia o del tamaño de la pantalla

Qt3DRender::QLineWidth

Especifica la anchura de las líneas rasterizadas

Qt3DRender::QMaterial

Proporciona una clase abstracta que debería ser la base de todas las clases de componentes materiales de una escena

Qt3DRender::QMemoryBarrier

Clase para colocar una barrera de memoria

Qt3DRender::QMesh

Un cargador de malla personalizado

Qt3DRender::QMultiSampleAntiAliasing

Habilita el antialiasing multimuestra

Qt3DRender::QNoDepthMask

Deshabilitar la escritura en profundidad

Qt3DRender::QNoDraw

Cuando un nodo Qt3DRender::QNoDraw está presente en una rama FrameGraph, esto evita que el renderizador renderice cualquier primitiva

Qt3DRender::QNoPicking

Cuando un nodo Qt3DRender::QNoPicking está presente en una rama FrameGraph, esto evita que el aspecto de renderizado realice una selección de picking para la rama dada.

Qt3DRender::QObjectPicker

Instantiza un componente que puede utilizarse para interactuar con una QEntity mediante un proceso conocido como picking

Qt3DRender::QPaintedTextureImage

Una QAbstractTextureImage que puede ser escrita a través de un QPainter

Qt3DRender::QParameter

Proporciona almacenamiento para un par de nombre y valor. Esto mapea a un shader uniforme

Qt3DRender::QPickEvent

Contiene información cuando un objeto es recogido

Qt3DRender::QPickLineEvent

Mantiene información cuando un segmento de una línea es seleccionado

Qt3DRender::QPickPointEvent

Contiene información cuando se selecciona un segmento de una nube de puntos.

Qt3DRender::QPickTriangleEvent

Contiene información cuando se selecciona un triángulo

Qt3DRender::QPickingProxy

Puede ser utilizado para proporcionar un QGeometryView alternativo utilizado sólo para la recolección

Qt3DRender::QPickingSettings

Especifica cómo se gestiona la recogida de entidades

Qt3DRender::QPointLight

Encapsula un objeto Point Light en una escena Qt 3D

Qt3DRender::QPointSize

Especifica el tamaño de los puntos rasterizados. Puede establecerse estáticamente o mediante programas de sombreado.

Qt3DRender::QPolygonOffset

Establece la escala y los pasos para calcular los valores de profundidad para los desplazamientos de polígonos

Qt3DRender::QProximityFilter

Selecciona las entidades que se encuentran dentro de un umbral de distancia de una entidad objetivo

Qt3DRender::QRasterMode

El estado de renderizado permite controlar el tipo de rasterización a realizar

Qt3DRender::QRayCaster

Qt3DRender::QRayCaster se utiliza para realizar pruebas de lanzamiento de rayos en coordenadas 3d del mundo

Qt3DRender::QRayCasterHit

Detalles de un golpe al lanzar un rayo a través de un modelo

Qt3DRender::QRenderAspect

Clase

Qt3DRender::QRenderCapabilities

Contiene ajustes relacionados con los motores de render disponibles

Qt3DRender::QRenderCapture

Nodo Frame Graph para captura de render

Qt3DRender::QRenderCaptureReply

Recibe el resultado de la solicitud de captura de render

Qt3DRender::QRenderPass

Encapsula un Pase de Renderizado

Qt3DRender::QRenderPassFilter

Proporciona almacenamiento para vectores de Claves de Filtro y Parámetros

Qt3DRender::QRenderSettings

Mantiene los ajustes relacionados con el proceso de renderizado y aloja el FrameGraph activo

Qt3DRender::QRenderState

Una clase base abstracta para todos los estados de renderizado

Qt3DRender::QRenderStateSet

El nodo FrameGraph ofrece una forma de especificar un conjunto de objetos QRenderState que se aplicarán durante la ejecución de una rama del framegraph

Qt3DRender::QRenderSurfaceSelector

Ofrece una forma de especificar la superficie de renderizado

Qt3DRender::QRenderTarget

Encapsula un destino (normalmente un objeto frame buffer) en el que el renderizador puede renderizar

Qt3DRender::QRenderTargetOutput

Permite especificar un anexo de un objetivo de renderizado (ya sea una textura de color, una textura de profundidad, etc... )

Qt3DRender::QRenderTargetSelector

Permite especificar un objetivo de renderizado

Qt3DRender::QSceneLoader

Permite cargar una escena existente

Qt3DRender::QScissorTest

Descarta los fragmentos que quedan fuera de una determinada porción rectangular de la pantalla

Qt3DRender::QScreenRayCaster

Realiza una prueba de proyección de rayos basada en las coordenadas de la pantalla

Qt3DRender::QSeamlessCubemap

Permite el filtrado de texturas cubemap sin fisuras

Qt3DRender::QSetFence

FrameGraphNode utilizado para insertar una valla en el flujo de comandos gráficos

Qt3DRender::QShaderData

Proporciona una forma de especificar valores de un Bloque Uniforme o una estructura de sombreado

Qt3DRender::QShaderImage

Proporciona acceso de imagen a los programas de sombreado

Qt3DRender::QShaderProgram

Encapsula un Programa Shader

Qt3DRender::QShaderProgramBuilder

Genera el contenido de un Programa Shader a partir de gráficos cargados

Qt3DRender::QSharedGLTexture

Permite utilizar un textureId de un contexto OpenGL separado en una escena Qt 3D

Qt3DRender::QSortPolicy

Proporciona almacenamiento para los tipos de clasificación a utilizar

Qt3DRender::QSpotLight

Encapsula un objeto Spot Light en una escena Qt 3D

Qt3DRender::QStencilMask

Controla la escritura anterior y posterior de bits individuales en los planos del esténcil

Qt3DRender::QStencilOperation

Especifica el funcionamiento del esténcil

Qt3DRender::QStencilOperationArguments

Establece las acciones a tomar cuando fallan las pruebas de stencil y profundidad

Qt3DRender::QStencilTest

Especifica los argumentos para la prueba de esténcil

Qt3DRender::QStencilTestArguments

Especifica los argumentos para la prueba de esténcil

Qt3DRender::QSubtreeEnabler

Habilita o deshabilita subárboles enteros de nodos framegraph

Qt3DRender::QTechnique

Encapsula una técnica

Qt3DRender::QTechniqueFilter

Un QFrameGraphNode utilizado para seleccionar QTechniques a utilizar

Qt3DRender::QTexture1D

Una QAbstractTexture con un formato de destino Target1D

Qt3DRender::QTexture1DArray

Una QAbstractTexture con un Target1DArray formato de destino

Qt3DRender::QTexture2D

Una QAbstractTexture con formato de destino Target2D

Qt3DRender::QTexture2DArray

A QAbstractTexture con formato de destino Target2DArray

Qt3DRender::QTexture2DMultisample

A QAbstractTexture con formato Target2DMultisample

Qt3DRender::QTexture2DMultisampleArray

A QAbstractTexture con formato Target2DMultisampleArray

Qt3DRender::QTexture3D

A QAbstractTexture con formato de destino Target3D

Qt3DRender::QTextureBuffer

A QAbstractTexture con formato de destino TargetBuffer

Qt3DRender::QTextureCubeMap

A QAbstractTexture con formato de destino TargetCubeMap

Qt3DRender::QTextureCubeMapArray

Una QAbstractTexture con un TargetCubeMapArray formato de destino

Qt3DRender::QTextureData

Almacena información de la textura como el objetivo, altura, anchura, profundidad, capas, envoltura, y si mipmaps están habilitados

Qt3DRender::QTextureDataUpdate

Mantiene el contenido y la información necesaria para realizar actualizaciones parciales del contenido de una textura

Qt3DRender::QTextureImage

Encapsula la información necesaria para crear una imagen de textura OpenGL a partir de una fuente de imagen

Qt3DRender::QTextureImageData

Almacena datos que representan una textura

Qt3DRender::QTextureImageDataGenerator

Proporciona datos de imagen de textura para QAbstractTextureImage

Qt3DRender::QTextureLoader

Maneja la carga de la textura y la configuración de sus propiedades

Qt3DRender::QTextureRectangle

Una QAbstractTexture con un formato de destino TargetRectangle

Qt3DRender::QTextureWrapMode

Define el modo de envoltura que un Qt3DRender::QAbstractTexture debe aplicar a una textura

Qt3DRender::QViewport

Un viewport en la Escena Qt3D

Qt3DRender::QWaitFence

FrameGraphNode usado para esperar a que una valla en el flujo de comandos gráficos sea señalada

Descripción detallada

El módulo Qt 3D Render proporciona un aspecto, componentes y otros tipos de soporte necesarios para implementar el renderizado 2D y 3D como parte del framework Qt 3D.

Para utilizar clases de este módulo, añada esta directiva en los archivos C++:

#include <Qt3DRender>

Para enlazar con la biblioteca C++ correspondiente, añada lo siguiente al archivo de proyecto qmake:

QT += 3drender

Las clases, tipos y funciones se declaran en el espacio de nombres Qt3DRender.

Visión general

El aspecto Qt 3D Render ofrece soporte para la configuración basada en datos como se describe en Qt 3D Render Framegraph.

Selección de un backend de renderizado

El aspecto Render viene con dos backends de renderizado.

  • OpenGL backend (ES 2, ES 3.2, GL 2, GL 3, GL 3.2, GL 4.3)
  • RHI backend (ES 2, GL, DirectX, Vulkan, Metal)

Si te centras exclusivamente en OpenGL y utilizas funciones específicas de OpenGL, es mejor que utilices el backend OpenGL. Este es el backend OpenGL que Qt 3D utiliza exclusivamente en la serie Qt 5.

Para casos en los que no estés usando características específicas de OpenGL y quieras apuntar a diferentes plataformas que puedan tener OpenGL obsoleto, usar el backend RHI es una mejor alternativa.

Para seleccionar el backend de renderizado, la variable de entorno QT3D_RENDERER debe establecerse como "opengl" o "rhi". Por defecto es OpenGL.

Cuando se utiliza el backend RHI, se puede forzar aún más el backend interno RHI estableciendo el QSG_RHI_BACKEND a uno de los siguientes valores:

  • opengl -> RHI OpenGL backend
  • gl -> RHI OpenGL backend
  • gles2 -> RHI OpenGL backend
  • metal -> RHI Metal backend
  • vulkan -> RHI Vulkan backend
  • d3d11 -> RHI DirectX 11 backend

Si no se especifica, RHI utilizará por defecto lo que deduzca que es el mejor backend para la plataforma.

Referencia

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