Класс QTechnique

Инкапсулирует технику. Подробнее...

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

Свойства

• graphicsApiFilter : Qt3DRender::QGraphicsApiFilter* const

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

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

QTechnique определяет набор объектов Qt3DRender::QRenderPass, объектов Qt3DRender::QFilterKey, объектов Qt3DRender::QParameter и Qt3DRender::QGraphicsApiFilter, которые вместе определяют технику рендеринга, которую данный графический API может выполнить. Фильтр ключей используется Qt3DRender::QTechniqueFilter для выбора определенных техник в определённых частях FrameGraph. Если в QTechnique и QRenderPass указаны два QParameter с одинаковым именем, QParameter в Technique перекрывает QParameter, используемый в QRenderPass.

При создании QEffect, нацеленного на несколько версий графического API, полезно создать несколько узлов QTechnique, каждый с установленным graphicsApiFilter, соответствующим одной из целевых версий GL. Во время выполнения рендерер Qt3D выберет наиболее подходящий QTechnique на основе поддерживаемых версий графического API и (если указано) узлов QFilterKey, удовлетворяющих заданному QTechniqueFilter в FrameGraph.

Примечание: При использовании OpenGL в качестве графического API для рендеринга Qt3D полагается на QSurfaceFormat, возвращаемый QSurfaceFormat::defaultFormat() во время выполнения, чтобы определить наиболее подходящую версию GL. Если вам нужно настроить QSurfaceFormat, не забудьте применить её с помощью QSurfaceFormat::setDefaultFormat(). Установка QSurfaceFormat на представлении, скорее всего, не повлияет на рендеринг, связанный с Qt3D.

Примечание: Узел QTechnique нельзя отключить.

QTechnique *gl3Technique = new QTechnique();

// Create the render passes
QRenderPass *firstPass = new QRenderPass();
QRenderPass *secondPass = new QRenderPass();

// Add the passes to the technique
gl3Technique->addRenderPass(firstPass);
gl3Technique->addRenderPass(secondPass);

// Set the targeted GL version for the technique
gl3Technique->graphicsApiFilter()->setApi(QGraphicsApiFilter::OpenGL);
gl3Technique->graphicsApiFilter()->setMajorVersion(3);
gl3Technique->graphicsApiFilter()->setMinorVersion(1);
gl3Technique->graphicsApiFilter()->setProfile(QGraphicsApiFilter::CoreProfile);

// Create a FilterKey
QFilterKey *filterKey = new QFilterKey();
filterKey->setName(QStringLiteral("name"));
fitlerKey->setValue(QStringLiteral("zFillPass"));

// Add the FilterKey to the Technique
gl3Technique->addFilterKey(filterKey);

// Create a QParameter
QParameter *colorParameter = new QParameter(QStringLiteral("color"), QColor::fromRgbF(0.0f, 0.0f, 1.0f, 1.0f));

// Add parameter to technique
gl3Technique->addParameter(colorParameter);

См. также QEffect, QRenderPass и QTechniqueFilter.

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

void QTechnique::addFilterKey(Qt3DRender::QFilterKey *filterKey)

Добавляет filterKey к локальным ключам фильтра Qt3DRender::QTechnique.

void QTechnique::addParameter(Qt3DRender::QParameter *parameter)

Добавляет parameter к параметрам техники.

void QTechnique::addRenderPass(Qt3DRender::QRenderPass *pass)

Добавляет pass в технику.

QList<Qt3DRender::QFilterKey *> QTechnique::filterKeys() const

Возвращает список объектов Qt3DCore::QFilterKey, составляющих ключи фильтра Qt3DRender::QTechnique.

QList<Qt3DRender::QParameter *> QTechnique::parameters() const

Возвращает список текущих параметров техники.

void QTechnique::removeFilterKey(Qt3DRender::QFilterKey *filterKey)

Удаляет filterKey из локальных ключей фильтра Qt3DRender::QTechnique.

void QTechnique::removeParameter(Qt3DRender::QParameter *parameter)

Удаляет parameter из параметров техники.

void QTechnique::removeRenderPass(Qt3DRender::QRenderPass *pass)

Удаляет pass из техники.

QList<Qt3DRender::QRenderPass *> QTechnique::renderPasses() const

Возвращает список проходов рендеринга, содержащихся в технике.