Класс QSGSimpleMaterialShader

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

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

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

• 5 открытых функций унаследовано от QSGMaterialShader

Макросы

Дополнительные унаследованные члены

• 6 защищенных функций унаследовано от QSGMaterialShader

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

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

В то время как 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;