Тип QML MaskedBlur

Применяет эффект размытия с переменной интенсивностью. Подробнее...

• Список всех членов, включая унаследованные

Свойства

• cached : псевдоним
• maskSource : псевдоним
• radius : псевдоним
• samples : псевдоним
• source : псевдоним

Подробное описание

MaskedBlur эффект смягчает изображение, размывая его. Интенсивность размытия можно контролировать для каждого пикселя с помощью maskSource, так что некоторые части источника размываются сильнее, чем другие.

Выполнение размытия в реальном времени является дорогостоящей операцией. Полностьюэкранное размытие Гаусса даже с умеренным количеством выборок будет работать только со скоростью 60 кадров в секунду на высокопроизводительной графической аппаратуре.

Примечание: Этот эффект доступен при работе с OpenGL.

Пример

Следующий пример показывает, как применить эффект.

import QtQuick 2.12
import QtGraphicalEffects 1.12

Item {
    width: 300
    height: 300

    Image {
        id: bug
        source: "images/bug.jpg"
        sourceSize: Qt.size(parent.width, parent.height)
        smooth: true
        visible: false
    }

    LinearGradient {
        id: mask
        anchors.fill: bug
        gradient: Gradient {
            GradientStop { position: 0.2; color: "#ffffffff" }
            GradientStop { position: 0.5; color: "#00ffffff" }
        }
        start: Qt.point(0, 0)
        end: Qt.point(300, 0)
        visible: false
    }

    MaskedBlur {
        anchors.fill: bug
        source: bug
        maskSource: mask
        radius: 16
        samples: 24
    }
}

Документация по свойствам

cached : псевдоним

Это свойство позволяет кэшировать пиксели вывода эффекта для повышения производительности рендеринга. Каждый раз, когда изменяются свойства источника или эффекта, пиксели в кэше должны быть обновлены. Потребление памяти увеличивается, так как для хранения вывода эффекта требуется дополнительный буфер памяти.

Рекомендуется отключить кэш, когда свойства источника или эффекта анимируются.

По умолчанию свойство установлено в false.

maskSource : псевдоним

Это свойство определяет элемент, который контролирует конечную интенсивность размытия. Значение канала альфа пикселей из maskSource определяет фактический радиус размытия, который будет использован для размытия соответствующего пикселя источника.

Непрозрачные пиксели maskSource производят размытие с указанным радиусом, в то время как прозрачные пиксели полностью подавляют размытие. Полупрозрачные пиксели maskSource производят размытие с радиусом, который интерполируется в соответствии с уровнем прозрачности пикселя.

radius : псевдоним

Это свойство определяет расстояние соседних пикселей, которые влияют на размытие отдельного пикселя. Более большой радиус увеличивает эффект размытия.

В зависимости от значения радиуса, значение samples должно быть установлено достаточно большим, чтобы обеспечить визуальное качество.

Значение изменяется от 0,0 (без размытия) до бесконечности. По умолчанию свойство установлено в 0.0 (без размытия).

samples : псевдоним

Это свойство определяет количество выборок, взятых на пиксель при выполнении расчёта размытия. Большее значение обеспечивает лучшее качество, но медленнее рендерится.

В идеале это значение должно быть в два раза больше наибольшего необходимого значения радиуса плюс 1, например, если радиус анимирован между 0,0 и 4,0, samples следует установить в 9.

По умолчанию свойство установлено в 9.

Это свойство не предназначено для анимации. Изменение этого свойства может привести к перекомпиляции базовых шейдеров OpenGL.

source : псевдоним

Это свойство определяет элемент-источник, который будет размыт.

Примечание: Не допускается встраивание эффекта в себя, например, установкой источника в родительский элемент эффекта.