Тип QML ThresholdMask

Маскирует элемент-источник другим элементом и применяет значение порога. Подробнее...

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

Свойства

• cached : bool
• maskSource : variant
• source : variant
• spread : real
• threshold : real

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

Поведение маскирования можно контролировать с помощью значения threshold для пикселей маски.

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

Пример

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

import QtQuick 2.12
import QtGraphicalEffects 1.12

Item {
    width: 300
    height: 300

    Image {
        id: background
        anchors.fill: parent
        source: "images/checker.png"
        smooth: true
        fillMode: Image.Tile
    }

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

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

    ThresholdMask {
        anchors.fill: bug
        source: bug
        maskSource: mask
        threshold: 0.4
        spread: 0.2
    }
}

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

cached : bool

Это свойство позволяет кэшировать пиксели выходного эффекта для повышения производительности рендеринга.

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

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

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

maskSource : variant

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

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

source : variant

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

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

spread : real

Это свойство определяет плавность краев маски вблизи значения альфа порога threshold. Установка spread в 0.0 использует маску обычно со заданным порогом. Установка более высоких значений spread сглаживает переход от прозрачных пикселей маски к непрозрачным пикселям маски, добавляя интерполированные значения между ними.

Значение варьируется от 0.0 (резкий край маски) до 1.0 (гладкий край маски). По умолчанию свойство установлено в 0.0.

threshold : real

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

Значение варьируется от 0.0 (значение альфа 0) до 1.0 (значение альфа 255). По умолчанию свойство установлено в 0.0.