QAlphaTest Class

class Qt3DRender::QAlphaTest

The QAlphaTest class specify alpha reference test. More...

Header: #include <QAlphaTest>
CMake: find_package(Qt6 COMPONENTS 3drender REQUIRED)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
Since: Qt 5.7
Instantiated By: AlphaTest
Inherits: Qt3DRender::QRenderState

Public Types

enum AlphaFunction { Never, Always, Less, LessOrEqual, Equal, …, NotEqual }

Properties

Public Functions

Qt3DRender::QAlphaTest::AlphaFunction alphaFunction() const
float referenceValue() const

Public Slots

void setAlphaFunction(Qt3DRender::QAlphaTest::AlphaFunction alphaFunction)
void setReferenceValue(float referenceValue)

Signals

void alphaFunctionChanged(Qt3DRender::QAlphaTest::AlphaFunction alphaFunction)
void referenceValueChanged(float referenceValue)

Detailed Description

As the OpenGL documentation explains; The alpha test discards a fragment conditional on the outcome of a comparison between the incoming fragment's alpha value and a constant reference value.

Member Type Documentation

enum QAlphaTest::AlphaFunction

Enumeration for the alpha function values

ConstantValueDescription
Qt3DRender::QAlphaTest::Never0x0200Never pass alpha test
Qt3DRender::QAlphaTest::Always0x0207Always pass alpha test
Qt3DRender::QAlphaTest::Less0x0201Pass alpha test if fragment alpha is less than reference value
Qt3DRender::QAlphaTest::LessOrEqual0x0203Pass alpha test if fragment alpha is less than or equal to reference value
Qt3DRender::QAlphaTest::Equal0x0202Pass alpha test if fragment alpha is equal to reference value
Qt3DRender::QAlphaTest::GreaterOrEqual0x0206Pass alpha test if fragment alpha is greater than or equal to reference value
Qt3DRender::QAlphaTest::Greater0x0204Pass alpha test if fragment alpha is greater than reference value
Qt3DRender::QAlphaTest::NotEqual0x0205Pass alpha test if fragment alpha is not equal to reference value

Property Documentation

alphaFunction : AlphaFunction

Holds the alpha function used by the alpha test. Default is Never.

Access functions:

Qt3DRender::QAlphaTest::AlphaFunction alphaFunction() const
void setAlphaFunction(Qt3DRender::QAlphaTest::AlphaFunction alphaFunction)

Notifier signal:

void alphaFunctionChanged(Qt3DRender::QAlphaTest::AlphaFunction alphaFunction)

referenceValue : float

Holds the reference value used by the alpha test. Default is 0.0. When set, the value is clamped between 0 and 1.

Access functions:

float referenceValue() const
void setReferenceValue(float referenceValue)

Notifier signal:

void referenceValueChanged(float referenceValue)

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