PySide6.QtOpenGL.QOpenGLDebugMessage

class QOpenGLDebugMessage

QOpenGLDebugMessage 类封装了一个 OpenGL 调试消息。更多…

概要

方法

静态函数

注意

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

详细描述

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

应用程序或第三方库和工具包也可以创建并插入消息到调试日志中。为了做到这一点，你可以使用createApplicationMessage()或createThirdPartyMessage()静态函数。

另请参阅

QOpenGLDebugLogger

class Source

(继承自 enum.Flag) 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)
Parameters:

debugMessage – QOpenGLDebugMessage

构造一个调试消息作为debugMessage的副本。

另请参阅

operator=()

static createApplicationMessage(text[, id=0[, severity=QOpenGLDebugMessage.Severity.NotificationSeverity[, type=QOpenGLDebugMessage.Type.OtherType]]])
Parameters:
Return type:

QOpenGLDebugMessage

构造并返回一条调试消息，其中text作为文本，id作为ID，severity作为严重程度，type作为类型。消息来源将设置为ApplicationSource。

static createThirdPartyMessage(text[, id=0[, severity=QOpenGLDebugMessage.Severity.NotificationSeverity[, type=QOpenGLDebugMessage.Type.OtherType]]])
Parameters:
Return type:

QOpenGLDebugMessage

构造并返回一条调试消息，其中text作为文本，id作为ID，severity作为严重程度，type作为类型。消息来源将设置为ThirdPartySource。

id()
Return type:

整数

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

message()
Return type:

字符串

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

__ne__(debugMessage)
Parameters:

debugMessage – QOpenGLDebugMessage

Return type:

布尔

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

另请参阅

operator==()

__eq__(debugMessage)
Parameters:

debugMessage – QOpenGLDebugMessage

Return type:

布尔

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

另请参阅

operator!=()

severity()
Return type:

严重程度

返回调试消息的严重性。

source()
Return type:

Source

返回调试消息的来源。

swap(other)
Parameters:

其他 – QOpenGLDebugMessage

将此消息与debugMessage交换。此操作非常快速且永远不会失败。

type()
Return type:

类型

返回调试消息的类型。