QGLShader Class

The QGLShader class allows OpenGL shaders to be compiled. 更多...

头: #include <QGLShader>
qmake: QT += opengl
Since: Qt 4.6
继承: QObject

该类已过时。 提供它是为使旧源代码能继续工作。强烈建议不要在新代码中使用它。

该类在 Qt 4.6 引入。

公共类型

flags ShaderType
enum ShaderTypeBit { Vertex, Fragment, Geometry }

公共函数

QGLShader (QGLShader::ShaderType type , const QGLContext * context , QObject * parent = nullptr)
QGLShader (QGLShader::ShaderType type , QObject * parent = nullptr)
virtual ~QGLShader ()
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
QGLShader::ShaderType shaderType () const
QByteArray sourceCode () const

静态公共成员

bool hasOpenGLShaders (QGLShader::ShaderType type , const QGLContext * context = nullptr)

详细描述

This class supports shaders written in the OpenGL Shading Language (GLSL) and in the OpenGL/ES Shading Language (GLSL/ES).

QGLShader and QGLShaderProgram shelter the programmer from the details of compiling and linking vertex and fragment shaders.

注意: This class has been deprecated in favor of QOpenGLShader .

另请参阅 QGLShaderProgram .

成员类型文档编制

enum QGLShader:: ShaderTypeBit
flags QGLShader:: ShaderType

This enum specifies the type of QGLShader that is being created.

常量 描述
QGLShader::Vertex 0x0001 Vertex shader written in the OpenGL Shading Language (GLSL).
QGLShader::Fragment 0x0002 Fragment shader written in the OpenGL Shading Language (GLSL).
QGLShader::Geometry 0x0004 Geometry shaders written in the OpenGL Shading Language (GLSL), based on the GL_EXT_geometry_shader4 extension.

The ShaderType type is a typedef for QFlags <ShaderTypeBit>. It stores an OR combination of ShaderTypeBit values.

成员函数文档编制

QGLShader:: QGLShader ( QGLShader::ShaderType type , const QGLContext * context , QObject * parent = nullptr)

Constructs a new QGLShader object of the specified type and attaches it to parent . If shader programs are not supported, then QGLShaderProgram::hasOpenGLShaderPrograms () 将返回 false。

This constructor is normally followed by a call to compileSourceCode () 或 compileSourceFile ().

The shader will be associated with context .

另请参阅 compileSourceCode () 和 compileSourceFile ().

QGLShader:: QGLShader ( QGLShader::ShaderType type , QObject * parent = nullptr)

Constructs a new QGLShader object of the specified type and attaches it to parent . If shader programs are not supported, QGLShaderProgram::hasOpenGLShaderPrograms () 将返回 false。

This constructor is normally followed by a call to compileSourceCode () 或 compileSourceFile ().

The shader will be associated with the current QGLContext.

另请参阅 compileSourceCode () 和 compileSourceFile ().

[虚拟] QGLShader:: ~QGLShader ()

Deletes this shader. If the shader has been attached to a QGLShaderProgram object, then the actual shader will stay around until the QGLShaderProgram is destroyed.

bool QGLShader:: compileSourceCode (const char * source )

设置 source code for this shader and compiles it. Returns true if the source was successfully compiled, false otherwise.

另请参阅 compileSourceFile ().

bool QGLShader:: compileSourceCode (const QByteArray & source )

这是重载函数。

设置 source code for this shader and compiles it. Returns true if the source was successfully compiled, false otherwise.

另请参阅 compileSourceFile ().

bool QGLShader:: compileSourceCode (const QString & source )

这是重载函数。

设置 source code for this shader and compiles it. Returns true if the source was successfully compiled, false otherwise.

另请参阅 compileSourceFile ().

bool QGLShader:: compileSourceFile (const QString & fileName )

Sets the source code for this shader to the contents of fileName and compiles it. Returns true if the file could be opened and the source compiled, false otherwise.

另请参阅 compileSourceCode ().

[static] bool QGLShader:: hasOpenGLShaders ( QGLShader::ShaderType type , const QGLContext * context = nullptr)

返回 true if shader programs of type type are supported on this system; false otherwise.

The context is used to resolve the GLSL extensions. If context is nullptr ,那么 QGLContext::currentContext () is used.

该函数在 Qt 4.7 引入。

bool QGLShader:: isCompiled () const

返回 true if this shader has been compiled; false otherwise.

另请参阅 compileSourceCode () 和 compileSourceFile ().

QString QGLShader:: log () const

Returns the errors and warnings that occurred during the last compile.

另请参阅 compileSourceCode () 和 compileSourceFile ().

GLuint QGLShader:: shaderId () const

Returns the OpenGL identifier associated with this shader.

另请参阅 QGLShaderProgram::programId ().

QGLShader::ShaderType QGLShader:: shaderType () const

Returns the type of this shader.

QByteArray QGLShader:: sourceCode () const

Returns the source code for this shader.

另请参阅 compileSourceCode ().