Класс QShaderProgram

Оборачивает программу шейдеров. Подробнее...

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

Типы

Свойства

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

Публичные слоты

Сигналы

Статические публичные члены

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

Программа шейдеров состоит из нескольких разных шейдеров, таких как вершинные и фрагментные шейдеры.

Qt3D автоматически заполнит набор стандартных униформ, если они встретятся во время фазы интроспекции шейдера.

Поддержка RHI

При написании кода GLSL 450 для использования с бэкендом RHI Qt 3D, стандартные униформы будут предоставляться в виде 2 объектов uniform buffer.

Место связывания для них устанавливается на 0 для униформ RenderView и 1 для униформ Command.

#version 450 core

layout(location = 0) in vec3 vertexPosition;

layout(std140, binding = 0) uniform qt3d_render_view_uniforms {
  mat4 viewMatrix;
  mat4 projectionMatrix;
  mat4 uncorrectedProjectionMatrix;
  mat4 clipCorrectionMatrix;
  mat4 viewProjectionMatrix;
  mat4 inverseViewMatrix;
  mat4 inverseProjectionMatrix;
  mat4 inverseViewProjectionMatrix;
  mat4 viewportMatrix;
  mat4 inverseViewportMatrix;
  vec4 textureTransformMatrix;
  vec3 eyePosition;
  float aspectRatio;
  float gamma;
  float exposure;
  float time;
  float yUpInNDC;
  float yUpInFBO;
};

layout(std140, binding = 1) uniform qt3d_command_uniforms {
  mat4 modelMatrix;
  mat4 inverseModelMatrix;
  mat4 modelViewMatrix;
  mat3 modelNormalMatrix;
  mat4 inverseModelViewMatrix;
  mat4 modelViewProjection;
  mat4 inverseModelViewProjectionMatrix;
};

void main()
{
    gl_Position = (projectionMatrix * viewMatrix * modelMatrix * vertexPosition);
}

Для пользовательских объектов uniform buffer используйте связывание, начинающееся с 2 или auto, чтобы Qt 3D автоматически вычислил связывание. Убедитесь, что согласование сохраняется между различными стадиями шейдера.

#version 450 core

layout(std140, binding = auto) uniform my_uniforms {
  vec4 myColor;
};

layout(location=0) out vec4 fragColor;

void main()
{
    fragColor = myColor;
}

Изменений при передаче значений униформам не требуется.

В примере выше, установка myColor может быть выполнена с помощью:

QParameter *parameter = new QParameter();
parameter->setName("myColor");
parameter->setValue(QVariant::fromValue(QColor(Qt::blue)));

Текстуры по-прежнему должны определяться как отдельные униформы.

#version 450 core

layout(binding=0) uniform sampler2D source;

layout(location=0) out vec4 fragColor;

void main()
{
    fragColor = texture(source, vec2(0.5, 0.5));
}

Документация по типу членов

[since 5.15] перечисление QShaderProgram::Format

Это перечисление определяет формат используемого кода шейдера.

Этот перечисление был введён или изменён в Qt 5.15.

enum QShaderProgram::ShaderType

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

enum QShaderProgram::Status

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

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

[static invokable] QByteArray QShaderProgram::loadSource(const QUrl &sourceUrl)

Возвращает код шейдера, загруженный из sourceUrl.

Примечание: Эту функцию можно вызвать через систему метаобъектов и из QML. См. Q_INVOKABLE.

void QShaderProgram::setShaderCode(Qt3DRender::QShaderProgram::ShaderType type, const QByteArray &shaderCode)

Устанавливает код шейдера для шейдера типа type на shaderCode.

См. также shaderCode().

QByteArray QShaderProgram::shaderCode(Qt3DRender::QShaderProgram::ShaderType type) const

Возвращает код шейдера для типа type.

См. также setShaderCode().

Qt3DRender::QShaderProgram::Status QShaderProgram::status() const

Возвращает состояние текущей программы шейдеров.

Примечание: Функция-получатель для свойства status.