Класс QParameter

Предоставляет хранилище для пары имя-значение. Это соответствует униформе шейдера. Подробнее...

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

Свойства

• name : QString
• value : QVariant

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

Открытые слоты

Сигналы

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

Класс QParameter может быть использован для ссылки из QRenderPass, QTechnique, QEffect, QMaterial, QTechniqueFilter, QRenderPassFilter. Во время выполнения, в зависимости от выбранного шейдера для данного шага отрисовки, значение, содержащееся в QParameter, будет преобразовано и загружено, если шейдер содержит униформу с именем, совпадающим с именем QParameter.

QParameter *param = new QParameter();
param->setName(QStringLiteral("diffuseColor"));
param->setValue(QColor::fromRgbF(0.0f, 0.0f, 1.0f, 1.0f));

// Alternatively you can create and set a QParameter this way
QParameter *param2 = new QParameter(QStringLiteral("diffuseColor"), QColor::fromRgbF(0.0f, 0.0f, 1.0f, 1.0f));

// Such QParameters will work with the following GLSL uniform shader declarations
// uniform vec4 diffuseColor;
// uniform vec3 diffuseColor;
// uniform vec2 diffuseColor;
// uniform float diffuseColor;

Примечание: необходимо уделить внимание тому, чтобы значение, обернутое QParameter, могло быть фактически преобразовано в то, что ожидает реальная униформа. Передача значения, хранящегося как int, в то время как униформа шейдера имеет тип float, может привести к неопределённому поведению.

Примечание: когда целевая униформа является массивом, имя должно быть именем униформы с добавленным [0].

Примечание: узел QParameter не может быть отключён.

QParameter *param = new QParameter();
QVariantList values = QVariantList() << 0.0f << 1.0f << 2.0f << 3.0f << 4.0f << 883.0f << 1340.0f << 1584.0f;

param->setName(QStringLiteral("diffuseValues[0]"));
param->setValue(values);

// Matching GLSL shader uniform  declaration
// uniform float diffuseValues[8];

Что касается поддержки текстур, значение QParameter должно быть установлено на соответствующий подкласс QAbstractTexture, который соответствует типу выборки униформы шейдера.

QTexture2D *texture = new QTexture2D();
...
QParameter *param = new QParameter();
param->setName(QStringLiteral("diffuseTexture"));
param->setValue(QVariant::fromValue(texture));

// Works with the following GLSL uniform shader declaration
// uniform sampler2D diffuseTexture

См. также QAbstractTexture.

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

QParameter::QParameter(const QString &name, Qt3DRender::QAbstractTexture *texture, Qt3DCore::QNode *parent = nullptr)

Создаёт новый QParameter с указанным parent, name и значением из texture.

QParameter::QParameter(const QString &name, const QVariant &value, Qt3DCore::QNode *parent = nullptr)

Создаёт новый QParameter с указанным parent, name и value.

QParameter::QParameter(Qt3DCore::QNode *parent = nullptr)

Создаёт новый QParameter с указанным parent.