QAlphaTest Class

class Qt3DRender::QAlphaTest

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

Header: #include <QAlphaTest>
qmake: QT += 3drender
Since: Qt 5.7
Instantiated By: AlphaTest
Inherits: Qt3DRender::QRenderState

This class was introduced in Qt 5.7.

Public Types

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

Properties

Public Functions

AlphaFunction alphaFunction() const
float referenceValue() const

Public Slots

void setAlphaFunction(AlphaFunction alphaFunction)
void setReferenceValue(float referenceValue)

Signals

void alphaFunctionChanged(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:

AlphaFunction alphaFunction() const
void setAlphaFunction(AlphaFunction alphaFunction)

Notifier signal:

void alphaFunctionChanged(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)