diff options
author | Gunnar Sletta <gunnar@sletta.org> | 2014-09-28 12:26:55 +0200 |
---|---|---|
committer | Gunnar Sletta <gunnar@sletta.org> | 2014-09-29 12:19:16 +0200 |
commit | 2bd7438d77c8544d263c51be432206970eae5ccf (patch) | |
tree | 6b632a39ef54b24779183d93e895e0873dfaa41c /src/quick/doc | |
parent | 26387cf498843ce10dd4411d538e1e44a823b8a8 (diff) |
Give Item::layer documentation some much needed love.
Change-Id: I31e038d961d3aa09a36db0c091c4e4910e395c2e
Reviewed-by: Laszlo Agocs <laszlo.agocs@digia.com>
Diffstat (limited to 'src/quick/doc')
-rw-r--r-- | src/quick/doc/images/qml-blending-layered.png | bin | 0 -> 7582 bytes | |||
-rw-r--r-- | src/quick/doc/images/qml-blending-nonlayered.png | bin | 0 -> 7707 bytes | |||
-rw-r--r-- | src/quick/doc/images/qml-shadereffect-layereffect.png | bin | 0 -> 22264 bytes | |||
-rw-r--r-- | src/quick/doc/images/qml-shadereffect-nolayereffect.png | bin | 0 -> 26718 bytes | |||
-rw-r--r-- | src/quick/doc/images/qml-shadereffect-opacitymask.png | bin | 0 -> 15661 bytes | |||
-rw-r--r-- | src/quick/doc/snippets/qml/layerblending.qml | 111 | ||||
-rw-r--r-- | src/quick/doc/snippets/qml/layerwitheffect.qml | 111 | ||||
-rw-r--r-- | src/quick/doc/snippets/qml/opacitymask.qml | 114 |
8 files changed, 336 insertions, 0 deletions
diff --git a/src/quick/doc/images/qml-blending-layered.png b/src/quick/doc/images/qml-blending-layered.png Binary files differnew file mode 100644 index 0000000000..fa1c24a98e --- /dev/null +++ b/src/quick/doc/images/qml-blending-layered.png diff --git a/src/quick/doc/images/qml-blending-nonlayered.png b/src/quick/doc/images/qml-blending-nonlayered.png Binary files differnew file mode 100644 index 0000000000..265abf6530 --- /dev/null +++ b/src/quick/doc/images/qml-blending-nonlayered.png diff --git a/src/quick/doc/images/qml-shadereffect-layereffect.png b/src/quick/doc/images/qml-shadereffect-layereffect.png Binary files differnew file mode 100644 index 0000000000..44b05a9949 --- /dev/null +++ b/src/quick/doc/images/qml-shadereffect-layereffect.png diff --git a/src/quick/doc/images/qml-shadereffect-nolayereffect.png b/src/quick/doc/images/qml-shadereffect-nolayereffect.png Binary files differnew file mode 100644 index 0000000000..f21e3f0c4e --- /dev/null +++ b/src/quick/doc/images/qml-shadereffect-nolayereffect.png diff --git a/src/quick/doc/images/qml-shadereffect-opacitymask.png b/src/quick/doc/images/qml-shadereffect-opacitymask.png Binary files differnew file mode 100644 index 0000000000..e056aa763b --- /dev/null +++ b/src/quick/doc/images/qml-shadereffect-opacitymask.png diff --git a/src/quick/doc/snippets/qml/layerblending.qml b/src/quick/doc/snippets/qml/layerblending.qml new file mode 100644 index 0000000000..0ef23465a5 --- /dev/null +++ b/src/quick/doc/snippets/qml/layerblending.qml @@ -0,0 +1,111 @@ +/**************************************************************************** +** +** Copyright (C) 2014 Gunnar Sletta <gunnar@sletta.org> +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation of the Qt Toolkit. +** +** $QT_BEGIN_LICENSE:BSD$ +** You may use this file under the terms of the BSD license as follows: +** +** "Redistribution and use in source and binary forms, with or without +** modification, are permitted provided that the following conditions are +** met: +** * Redistributions of source code must retain the above copyright +** notice, this list of conditions and the following disclaimer. +** * Redistributions in binary form must reproduce the above copyright +** notice, this list of conditions and the following disclaimer in +** the documentation and/or other materials provided with the +** distribution. +** * Neither the name of Digia Plc and its Subsidiary(-ies) nor the names +** of its contributors may be used to endorse or promote products derived +** from this software without specific prior written permission. +** +** +** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." +** +** $QT_END_LICENSE$ +** +****************************************************************************/ + +import QtQuick 2.0 + +Item { + width: 300 + height: 200 + + // The checkers background + ShaderEffect { + id: tileBackground + anchors.fill: parent + + property real tileSize: 10 + property color color1: Qt.rgba(0.9, 0.9, 0.9, 1); + property color color2: Qt.rgba(0.85, 0.85, 0.85, 1); + + property size pixelSize: Qt.size(width / tileSize, height / tileSize); + + fragmentShader: + " + uniform lowp vec4 color1; + uniform lowp vec4 color2; + uniform highp vec2 pixelSize; + varying highp vec2 qt_TexCoord0; + void main() { + highp vec2 tc = sign(sin(3.14152 * qt_TexCoord0 * pixelSize)); + if (tc.x != tc.y) + gl_FragColor = color1; + else + gl_FragColor = color2; + } + " + } + + + Row { + height: 100 + anchors.centerIn: parent + spacing: 50 + +//! [non-layered] +Item { + id: nonLayered + + opacity: 0.5 + + width: 100 + height: 100 + + Rectangle { width: 80; height: 80; border.width: 1 } + Rectangle { x: 20; y: 20; width: 80; height: 80; border.width: 1 } +} +//! [non-layered] + +//! [layered] +Item { + id: layered + + opacity: 0.5 + + layer.enabled: true + + width: 100 + height: 100 + + Rectangle { width: 80; height: 80; border.width: 1 } + Rectangle { x: 20; y: 20; width: 80; height: 80; border.width: 1 } +} +//! [layered] + + } +} diff --git a/src/quick/doc/snippets/qml/layerwitheffect.qml b/src/quick/doc/snippets/qml/layerwitheffect.qml new file mode 100644 index 0000000000..8cfac0bb19 --- /dev/null +++ b/src/quick/doc/snippets/qml/layerwitheffect.qml @@ -0,0 +1,111 @@ +/**************************************************************************** +** +** Copyright (C) 2014 Gunnar Sletta <gunnar@sletta.org> +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation of the Qt Toolkit. +** +** $QT_BEGIN_LICENSE:BSD$ +** You may use this file under the terms of the BSD license as follows: +** +** "Redistribution and use in source and binary forms, with or without +** modification, are permitted provided that the following conditions are +** met: +** * Redistributions of source code must retain the above copyright +** notice, this list of conditions and the following disclaimer. +** * Redistributions in binary form must reproduce the above copyright +** notice, this list of conditions and the following disclaimer in +** the documentation and/or other materials provided with the +** distribution. +** * Neither the name of Digia Plc and its Subsidiary(-ies) nor the names +** of its contributors may be used to endorse or promote products derived +** from this software without specific prior written permission. +** +** +** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." +** +** $QT_END_LICENSE$ +** +****************************************************************************/ + +import QtQuick 2.2 + +Rectangle { + id: root + width: 320 + height: 320 + + gradient: Gradient { + GradientStop { position: 0; color: "steelblue" } + GradientStop { position: 1; color: "black" } + } + + property real cx: width / 2; + property real cy: height / 2; + property real boxSize: root.width * 0.2; + property real radius: width / 4; + + +//! [1] +Item { + id: layerRoot + layer.enabled: true + layer.effect: ShaderEffect { + fragmentShader: " + uniform lowp sampler2D source; // this item + uniform lowp float qt_Opacity; // inherited opacity of this item + varying highp vec2 qt_TexCoord0; + void main() { + lowp vec4 p = texture2D(source, qt_TexCoord0); + lowp float g = dot(p.xyz, vec3(0.344, 0.5, 0.156)); + gl_FragColor = vec4(g, g, g, p.a) * qt_Opacity; + }" + } +//! [1] + + anchors.fill: parent + + + Repeater { + id: repeater + model: 200 + + Rectangle { + id: box + + property real t: index / (repeater.model - 1); + + width: 0 + height: 0 + x: root.cx - Math.sin(Math.PI * 2 * t) * root.radius; + y: root.cy - Math.cos(Math.PI * 2 * t) * root.radius; + + Rectangle { + width: root.boxSize + height: root.boxSize + anchors.centerIn: parent + color: Qt.hsla(box.t, 0.5, 0.5); + border.color: "white" + antialiasing: true; + rotation: box.t * 360; +// RotationAnimator on rotation { +// from: box.t * 360; +// to: box.t * 360 + 360; +// duration: 7592; +// loops: Animation.Infinite +// } + } + } + } + } +} diff --git a/src/quick/doc/snippets/qml/opacitymask.qml b/src/quick/doc/snippets/qml/opacitymask.qml new file mode 100644 index 0000000000..e458f810ea --- /dev/null +++ b/src/quick/doc/snippets/qml/opacitymask.qml @@ -0,0 +1,114 @@ +/**************************************************************************** +** +** Copyright (C) 2014 Gunnar Sletta <gunnar@sletta.org> +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation of the Qt Toolkit. +** +** $QT_BEGIN_LICENSE:BSD$ +** You may use this file under the terms of the BSD license as follows: +** +** "Redistribution and use in source and binary forms, with or without +** modification, are permitted provided that the following conditions are +** met: +** * Redistributions of source code must retain the above copyright +** notice, this list of conditions and the following disclaimer. +** * Redistributions in binary form must reproduce the above copyright +** notice, this list of conditions and the following disclaimer in +** the documentation and/or other materials provided with the +** distribution. +** * Neither the name of Digia Plc and its Subsidiary(-ies) nor the names +** of its contributors may be used to endorse or promote products derived +** from this software without specific prior written permission. +** +** +** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." +** +** $QT_END_LICENSE$ +** +****************************************************************************/ + +import QtQuick 2.0 + +Item { + id: root + width: 480 + height: 320 + + // The checkers background + ShaderEffect { + id: tileBackground + anchors.fill: parent + + property real tileSize: 20 + property color color1: Qt.hsla(0, 0, 0.1); + property color color2: Qt.hsla(0, 0, 0.2); + + property size pixelSize: Qt.size(width / tileSize, height / tileSize); + + fragmentShader: + " + uniform lowp vec4 color1; + uniform lowp vec4 color2; + uniform highp vec2 pixelSize; + varying highp vec2 qt_TexCoord0; + void main() { + highp vec2 tc = sign(sin(3.14152 * qt_TexCoord0 * pixelSize)); + if (tc.x != tc.y) + gl_FragColor = color1; + else + gl_FragColor = color2; + } + " + } + +//! [1] + Rectangle { + id: gradientRect; + width: 10 + height: 10 + gradient: Gradient { + GradientStop { position: 0; color: "white" } + GradientStop { position: 1; color: "steelblue" } + } + visible: false; // should not be visible on screen. + layer.enabled: true; + layer.smooth: true + } + + Text { + id: textItem + font.pixelSize: 48 + text: "Gradient Text" + anchors.centerIn: parent + layer.enabled: true + // This item should be used as the 'mask' + layer.samplerName: "maskSource" + layer.effect: ShaderEffect { + property var colorSource: gradientRect; + fragmentShader: " + uniform lowp sampler2D colorSource; + uniform lowp sampler2D maskSource; + uniform lowp float qt_Opacity; + varying highp vec2 qt_TexCoord0; + void main() { + gl_FragColor = + texture2D(colorSource, qt_TexCoord0) + * texture2D(maskSource, qt_TexCoord0).a + * qt_Opacity; + } + " + } + } +//! [1] +} |