class QOpenGLDebugMessage

QOpenGLDebugMessage类用于封装OpenGL调试消息。更多…

摘要

方法

• def __init__()

• def id()

• def message()

• def __ne__()

• def __eq__()

• 定义 severity()

• 定义 source()

• 定义 swap()

• 定义 type()

静态函数

• 定义 createApplicationMessage()

• 定义 createThirdPartyMessage()

注意

此文档可能包含从 C++ 自动翻译到 Python 的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译有误，也可以通过在 https:/bugreports.qt.io/projects/PYSIDE 上创建工单的方式来通知我们。

详细描述

调试消息通常由 OpenGL 服务器创建，然后由 OpenGL 客户端读取（无论是从 OpenGL 内部调试日志中读取，还是在实时中记录）。调试消息有一个文本表示、一个供应商特定的数字 ID、一个来源、一个类型和一个严重性。

应用程序或第三方库和工具包也可以在调试日志中创建和插入消息。为此，您可以使用 createApplicationMessage() 或 createThirdPartyMessage() 静态函数。

另请参阅

QOpenGLDebugLogger

class 源

(继承自 枚举标志) Source 枚举定义了调试消息的来源。

常量	描述
QOpenGLDebugMessage.InvalidSource	消息的来源无效；这是默认构建的 QOpenGLDebugMessage 对象的来源。
QOpenGLDebugMessage.APISource	消息是在对 OpenGL API 调用的响应中生成的。
QOpenGLDebugMessage.WindowSystemSource	消息是由窗口系统生成的。
QOpenGLDebugMessage.ShaderCompilerSource	消息是由着色器编译器生成的。
QOpenGLDebugMessage.ThirdPartySource	消息是由第三方生成的，例如一个 OpenGL 框架或调试工具包。
QOpenGLDebugMessage.ApplicationSource	消息是由应用程序本身生成的。
QOpenGLDebugMessage.OtherSource	消息是由本枚举中未包括的来源生成的。
QOpenGLDebugMessage.AnySource	此值对应于所有可能的来源的掩码。

class Type

(继承自 enum.Flag) Type 枚举定义了调试消息的类型。

常量	描述
QOpenGLDebugMessage.InvalidType	消息的类型无效；这是默认构造的 QOpenGLDebugMessage 对象的类型。
QOpenGLDebugMessage.ErrorType	消息表示一个错误。
QOpenGLDebugMessage.DeprecatedBehaviorType	消息表示对已弃用的行为的使用。
QOpenGLDebugMessage.UndefinedBehaviorType	消息表示对未定义行为的使用。
QOpenGLDebugMessage.PortabilityType	消息表示对可能引起可移植性问题的供应商特定行为的使用。
QOpenGLDebugMessage.PerformanceType	消息表示一个性能问题。
QOpenGLDebugMessage.OtherType	消息表示未包含在此枚举中的类型。
QOpenGLDebugMessage.MarkerType	消息表示调试日志中的标记。
QOpenGLDebugMessage.GroupPushType	消息表示一个调试组推进操作。
QOpenGLDebugMessage.GroupPopType	消息表示一个调试组弹出操作。
QOpenGLDebugMessage.AnyType	此值对应于所有可能消息类型的掩码。

class Severity

(继承自 enum.Flag) Severity 枚举定义了调试消息的严重性。

常量	描述
QOpenGLDebugMessage.InvalidSeverity	消息的严重性无效；这是默认构造的 QOpenGLDebugMessage 对象的严重性。
QOpenGLDebugMessage.HighSeverity	消息具有高度严重性。
QOpenGLDebugMessage.MediumSeverity	消息具有中等严重性。
QOpenGLDebugMessage.LowSeverity	消息具有低严重性。
QOpenGLDebugMessage.NotificationSeverity	消息是一个通知。
QOpenGLDebugMessage.AnySeverity	此值对应于所有可能消息严重性的掩码。

__init__()

构建一个具有空消息字符串的调试消息，id 赋值为 0，源设置为 InvalidSource ，类型设置为 InvalidType ，严重性设置为 InvalidSeverity 。

注意

不应该使用此构造函数来创建调试消息；相反，请使用 createApplicationMessage() 或 createThirdPartyMessage() 静态函数。

另请参阅

createApplicationMessage() createThirdPartyMessage()

__init__(debugMessage)

参数：

debugMessage – QOpenGLDebugMessage

将debugMessage作为副本构建一个调试消息。

另请参阅

运算符=()

静态createApplicationMessage(text[, id=0[, severity=QOpenGLDebugMessage.Severity.NotificationSeverity[, type=QOpenGLDebugMessage.Type.OtherType]]]])

参数：

• text – 字符串

• id – 整数

• severity – Severity

• type – Type

返回类型：

QOpenGLDebugMessage

构建并返回一个调试消息，其中text作为文本，id作为id，severity作为严重性，type作为类型。消息来源将被设置为ApplicationSource。

另请参阅

logMessage() createThirdPartyMessage()

静态createThirdPartyMessage(text[, id=0[, severity=QOpenGLDebugMessage.Severity.NotificationSeverity[, type=QOpenGLDebugMessage.Type.OtherType]]]])

参数：

• text – 字符串

• id – 整数

• severity – Severity

• type – Type

返回类型：

QOpenGLDebugMessage

构建并由text作为文本，id作为id，severity作为严重性，type作为类型的一个调试消息。消息来源将被设置为ThirdPartySource。

另请参阅

logMessage() createApplicationMessage()

id()

返回类型：

int

返回调试消息的id。ID通常是供应商特定的。

message()

返回类型：

str

返回本调试消息包含的文本消息。

__ne__(debugMessage)

参数：

debugMessage – QOpenGLDebugMessage

返回类型：

bool

如果此消息与debugMessage不同，则返回true，否则返回false。

另请参阅

operator==()

__eq__(debugMessage)

参数：

debugMessage – QOpenGLDebugMessage

返回类型：

bool

如果此调试消息等于debugMessage，则返回true，否则返回false。两个调试消息相等，如果它们具有相同的文本消息、相同的ID、相同的来源、相同的类型和相同的严重性。

另请参阅

operator!=()

severity()

返回类型：

Severity

返回调试消息的严重性。

source()

返回类型：

Source

返回调试消息的来源。

swap(other)

参数：

other – QOpenGLDebugMessage

交换消息debugMessage与此消息。此操作非常快速且从不失败。

type()

返回类型：

Type

返回调试消息的类型。