Spec-Zone.ru › Qt 5.9

Тип QML ConicalGradient

Рисует конический градиент. Подробнее...

Заявление об импорте: import QtGraphicalEffects 1.0
С момента: QtGraphicalEffects 1.0
Наследует:

Элемент

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

Свойства

  • угол : вещественное число
  • кэшированный : логическое значение
  • градиент : Градиент
  • горизонтальноеСмещение : вещественное число
  • источник : значение
  • вертикальноеСмещение : вещественное число

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

Градиент определяется двумя или более цветами, которые плавно смешиваются. Цвета начинаются от указанного угла и заканчиваются на углу, значение которого на 360 градусов больше.

Примененный эффект

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

Пример

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

import QtQuick 2.0
import QtGraphicalEffects 1.0

Item {
    width: 300
    height: 300

    ConicalGradient {
        anchors.fill: parent
        angle: 0.0
        gradient: Gradient {
            GradientStop { position: 0.0; color: "white" }
            GradientStop { position: 1.0; color: "black" }
        }
    }
}

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

угол : вещественное число

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

Примеры вывода с разными значениями угла

угол: 0 угол: 45 угол: 185
горизонтальноеСмещение: 0 горизонтальноеСмещение: 0 горизонтальноеСмещение: 0
вертикальноеСмещение: 0 вертикальноеСмещение: 0 вертикальноеСмещение: 0

кэшированный : логическое значение

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

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

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

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

градиент : Градиент

Градиент определяется двумя или более цветами, которые плавно смешиваются. Цвета задаются как набор дочерних элементов GradientStop, каждый из которых определяет положение на градиенте (от 0,0 до 1,0) и цвет. Положение каждого GradientStop определяется свойством position. Цвет определяется свойством color.

Примеры вывода с разными значениями градиента

градиент:
Gradient {
  GradientStop {
     position: 0.000
     color: Qt.rgba(1, 0, 0, 1)
  }
  GradientStop {
     position: 0.167
     color: Qt.rgba(1, 1, 0, 1)
  }
  GradientStop {
     position: 0.333
     color: Qt.rgba(0, 1, 0, 1)
  }
  GradientStop {
     position: 0.500
     color: Qt.rgba(0, 1, 1, 1)
  }
  GradientStop {
     position: 0.667
     color: Qt.rgba(0, 0, 1, 1)
  }
  GradientStop {
     position: 0.833
     color: Qt.rgba(1, 0, 1, 1)
  }
  GradientStop {
     position: 1.000
     color: Qt.rgba(1, 0, 0, 1)
  }
}
градиент:
Gradient {
  GradientStop {
     position: 0.0
     color: "#F0F0F0"
  }
  GradientStop {
     position: 0.5
     color: "#000000"
  }
  GradientStop {
     position: 1.0
     color: "#F0F0F0"
  }
}
градиент:
Gradient {
  GradientStop {
     position: 0.0
     color: "#00000000"
  }
  GradientStop {
    position: 1.0
    color: "#FF000000"
  }
}
угол: 0 угол: 0 угол: 0
горизонтальноеСмещение: 0 горизонтальноеСмещение: 0 горизонтальноеСмещение: 0
вертикальноеСмещение: 0 вертикальноеСмещение: 0 вертикальноеСмещение: 0

горизонтальноеСмещение : вещественное число

Свойства horizontalOffset и вертикальноеСмещение определяют смещение в пикселях центральной точки градиента относительно центра элемента.

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

Примеры вывода с разными значениями горизонтальногоСмещения

горизонтальноеСмещение: -50 горизонтальноеСмещение: 0 горизонтальноеСмещение: 50
угол: 0 угол: 0 угол: 0
вертикальноеСмещение: 0 вертикальноеСмещение: 0 вертикальноеСмещение: 0

источник : значение

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

Примеры вывода с разными значениями источника

источник: не определено источник:
угол: 0 угол: 0
горизонтальноеСмещение: 0 горизонтальноеСмещение: 0
вертикальноеСмещение: 0 вертикальноеСмещение: 0

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

вертикальноеСмещение : вещественное число

Свойства горизонтальноеСмещение и вертикальноеСмещение определяют смещение в пикселях центральной точки градиента относительно центра элемента.

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

Примеры вывода с разными значениями горизонтальногоСмещения

горизонтальноеСмещение: -50 горизонтальноеСмещение: 0 горизонтальноеСмещение: 50
угол: 0 угол: 0 угол: 0
вертикальноеСмещение: 0 вертикальноеСмещение: 0 вертикальноеСмещение: 0

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.9/qml-qtgraphicaleffects-conicalgradient.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API