Doc: Modularized documentation.

-moved API documentation in QML files
-moved snippets, images, and qdoc files to src/effects/doc
-deleted old .pri and .qdocconf files
-fixed relative paths

Change-Id: I4e757e707b5f93a215506f8c2cbb7eb1f2321d4c
Reviewed-by: Geir Vattekar <geir.vattekar@digia.com>

1 files changed, 61 insertions, 0 deletions

diff --git a/src/effects/OpacityMask.qml b/src/effects/OpacityMask.qml
index 825002c..c0b8a43 100644
--- a/src/effects/OpacityMask.qml
+++ b/src/effects/OpacityMask.qml
@@ -41,10 +41,71 @@
 import QtQuick 2.0
 import "private"
 
+/*!
+    \qmltype OpacityMask
+    \inqmlmodule QtGraphicalEffects 1.0
+    \since QtGraphicalEffects 1.0
+    \inherits QtQuick2::Item
+    \ingroup qtgraphicaleffects-mask
+    \brief Masks the source item with another item.
+
+    \table
+    \header
+        \li Source
+        \li MaskSource
+        \li Effect applied
+    \row
+        \li \image Original_bug.png
+        \li \image OpacityMask_mask.png
+        \li \image OpacityMask_bug.png
+    \endtable
+
+    \section1 Example
+
+    The following example shows how to apply the effect.
+    \snippet OpacityMask-example.qml example
+
+*/
 Item {
     id: rootItem
+
+    /*!
+        This property defines the source item that is going to be masked.
+    */
     property variant source
+
+    /*!
+        This property defines the item that is going to be used as the mask. The
+        mask item gets rendered into an intermediate pixel buffer and the alpha
+        values from the result are used to determine the source item's pixels
+        visibility in the display.
+
+        \table
+        \header
+            \li Original
+            \li Mask
+            \li Effect applied
+        \row
+            \li \image Original_bug.png
+            \li \image OpacityMask_mask.png
+            \li \image OpacityMask_bug.png
+        \endtable
+    */
     property variant maskSource
+
+    /*!
+        This property allows the effect output pixels to be cached in order to
+        improve the rendering performance.
+
+        Every time the source or effect properties are changed, the pixels in
+        the cache must be updated. Memory consumption is increased, because an
+        extra buffer of memory is required for storing the effect output.
+
+        It is recommended to disable the cache when the source or the effect
+        properties are animated.
+
+        By default, the property is set to \c false.
+    */
     property bool cached: false
 
     SourceProxy {