Qt 3D Portabilidad de la renderización a RHI
A modo de recordatorio, en Qt 6, « Qt 3D » utilizará por defecto su motor de renderizado RHI.
Sigue siendo posible utilizar el backend OpenGL más antiguo de la serie Qt 5. Esto se puede habilitar estableciendo la variable de entorno QT3D_RENDERER en «opengl». Esto es necesario en caso de que no desees adaptar tu aplicación para que sea compatible con RHI o en caso de que necesites funciones que actualmente están limitadas o no están disponibles en el backend de RHI.
Actualmente, las limitaciones conocidas de RHI son:
- No hay forma de realizar un blit explícito (hay que hacerlo manualmente renderizando un cuadrilátero en un framebuffer)
- No se puede establecer MemoryBarrier de forma explícita
- No están disponibles todos los formatos de textura
- Actualmente no se admite el dibujo indirecto
- Actualmente no se admiten los shaders de geometría.
- Los distintos backends de RHI pueden admitir diferentes conjuntos de características.
Ten cuidado también de no confundir el backend de renderizado OpenGL de Qt 3D con el backend de renderizado RHI de Qt 3D, que se ejecuta sobre OpenGL.
RHI es una abstracción sobre diferentes API gráficas. Esto significa que, en una plataforma determinada, varios RHI podrían utilizar varios backends.
Para forzar a RHI a utilizar un backend concreto, la variable de entorno QSG_RHI_BACKEND debe establecerse en uno de los siguientes valores: opengl, vulkan, metal o directx.
Añadir técnicas compatibles con RHI
Para añadir compatibilidad con RHI a un material o efecto de « Qt 3D », se necesitará una nueva técnica destinada a RHI. En el momento de redactar este documento, la única versión válida de RHI es la 1.0.
Material {
Effect {
techniques: [
Technique {
id: gl3Technique
graphicsApiFilter {
api: GraphicsApiFilter.OpenGL
profile: GraphicsApiFilter.CoreProfile
majorVersion: 3
minorVersion: 1
}
renderPasses: RenderPass {
id: gl3Pass
shaderProgram: ShaderProgram {
...
}
}
},
Technique {
id: rhiTechnique
graphicsApiFilter {
api: GraphicsApiFilter.RHI
profile: GraphicsApiFilter.NoProfile
majorVersion: 1
minorVersion: 0
}
renderPasses: RenderPass {
id: rhiPass
shaderProgram: ShaderProgram {
...
}
}
}
]
}
}QMaterial *material = new QMaterial();
QEffect *effect = new QEffect();
// Set the effect on the material
material->setEffect(effect);
{
QTechnique *gl3Technique = new QTechnique();
QRenderPass *gl3Pass = new QRenderPass();
QShaderProgram *glShader = new QShaderProgram();
// Set the shader on the render pass
gl3Pass->setShaderProgram(glShader);
// Add the pass to the technique
gl3Technique->addRenderPass(gl3Pass);
// Set the targeted GL version for the technique
gl3Technique->graphicsApiFilter()->setApi(QGraphicsApiFilter::OpenGL);
gl3Technique->graphicsApiFilter()->setMajorVersion(3);
gl3Technique->graphicsApiFilter()->setMinorVersion(1);
gl3Technique->graphicsApiFilter()->setProfile(QGraphicsApiFilter::CoreProfile);
// Add the technique to the effect
effect->addTechnique(gl3Technique);
}
{
QTechnique *rhiTechnique = new QTechnique();
QRenderPass *rhiPass = new QRenderPass();
QShaderProgram *rhiShader = new QShaderProgram();
// Set the shader on the render pass
rhiPass->setShaderProgram(glShader);
// Add the pass to the technique
rhiTechnique->addRenderPass(rhiPass);
// Set the targeted RHI version for the technique
rhiTechnique->graphicsApiFilter()->setApi(QGraphicsApiFilter::RHI);
rhiTechnique->graphicsApiFilter()->setMajorVersion(1);
rhiTechnique->graphicsApiFilter()->setMinorVersion(0);
rhiTechnique->graphicsApiFilter()->setProfile(QGraphicsApiFilter::NoProfile);
// Add the technique to the effect
effect->addTechnique(rhiTechnique);
}Creación de un sombreador compatible con RHI
Independientemente del backend sobre el que se ejecute RHI, los shaders se escribirán en GLSL 450.
Los cambios son mínimos en comparación con versiones anteriores de GLSL; las principales diferencias apreciables residen en la forma de declarar los uniformes. Ten en cuenta también que es necesario definir la ubicación de las variables de entrada y salida, y que estas deben ser coherentes entre las distintas etapas del sombreador.
#version 450 core
layout(location = 0) in vec3 vertexPosition;
layout(location = 0) out vec3 worldPosition;
layout(std140, binding = 0) uniform qt3d_render_view_uniforms {
mat4 viewMatrix;
mat4 projectionMatrix;
mat4 uncorrectedProjectionMatrix;
mat4 clipCorrectionMatrix;
mat4 viewProjectionMatrix;
mat4 inverseViewMatrix;
mat4 inverseProjectionMatrix;
mat4 inverseViewProjectionMatrix;
mat4 viewportMatrix;
mat4 inverseViewportMatrix;
vec4 textureTransformMatrix;
vec3 eyePosition;
float aspectRatio;
float gamma;
float exposure;
float time;
float yUpInNDC;
float yUpInFBO;
};
layout(std140, binding = 1) uniform qt3d_command_uniforms {
mat4 modelMatrix;
mat4 inverseModelMatrix;
mat4 modelViewMatrix;
mat3 modelNormalMatrix;
mat4 inverseModelViewMatrix;
mat4 modelViewProjection;
mat4 inverseModelViewProjectionMatrix;
};
void main()
{
...
}Para obtener más detalles sobre los cambios en los shaders, consulta Qt3DRender::QShaderProgram
Qt 3D Extras
Los materiales de « Qt 3D » se han portado a RHI.
© 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.