Тип QML InnerShadow

Генерирует цветной и размытый оттенок внутри источника. Подробнее...

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

Свойства

• cached : bool
• color : цвет
• fast : bool
• horizontalOffset : real
• radius : real
• samples : int
• source : variant
• spread : real
• verticalOffset : real

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

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

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

Пример

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

import QtQuick 2.12
import QtGraphicalEffects 1.12

Item {
    width: 300
    height: 300

    Rectangle {
        anchors.fill: parent
    }

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

    InnerShadow {
        anchors.fill: butterfly
        radius: 8.0
        samples: 16
        horizontalOffset: -3
        verticalOffset: 3
        color: "#b0000000"
        source: butterfly
    }
}

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

cached : bool

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

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

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

color : color

Это свойство определяет значение RGBA цвета, используемого для тени.

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

fast : bool

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

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

horizontalOffset : real

Свойства horizontalOffset и verticalOffset определяют смещение отрисовываемой тени относительно позиции элемента InnerShadow. Часто элемент InnerShadow привязан таким образом, что заполняет элемент-источник. В этом случае, если свойства horizontalOffset и verticalOffset установлены в 0, тень отрисовывается полностью внутри элемента-источника. Изменяя свойства смещения, тень можно позиционировать относительно элемента-источника.

Значения изменяются от -inf до inf. По умолчанию свойства установлены в 0.

radius : real

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

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

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

samples : int

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

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

Значение изменяется от 0 до 32. По умолчанию свойство установлено в 0.

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

Если свойство fast установлено в true, это свойство не оказывает влияния.

source : variant

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

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

spread : real

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

Значение изменяется от 0,0 до 1,0. По умолчанию свойство установлено в 0.5.

verticalOffset : real

Свойства horizontalOffset и verticalOffset определяют смещение отрисованной тени по сравнению с положением элемента InnerShadow. Часто элемент InnerShadow закреплен таким образом, что заполняет элемент-источник. В этом случае, если свойства horizontalOffset и verticalOffset установлены в 0, тень отрисовывается полностью внутри элемента-источника. Изменяя свойства смещения, тень можно расположить относительно элемента-источника.

Значения изменяются от -∞ до +∞. По умолчанию свойства установлены в 0.