Back to Qt.io
Contact Us Blog Download Qt
Sur cette page

Qt3DRender::QMultiSampleAntiAliasing Class

class Qt3DRender::QMultiSampleAntiAliasing

Activer l'anticrénelage multi-échantillon. En savoir plus...

En-tête : #include <qmultisampleantialiasing.h>
CMake : find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake : QT += 3drender
En QML : MultiSampleAntiAliasing
Hérite de : Qt3DRender::QRenderState
Statut : Obsolète

Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.

Fonctions publiques

QMultiSampleAntiAliasing(Qt3DCore::QNode *parent = nullptr)

Description détaillée

Une classe « Qt3DRender::QMultiSampleAntiAliasing » permet l'anticrénelage multi-échantillonnage.

Elle peut être ajoutée à une classe ` QRenderPass ` en appelant la méthode ` QRenderPass::addRenderState()` :

QRenderPass *renderPass = new QRenderPass();

QMultiSampleAntiAliasing *msaa = new QMultiSampleAntiAliasing();
renderPass->addRenderState(msaa);

Ou à une cible de rendu ( QRenderStateSet ) en appelant la fonction ` QRenderStateSet::addRenderState()` :

QRenderStateSet *renderStateSet = new QRenderStateSet();

QMultiSampleAntiAliasing *msaa = new QMultiSampleAntiAliasing();
renderStateSet->addRenderState(msaa);

Pour que le multisampling prenne effet, la cible de rendu doit avoir été allouée avec le multisampling activé :

QTexture2DMultisample *colorTex = new QTexture2DMultisample;
colorTex->setFormat(QAbstractTexture::RGBA8_UNorm);
colorTex->setWidth(1024);
colorTex->setHeight(1024);

QRenderTargetOutput *color = new QRenderTargetOutput;
color->setAttachmentPoint(QRenderTargetOutput::Color0);
color->setTexture(colorTex);

QTexture2DMultisample *depthStencilTex = new QTexture2DMultisample;
depthStencilTex->setFormat(QAbstractTexture::RGBA8_UNorm);
depthStencilTex->setWidth(1024);
depthStencilTex->setHeight(1024);

QRenderTargetOutput *depthStencil = new QRenderTargetOutput;
depthStencil->setAttachmentPoint(QRenderTargetOutput::DepthStencil);
depthStencil->setTexture(depthStencilTex);

Qt3DRender::QRenderTarget *renderTarget = new Qt3DRender::QRenderTarget;
renderTarget->addOutput(color);
renderTarget->addOutput(depthStencil);

De plus, le code du shader doit utiliser des types d’échantillonneur de multisampling et la fonction `texelFetch()` à la place de `texture()`.

Par exemple, si vous avez un code tel que

#version 150

uniform sampler2D colorTexture;
in vec2 texCoord;
out vec4 fragColor;

void main()
{
    fragColor = texture(colorTexture, texCoord);
}

vous pouvez le réécrire ainsi :

#version 150

uniform sampler2DMS colorTexture;
in vec2 texCoord;
out vec4 fragColor;

void main()
{
    ivec2 tc = ivec2(floor(textureSize(colorTexture) * texCoord));
    vec4 c = texelFetch(colorTexture, tc, 0) +
                texelFetch(colorTexture, tc, 1) +
                texelFetch(colorTexture, tc, 2) +
                texelFetch(colorTexture, tc, 3);
    fragColor = c / 4.0;
}

Remarque : lorsque vous utilisez OpenGL comme API graphique, la fonction glEnable(GL_MULTISAMPLE) sera appelée si QMultiSampleAntiAliasing a été ajouté aux états de rendu.

Documentation des fonctions membres

[explicit] QMultiSampleAntiAliasing::QMultiSampleAntiAliasing(Qt3DCore::QNode *parent = nullptr)

Le constructeur crée une nouvelle instance de ` QMultiSampleAntiAliasing::QMultiSampleAntiAliasing ` avec l'parent` spécifiée.

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