Тип QML DropShadow

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

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

Свойства

• cached : псевдоним
• color : псевдоним
• horizontalOffset : вещественное
• radius : целое
• samples : псевдоним
• source : псевдоним
• spread : псевдоним
• transparentBorder : псевдоним
• verticalOffset : вещественное

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

Эффект DropShadow размывает альфа-канал входного изображения, изменяет цвет результата и помещает его позади исходного объекта, чтобы создать мягкую тень. Цвет тени можно изменить, используя свойство color. Положение тени можно изменить с помощью свойств horizontalOffset и verticalOffset.

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

Если источник статичен, свойство cached можно установить для выделения другого буфера, чтобы избежать выполнения размытия каждый раз при отрисовке.

Примечание: Этот эффект доступен при работе с 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
    }

    DropShadow {
        anchors.fill: butterfly
        horizontalOffset: 3
        verticalOffset: 3
        radius: 8.0
        samples: 17
        color: "#80000000"
        source: butterfly
    }
}

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

cached : псевдоним

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

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

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

color : псевдоним

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

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

horizontalOffset : вещественное

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

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

radius : целое

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

Идеальное размытие достигается путём выбора samples и radius таким образом, чтобы samples = 1 + radius * 2, например:

По умолчанию свойство установлено в floor(samples/2).

samples : псевдоним

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

В идеале это значение должно быть в два раза больше наибольшего требуемого значения радиуса плюс единица, например:

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

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

source : alias

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

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

spread : alias

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

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

transparentBorder : alias

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

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

На изображении слева прямоугольник с прозрачными границами и размытыми краями, в то время как справа - нет:

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

import QtQuick 2.12
import QtGraphicalEffects 1.12

Rectangle {
    width: 180
    height: 100

    Row {
        anchors.centerIn: parent
        spacing: 16

        Rectangle {
            id: normalRect
            width: 60
            height: 60
            radius: 10
            color: "steelblue"
            layer.enabled: true
            layer.effect: DropShadow {
                transparentBorder: false
                horizontalOffset: 8
                verticalOffset: 8
            }
        }

        Rectangle {
            id: transparentBorderRect
            width: 60
            height: 60
            radius: 10
            color: "steelblue"
            layer.enabled: true
            layer.effect: DropShadow {
                transparentBorder: true
                horizontalOffset: 8
                verticalOffset: 8
            }
        }
    }
}

verticalOffset : вещественный

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

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