En esta página

QOpenGLShader Class

La clase QOpenGLShader permite compilar shaders de OpenGL. Más información...

Encabezado: #include <QOpenGLShader>
CMake: find_package(Qt6 REQUIRED COMPONENTS OpenGL)
target_link_libraries(mytarget PRIVATE Qt6::OpenGL)
qmake: QT += opengl
Heredado de: QObject

Tipos públicos

flags ShaderType
enum ShaderTypeBit { Vertex, Fragment, Geometry, TessellationControl, TessellationEvaluation, Compute }

Funciones públicas

QOpenGLShader(QOpenGLShader::ShaderType type, QObject *parent = nullptr)
virtual ~QOpenGLShader()
bool compileSourceCode(const char *source)
bool compileSourceCode(const QByteArray &source)
bool compileSourceCode(const QString &source)
bool compileSourceFile(const QString &fileName)
bool isCompiled() const
QString log() const
GLuint shaderId() const
QOpenGLShader::ShaderType shaderType() const
QByteArray sourceCode() const

Miembros públicos estáticos

bool hasOpenGLShaders(QOpenGLShader::ShaderType type, QOpenGLContext *context = nullptr)

Descripción detallada

Esta clase admite sombreadores escritos en el lenguaje de sombreado de OpenGL (GLSL) y en el lenguaje de sombreado de OpenGL/ES (GLSL/ES).

QOpenGLShader y QOpenGLShaderProgram ocultan al programador los detalles de la compilación y el enlace de los sombreadores de vértices y de fragmentos.

Se espera que todos los datos utilizados por QOpenGLShader sean de confianza. El código fuente del sombreador se pasa, posiblemente tras modificaciones mínimas, al compilador de la implementación subyacente de OpenGL, que es una caja negra desde la perspectiva de Qt.

Advertencia: Se recomienda a los desarrolladoresde aplicaciones que valoren cuidadosamente las posibles implicaciones antes de pasar contenido proporcionado por el usuario a funciones como compileSourceFile().

Véase también QOpenGLShaderProgram.

Documentación sobre tipos de miembros

enum QOpenGLShader::ShaderTypeBit
flags QOpenGLShader::ShaderType

Esta enumeración especifica el tipo de « QOpenGLShader » que se está creando.

ConstanteValorDescripción
QOpenGLShader::Vertex0x0001Sombreador de vértices escrito en el lenguaje de sombreado de OpenGL (GLSL).
QOpenGLShader::Fragment0x0002Sombreador de fragmentos escrito en el lenguaje de sombreado de OpenGL (GLSL).
QOpenGLShader::Geometry0x0004Sombreadores de geometría escritos en el lenguaje de sombreado de OpenGL (GLSL) (requiere OpenGL >= 3.2 u OpenGL ES >= 3.2).
QOpenGLShader::TessellationControl0x0008Sombreadores de control de teselación escritos en el lenguaje de sombreado de OpenGL (GLSL) (requiere OpenGL >= 4.0 u OpenGL ES >= 3.2).
QOpenGLShader::TessellationEvaluation0x0010Sombreadores de evaluación de teselación escritos en el lenguaje de sombreado de OpenGL (GLSL) (requiere OpenGL >= 4.0 u OpenGL ES >= 3.2).
QOpenGLShader::Compute0x0020Shaders de cálculo escritos en el lenguaje de sombreado de OpenGL (GLSL) (requiere OpenGL >= 4.3 u OpenGL ES >= 3.1).

El tipo ShaderType es un typedef para QFlags<ShaderTypeBit>. Almacena una combinación OR de valores de ShaderTypeBit.

Documentación de las funciones miembro

[explicit] QOpenGLShader::QOpenGLShader(QOpenGLShader::ShaderType type, QObject *parent = nullptr)

Crea un nuevo objeto `QOpenGLShader` del ` type ` especificado y lo asocia a ` parent`. Si los programas de sombreado no son compatibles, ` QOpenGLShaderProgram::hasOpenGLShaderPrograms()` devolverá `false`.

A este constructor le suele seguir una llamada a ` compileSourceCode()` o a ` compileSourceFile()`.

El shader se asociará al QOpenGLContext actual.

Véanse también compileSourceCode() y compileSourceFile().

[virtual noexcept] QOpenGLShader::~QOpenGLShader()

Elimina este shader. Si el shader se ha asociado a un objeto « QOpenGLShaderProgram », el shader en sí seguirá existiendo hasta que se destruya el objeto « QOpenGLShaderProgram ».

bool QOpenGLShader::compileSourceCode(const char *source)

Establece el código « source » para este shader y lo compila. Devuelve « true » si el código fuente se ha compilado correctamente; en caso contrario, devuelve «false».

Véase también compileSourceFile().

bool QOpenGLShader::compileSourceCode(const QByteArray &source)

Establece el código « source » para este shader y lo compila. Devuelve « true » si el código fuente se ha compilado correctamente; en caso contrario, devuelve «false».

Esta es una función sobrecargada.

Véase también compileSourceFile().

bool QOpenGLShader::compileSourceCode(const QString &source)

Establece el código « source » para este shader y lo compila. Devuelve « true » si el código fuente se ha compilado correctamente; en caso contrario, devuelve «false».

Esta es una función sobrecargada.

Véase también compileSourceFile().

bool QOpenGLShader::compileSourceFile(const QString &fileName)

Establece el código fuente de este shader con el contenido de fileName y lo compila. Devuelve true si se ha podido abrir el archivo y compilar el código fuente; en caso contrario, devuelve false.

Véase también compileSourceCode().

[static] bool QOpenGLShader::hasOpenGLShaders(QOpenGLShader::ShaderType type, QOpenGLContext *context = nullptr)

Devuelve « true » si este sistema admite programas de sombreado de tipo « type »; en caso contrario, devuelve «false».

El context se utiliza para resolver las extensiones GLSL. Si context es nullptr, entonces se utiliza QOpenGLContext::currentContext().

bool QOpenGLShader::isCompiled() const

Devuelve ` true ` si este shader se ha compilado; en caso contrario, devuelve `false`.

Véase también compileSourceCode() y compileSourceFile().

QString QOpenGLShader::log() const

Devuelve los errores y las advertencias que se produjeron durante la última compilación.

Véase también compileSourceCode() y compileSourceFile().

GLuint QOpenGLShader::shaderId() const

Devuelve el identificador de OpenGL asociado a este shader.

Véase también QOpenGLShaderProgram::programId().

QOpenGLShader::ShaderType QOpenGLShader::shaderType() const

Devuelve el tipo de este shader.

QByteArray QOpenGLShader::sourceCode() const

Devuelve el código fuente de este shader.

Véase también compileSourceCode().

© 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.