Класс QSGSimpleMaterialShader

Класс QSGSimpleMaterialShader предоставляет удобный способ создания пользовательских материалов на основе OpenGL для графического узла сцены. Подробнее...

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

Открытые функции

Макросы

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

Предупреждение: Этот вспомогательный класс функционален только при использовании OpenGL-бэкенда графического узла сцены Qt Quick.

В API QSGMaterial и QSGMaterialShader требуется некоторое количество шаблонного кода для создания функционального материала, класс QSGSimpleMaterialShader пытается скрыть часть этого кода с помощью шаблонов.

QSGSimpleMaterialShader::vertexShader() и QSGSimpleMaterialShader::fragmentShader() используются для указания фактического кода шейдера. Имена вершинных атрибутов должны быть перечислены в QSGSimpleMaterialShader::attributes().

QSGSimpleMaterialShader::updateState() используется для передачи состояния материала в программу OpenGL шейдера.

Фактическая программа OpenGL шейдера доступна через функцию QSGSimpleMaterialShader::program().

Каждая реализация QSGSimpleMaterialShader работает с уникальной структурой состояния. Структура состояния должна быть объявлена с использованием макроса QSG_DECLARE_SIMPLE_SHADER.

Вот простой пример пользовательского сплошного цвета:

struct Color
{
    float r, g, b, a;
};

class MinimalShader : public QSGSimpleMaterialShader<Color>
{
    QSG_DECLARE_SIMPLE_SHADER(MinimalShader, Color)
public:

    const char *vertexShader() const {
        return
        "attribute highp vec4 vertex;               \n"
        "uniform highp mat4 qt_Matrix;              \n"
        "void main() {                              \n"
        "    gl_Position = qt_Matrix * vertex;      \n"
        "}";
    }

    const char *fragmentShader() const {
        return
        "uniform lowp float qt_Opacity;             \n"
        "uniform lowp vec4 color;                   \n"
        "void main() {                              \n"
        "    gl_FragColor = color * qt_Opacity;     \n"
        "}";
    }

    QList<QByteArray> attributes() const {
        return QList<QByteArray>() << "vertex";
    }

    void updateState(const Color *color, const Color *) {
        program()->setUniformValue("color", color->r, color->g, color->b, color->a);
    }

};

Экземпляры материалов, использующих этот шейдер, могут быть созданы с помощью функции createMaterial(), которая будет определена макросом QSG_DECLARE_SIMPLE_SHADER.

QSGSimpleMaterial<Color> *material = MinimalShader::createMaterial();
material->state()->r = 1;
material->state()->g = 0;
material->state()->b = 0;
material->state()->a = 1;

node->setMaterial(material);

Графический узел сцены часто пытается найти материалы, имеющие одинаковое или по крайней мере сходное состояние, чтобы их можно было объединить в рамках рендерера, что повышает производительность. Для задания сортируемых состояний материалов используйте QSG_DECLARE_SIMPLE_COMPARABLE_SHADER вместо QSG_DECLARE_SIMPLE_SHADER. Структура состояния также должна определять функцию:

int compare(const Type *other) const;

Предупреждение: QSGSimpleMaterialShader полагается на шаблонную инициализацию для создания QSGMaterialType, который используется рендерером графического узла сцены для идентификации этого шейдера. По этой причине уникальная реализация QSGSimpleMaterialShader должна быть инициализирована с уникальным типом C++.

Примечание: Все классы с префиксом QSG должны использоваться только в потоке рендеринга графического узла сцены. См. Графический узел сцены и рендеринг для получения дополнительной информации.

См. также Графический узел сцены — простой материал.

Документация функций-членов

[pure virtual] QList<QByteArray> QSGSimpleMaterialShader::attributes() const

Возвращает список имён, определяющих вершинные атрибуты в шейдере вершины.

[virtual] void QSGSimpleMaterialShader::resolveUniforms()

Переопределите эту функцию для определения местоположения именованных униформ в программе шейдера.

Эта функция вызывается при инициализации шейдера материала.

const char *QSGSimpleMaterialShader::uniformMatrixName() const

Возвращает имя униформы матрицы преобразования этого элемента. Значение по умолчанию — qt_Matrix.

const char *QSGSimpleMaterialShader::uniformOpacityName() const

Возвращает имя униформы непрозрачности этого элемента. Значение по умолчанию — qt_Opacity.

[pure virtual] void QSGSimpleMaterialShader::updateState(const State *newState, const State *oldState)

Вызывается всякий раз, когда состояние этого шейдера должно быть обновлено от oldState до newState, обычно для каждого нового набора геометрий, которые должны быть нарисованы.

И старое, и новое состояние передаются, чтобы реализация могла сравнивать и минимизировать изменения состояния, когда это возможно.

int compare(const State *other) const;