/**************************************************************************** ** ** Copyright (C) 2017 The Qt Company Ltd. ** Contact: https://www.qt.io/licensing/ ** ** This file is part of the Qt Graphical Effects module. ** ** $QT_BEGIN_LICENSE:LGPL$ ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and The Qt Company. For licensing terms ** and conditions see https://www.qt.io/terms-conditions. For further ** information use the contact form at https://www.qt.io/contact-us. ** ** GNU Lesser General Public License Usage ** Alternatively, this file may be used under the terms of the GNU Lesser ** General Public License version 3 as published by the Free Software ** Foundation and appearing in the file LICENSE.LGPL3 included in the ** packaging of this file. Please review the following information to ** ensure the GNU Lesser General Public License version 3 requirements ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 2.0 or (at your option) the GNU General ** Public license version 3 or any later version approved by the KDE Free ** Qt Foundation. The licenses are as published by the Free Software ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 ** included in the packaging of this file. Please review the following ** information to ensure the GNU General Public License requirements will ** be met: https://www.gnu.org/licenses/gpl-2.0.html and ** https://www.gnu.org/licenses/gpl-3.0.html. ** ** $QT_END_LICENSE$ ** ****************************************************************************/ import QtQuick 2.0 import QtGraphicalEffects.private 1.0 /*! \qmltype FastBlur \inqmlmodule QtGraphicalEffects \since QtGraphicalEffects 1.0 \inherits QtQuick2::Item \ingroup qtgraphicaleffects-blur \brief Applies a fast blur effect to one or more source items. FastBlur offers lower blur quality than \l{QtGraphicalEffects::GaussianBlur}{GaussianBlur}, but it is faster to render. The FastBlur effect softens the source content by blurring it with algorithm which uses the source content downscaling and bilinear filtering. Use this effect in situations where the source content is rapidly changing and the highest possible blur quality is not needed. \table \header \li Source \li Effect applied \row \li \image Original_bug.png \li \image FastBlur_bug.png \endtable \note This effect is available when running with OpenGL. s \section1 Example The following example shows how to apply the effect. \snippet FastBlur-example.qml example */ Item { id: rootItem /*! This property defines the source item that is going to be blurred. \note It is not supported to let the effect include itself, for instance by setting source to the effect's parent. */ property variant source /*! This property defines the distance of the neighboring pixels which affect the blurring of an individual pixel. A larger radius increases the blur effect. FastBlur algorithm may internally reduce the accuracy of the radius in order to provide good rendering performance. The value ranges from 0.0 (no blur) to inf. Visual quality of the blur is reduced when radius exceeds value 64. By default, the property is set to \c 0.0 (no blur). \table \header \li Output examples with different blur values \li \li \row \li \image FastBlur_radius1.png \li \image FastBlur_radius2.png \li \image FastBlur_radius3.png \row \li \b { radius: 0 } \li \b { radius: 32 } \li \b { radius: 64 } \endtable */ property real radius: 0.0 /*! This property defines the blur behavior near the edges of the item, where the pixel blurring is affected by the pixels outside the source edges. If the property is set to \c true, the pixels outside the source are interpreted to be transparent, which is similar to OpenGL clamp-to-border extension. The blur is expanded slightly outside the effect item area. If the property is set to \c false, the pixels outside the source are interpreted to contain the same color as the pixels at the edge of the item, which is similar to OpenGL clamp-to-edge behavior. The blur does not expand outside the effect item area. By default, the property is set to \c false. \table \header \li Output examples with different transparentBorder values \li \li \row \li \image FastBlur_transparentBorder1.png \li \image FastBlur_transparentBorder2.png \row \li \b { transparentBorder: false } \li \b { transparentBorder: true } \row \li \l radius: 64 \li \l radius: 64 \endtable */ property bool transparentBorder: false /*! 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 { id: sourceProxy input: rootItem.source } ShaderEffectSource { id: cacheItem anchors.fill: shaderItem visible: rootItem.cached sourceItem: shaderItem live: true hideSource: visible smooth: rootItem.radius > 0 } /*! \internal */ property string __internalBlurVertexShader: "qrc:/qt-project.org/imports/QtGraphicalEffects/shaders/fastblur_internal.vert" /*! \internal */ property string __internalBlurFragmentShader: "qrc:/qt-project.org/imports/QtGraphicalEffects/shaders/fastblur_internal.frag" ShaderEffect { id: level0 property variant source: sourceProxy.output anchors.fill: parent visible: false smooth: true } ShaderEffectSource { id: level1 width: Math.ceil(shaderItem.width / 32) * 32 height: Math.ceil(shaderItem.height / 32) * 32 sourceItem: level0 hideSource: rootItem.visible sourceRect: transparentBorder ? Qt.rect(-64, -64, shaderItem.width, shaderItem.height) : Qt.rect(0, 0, 0, 0) visible: false smooth: rootItem.radius > 0 } ShaderEffect { id: effect1 property variant source: level1 property real yStep: 1/height property real xStep: 1/width anchors.fill: level2 visible: false smooth: true vertexShader: __internalBlurVertexShader fragmentShader: __internalBlurFragmentShader } ShaderEffectSource { id: level2 width: level1.width / 2 height: level1.height / 2 sourceItem: effect1 hideSource: rootItem.visible visible: false smooth: true } ShaderEffect { id: effect2 property variant source: level2 property real yStep: 1/height property real xStep: 1/width anchors.fill: level3 visible: false smooth: true vertexShader: __internalBlurVertexShader fragmentShader: __internalBlurFragmentShader } ShaderEffectSource { id: level3 width: level2.width / 2 height: level2.height / 2 sourceItem: effect2 hideSource: rootItem.visible visible: false smooth: true } ShaderEffect { id: effect3 property variant source: level3 property real yStep: 1/height property real xStep: 1/width anchors.fill: level4 visible: false smooth: true vertexShader: __internalBlurVertexShader fragmentShader: __internalBlurFragmentShader } ShaderEffectSource { id: level4 width: level3.width / 2 height: level3.height / 2 sourceItem: effect3 hideSource: rootItem.visible visible: false smooth: true } ShaderEffect { id: effect4 property variant source: level4 property real yStep: 1/height property real xStep: 1/width anchors.fill: level5 visible: false smooth: true vertexShader: __internalBlurVertexShader fragmentShader: __internalBlurFragmentShader } ShaderEffectSource { id: level5 width: level4.width / 2 height: level4.height / 2 sourceItem: effect4 hideSource: rootItem.visible visible: false smooth: true } ShaderEffect { id: effect5 property variant source: level5 property real yStep: 1/height property real xStep: 1/width anchors.fill: level6 visible: false smooth: true vertexShader: __internalBlurVertexShader fragmentShader: __internalBlurFragmentShader } ShaderEffectSource { id: level6 width: level5.width / 2 height: level5.height / 2 sourceItem: effect5 hideSource: rootItem.visible visible: false smooth: true } Item { id: dummysource width: 1 height: 1 visible: false } ShaderEffectSource { id: dummy width: 1 height: 1 sourceItem: dummysource visible: false smooth: false live: false } ShaderEffect { id: shaderItem property variant source1: level1 property variant source2: level2 property variant source3: level3 property variant source4: level4 property variant source5: level5 property variant source6: level6 property real lod: Math.sqrt(rootItem.radius / 64.0) * 1.2 - 0.2 property real weight1 property real weight2 property real weight3 property real weight4 property real weight5 property real weight6 x: transparentBorder ? -64 : 0 y: transparentBorder ? -64 : 0 width: transparentBorder ? parent.width + 128 : parent.width height: transparentBorder ? parent.height + 128 : parent.height function weight(v) { if (v <= 0.0) return 1.0 if (v >= 0.5) return 0.0 return 1.0 - v * 2.0 } function calculateWeights() { var w1 = weight(Math.abs(lod - 0.100)) var w2 = weight(Math.abs(lod - 0.300)) var w3 = weight(Math.abs(lod - 0.500)) var w4 = weight(Math.abs(lod - 0.700)) var w5 = weight(Math.abs(lod - 0.900)) var w6 = weight(Math.abs(lod - 1.100)) var sum = w1 + w2 + w3 + w4 + w5 + w6; weight1 = w1 / sum; weight2 = w2 / sum; weight3 = w3 / sum; weight4 = w4 / sum; weight5 = w5 / sum; weight6 = w6 / sum; upateSources() } function upateSources() { var sources = new Array(); var weights = new Array(); if (weight1 > 0) { sources.push(level1) weights.push(weight1) } if (weight2 > 0) { sources.push(level2) weights.push(weight2) } if (weight3 > 0) { sources.push(level3) weights.push(weight3) } if (weight4 > 0) { sources.push(level4) weights.push(weight4) } if (weight5 > 0) { sources.push(level5) weights.push(weight5) } if (weight6 > 0) { sources.push(level6) weights.push(weight6) } for (var j = sources.length; j < 6; j++) { sources.push(dummy) weights.push(0.0) } source1 = sources[0] source2 = sources[1] source3 = sources[2] source4 = sources[3] source5 = sources[4] source6 = sources[5] weight1 = weights[0] weight2 = weights[1] weight3 = weights[2] weight4 = weights[3] weight5 = weights[4] weight6 = weights[5] } Component.onCompleted: calculateWeights() onLodChanged: calculateWeights() fragmentShader: "qrc:/qt-project.org/imports/QtGraphicalEffects/shaders/fastblur.frag" } }