1 files changed, 55 insertions, 25 deletions
diff --git a/src/render/renderstates/qstencilmask.cpp b/src/render/renderstates/qstencilmask.cpp
index 64cffbe8a..1b9b2cd10 100644
--- a/src/render/renderstates/qstencilmask.cpp
+++ b/src/render/renderstates/qstencilmask.cpp
@@ -37,15 +37,6 @@
 **
 ****************************************************************************/
 
-/*!
- * \class QStencilMask
- * \brief The QStencilMask class controls the front and back writing of
- * individual bits in the stencil planes.
- * \since 5.7
- * \ingroup renderstates
- *
- */
-
 #include "qstencilmask.h"
 #include "qstencilmask_p.h"
 #include <Qt3DRender/private/qrenderstatecreatedchange_p.h>
@@ -55,8 +46,61 @@ QT_BEGIN_NAMESPACE
 namespace Qt3DRender {
 
 /*!
- * The constructor creates a new QStencilMask::QStencilMask instance with the
- * specified \a parent.
+    \class Qt3DRender::QStencilMask
+    \brief The QStencilMask class controls the front and back writing of
+    individual bits in the stencil planes.
+    \since 5.7
+    \ingroup renderstates
+    \inmodule Qt3DRender
+
+    A Qt3DRender::QStencilMask class specifies a write mask for the stencil values
+    after the stencil test. Mask can be specified separately for the front-facing
+    and back-facing polygons. The fragment stencil value is and'd with the mask
+    before it is written to the stencil buffer.
+
+    \sa Qt3DRender::QStencilTest
+ */
+
+/*!
+    \qmltype StencilMask
+    \brief The StencilMask type controls the front and back writing of
+    individual bits in the stencil planes.
+    \since 5.7
+    \ingroup renderstates
+    \inqmlmodule Qt3D.Render
+    \instantiates Qt3DRender::QStencilMask
+    \inherits RenderState
+
+    A StencilMask type specifies the mask for the stencil test. Mask can be specified
+    separately for the front-facing and back-facing polygons. The stencil test reference
+    value and stencil buffer value gets and'd with the mask prior to applying stencil function.
+
+    \sa StencilTest
+ */
+
+/*!
+    \qmlproperty int StencilMask::frontOutputMask
+    Holds the write mask for the fragment stencil values for front-facing polygons.
+*/
+
+/*!
+    \qmlproperty int StencilMask::backOutputMask
+    Holds the write mask for the fragment stencil values for back-facing polygons.
+*/
+
+/*!
+    \property QStencilMask::frontOutputMask
+    Holds the write mask for the fragment stencil values for front-facing polygons.
+*/
+
+/*!
+    \property QStencilMask::backOutputMask
+    Holds the write mask for the fragment stencil values for back-facing polygons.
+*/
+
+/*!
+    The constructor creates a new QStencilMask::QStencilMask instance with the
+    specified \a parent.
  */
 QStencilMask::QStencilMask(QNode *parent)
     : QRenderState(*new QStencilMaskPrivate(), parent)
@@ -68,10 +112,6 @@ QStencilMask::~QStencilMask()
 {
 }
 
-/*!
- * Sets the front output mask to \a mask.
- * \param mask
- */
 void QStencilMask::setFrontOutputMask(uint mask)
 {
     Q_D(QStencilMask);
@@ -81,10 +121,6 @@ void QStencilMask::setFrontOutputMask(uint mask)
     }
 }
 
-/*!
- * Sets the back output mask to \a mask.
- * \param mask
- */
 void QStencilMask::setBackOutputMask(uint mask)
 {
     Q_D(QStencilMask);
@@ -94,18 +130,12 @@ void QStencilMask::setBackOutputMask(uint mask)
     }
 }
 
-/*!
- * \return the front output mask.
- */
 uint QStencilMask::frontOutputMask() const
 {
     Q_D(const QStencilMask);
     return d->m_frontOutputMask;
 }
 
-/*!
- * \return the back output mask.
- */
 uint QStencilMask::backOutputMask() const
 {
     Q_D(const QStencilMask);