Тип QML ThresholdMask

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

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

Свойства

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

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

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

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

Пример

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

import QtQuick 2.0
import QtGraphicalEffects 1.0

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

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

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

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

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

maskSource : variant

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

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

source : variant

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

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

spread : real

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

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

threshold : real

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

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