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 |
- Lista de todos los miembros, incluidos los heredados
- QOpenGLShader forma parte de «Renderizado en 3D».
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.
| Constante | Valor | Descripción |
|---|---|---|
QOpenGLShader::Vertex | 0x0001 | Sombreador de vértices escrito en el lenguaje de sombreado de OpenGL (GLSL). |
QOpenGLShader::Fragment | 0x0002 | Sombreador de fragmentos escrito en el lenguaje de sombreado de OpenGL (GLSL). |
QOpenGLShader::Geometry | 0x0004 | Sombreadores de geometría escritos en el lenguaje de sombreado de OpenGL (GLSL) (requiere OpenGL >= 3.2 u OpenGL ES >= 3.2). |
QOpenGLShader::TessellationControl | 0x0008 | Sombreadores de control de teselación escritos en el lenguaje de sombreado de OpenGL (GLSL) (requiere OpenGL >= 4.0 u OpenGL ES >= 3.2). |
QOpenGLShader::TessellationEvaluation | 0x0010 | Sombreadores 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::Compute | 0x0020 | Shaders 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.