En esta página

Qt3DRender::QTechnique Class

class Qt3DRender::QTechnique

Encapsula una técnica. Más...

Encabezado: #include <qtechnique.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
En QML: Technique
Heredado de: Qt3DCore::QNode
Estado: Obsoleto

Esta clase está obsoleta. Se desaconseja encarecidamente su uso en código nuevo.

Propiedades

Funciones públicas

void addFilterKey(Qt3DRender::QFilterKey *filterKey)
void addParameter(Qt3DRender::QParameter *parameter)
void addRenderPass(Qt3DRender::QRenderPass *pass)
QList<Qt3DRender::QFilterKey *> filterKeys() const
Qt3DRender::QGraphicsApiFilter *graphicsApiFilter()
const Qt3DRender::QGraphicsApiFilter *graphicsApiFilter() const
QList<Qt3DRender::QParameter *> parameters() const
void removeFilterKey(Qt3DRender::QFilterKey *filterKey)
void removeParameter(Qt3DRender::QParameter *parameter)
void removeRenderPass(Qt3DRender::QRenderPass *pass)
QList<Qt3DRender::QRenderPass *> renderPasses() const

Descripción detallada

Un « Qt3DRender::QTechnique » especifica un conjunto de objetos « Qt3DRender::QRenderPass », « Qt3DRender::QFilterKey », « Qt3DRender::QParameter » y un « Qt3DRender::QGraphicsApiFilter », que en conjunto definen una técnica de renderizado que la API gráfica dada puede renderizar. Qt3DRender::QTechniqueFilter utiliza las claves de filtro para seleccionar técnicas específicas en partes concretas del FrameGraph. Un QParameter definido en un QTechnique anula el parámetro (del mismo nombre) definido en QRenderPass, pero queda anulado por el parámetro de QRenderPassFilter, QTechniqueFilter, QMaterial y QEffect.

Al crear un « QEffect » destinado a varias versiones de una API gráfica, resulta útil crear varios nodos «QTechnique», cada uno con un « graphicsApiFilter » configurado para que coincida con una de las versiones de GL a las que va dirigido. En tiempo de ejecución, el renderizador de Qt3D seleccionará la QTechnique más adecuada en función de las versiones de la API gráfica compatibles y (si se ha especificado) de los nodos « QFilterKey » que cumplan con un « QTechniqueFilter » determinado en el FrameGraph.

Nota: Cuando se utiliza OpenGL como API gráfica para el renderizado, Qt3D se basa en el valor de « QSurfaceFormat » devuelto por « QSurfaceFormat::defaultFormat()» en tiempo de ejecución para decidir cuál es la versión de GL más adecuada disponible. Si necesitas personalizar el « QSurfaceFormat », no olvides aplicarlo con « QSurfaceFormat::setDefaultFormat()». Establecer « QSurfaceFormat » en la vista probablemente no tendrá ningún efecto en el renderizado relacionado con Qt3D.

Nota: El nodo `QTechnique ` no se puede desactivar.

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);

Véase también QEffect, QRenderPass y QTechniqueFilter.

Documentación de propiedades

[read-only] graphicsApiFilter : Qt3DRender::QGraphicsApiFilter* const

Especifica el filtro de la API gráfica que se está utilizando

Funciones de acceso:

Qt3DRender::QGraphicsApiFilter *graphicsApiFilter()
const Qt3DRender::QGraphicsApiFilter *graphicsApiFilter() const

Documentación de las funciones de miembro

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

Añade « filterKey » a las claves de filtro locales « Qt3DRender::QTechnique ».

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

Añade « parameter » a los parámetros de la técnica.

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

Añade un « pass » a la técnica.

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

Devuelve la lista de objetos clave `Qt3DCore::QFilterKey` que conforman las claves de filtro de ` Qt3DRender::QTechnique`.

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

Devuelve un vector con los parámetros actuales de la técnica.

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

Elimina « filterKey » de las claves de filtro locales de « Qt3DRender::QTechnique ».

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

Elimina « parameter » de los parámetros de la técnica.

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

Elimina un « pass » de la técnica.

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

Devuelve la lista de pasadas de renderizado que contiene la técnica.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.