QGLFormat Class Reference · PyQt4 中文文档

# QGLFormat Class Reference ## [[QtOpenGL](index.htm) module] 该QGLFormat类指定一个OpenGL渲染上下文的显示格式。[More...](#details) ### Types * `enum OpenGLContextProfile { NoProfile, CoreProfile, CompatibilityProfile }` * `enum OpenGLVersionFlag { OpenGL_Version_None, OpenGL_Version_1_1, OpenGL_Version_1_2, OpenGL_Version_1_3, ..., OpenGL_ES_Version_2_0 }` * `class **[OpenGLVersionFlags](index.htm)**` ### Methods * `__init__ (self)` * `__init__ (self, QGL.FormatOptions options, int plane = 0)` * `__init__ (self, QGLFormat other)` * `bool accum (self)` * `int accumBufferSize (self)` * `bool alpha (self)` * `int alphaBufferSize (self)` * `int blueBufferSize (self)` * `bool depth (self)` * `int depthBufferSize (self)` * `bool directRendering (self)` * `bool doubleBuffer (self)` * `int greenBufferSize (self)` * `bool hasOverlay (self)` * `int majorVersion (self)` * `int minorVersion (self)` * `int plane (self)` * `OpenGLContextProfile profile (self)` * `int redBufferSize (self)` * `bool rgba (self)` * `bool sampleBuffers (self)` * `int samples (self)` * `setAccum (self, bool enable)` * `setAccumBufferSize (self, int size)` * `setAlpha (self, bool enable)` * `setAlphaBufferSize (self, int size)` * `setBlueBufferSize (self, int size)` * `setDepth (self, bool enable)` * `setDepthBufferSize (self, int size)` * `setDirectRendering (self, bool enable)` * `setDoubleBuffer (self, bool enable)` * `setGreenBufferSize (self, int size)` * `setOption (self, QGL.FormatOptions opt)` * `setOverlay (self, bool enable)` * `setPlane (self, int plane)` * `setProfile (self, OpenGLContextProfile profile)` * `setRedBufferSize (self, int size)` * `setRgba (self, bool enable)` * `setSampleBuffers (self, bool enable)` * `setSamples (self, int numSamples)` * `setStencil (self, bool enable)` * `setStencilBufferSize (self, int size)` * `setStereo (self, bool enable)` * `setSwapInterval (self, int interval)` * `setVersion (self, int major, int minor)` * `bool stencil (self)` * `int stencilBufferSize (self)` * `bool stereo (self)` * `int swapInterval (self)` * `bool testOption (self, QGL.FormatOptions opt)` ### Static Methods * `QGLFormat defaultFormat ()` * `QGLFormat defaultOverlayFormat ()` * `bool hasOpenGL ()` * `bool hasOpenGLOverlays ()` * `OpenGLVersionFlags openGLVersionFlags ()` * `setDefaultFormat (QGLFormat f)` * `setDefaultOverlayFormat (QGLFormat f)` ### Special Methods * `bool __eq__ (self, QGLFormat)` * `bool __ne__ (self, QGLFormat)` * * * ## Detailed Description 该QGLFormat类指定一个OpenGL渲染上下文的显示格式。一种显示格式有几个特点： * [Double or single buffering.](qglformat.html#setDoubleBuffer) * [Depth buffer.](qglformat.html#setDepth) * [RGBA or color index mode.](qglformat.html#setRgba) * [Alpha channel.](qglformat.html#setAlpha) * [Accumulation buffer.](qglformat.html#setAccum) * [Stencil buffer.](qglformat.html#setStencil) * [Stereo buffers.](qglformat.html#setStereo) * [Direct rendering.](qglformat.html#setDirectRendering) * [Presence of an overlay.](qglformat.html#setOverlay) * [Plane of an overlay.](qglformat.html#setPlane) * [Multisample buffers.](qglformat.html#setSampleBuffers) 您也可以指定首选位深度的颜色缓冲，深度缓冲，阿尔法缓冲，缓冲的积累以及与功能模板缓冲区：[setRedBufferSize](qglformat.html#setRedBufferSize)（）[setGreenBufferSize](qglformat.html#setGreenBufferSize)（）[setBlueBufferSize](qglformat.html#setBlueBufferSize)（）[setDepthBufferSize](qglformat.html#setDepthBufferSize)（）[setAlphaBufferSize](qglformat.html#setAlphaBufferSize)（）[setAccumBufferSize](qglformat.html#setAccumBufferSize)（）和[setStencilBufferSize](qglformat.html#setStencilBufferSize)（）。请注意，即使您指定你喜欢一个32位深度缓冲（如带setDepthBufferSize （ 32 ）），选择该格式可能不具有一个32位的深度缓冲区，即使有可用的带有32位深度缓冲的格式。主要的原因是系统依赖采摘算法在不同的平台上是如何工作的，以及一些格式选项可能有优先级比别人高。您可以创建和告诉QGLFormat对象，你想从一个OpenGL渲染上下文是什么渲染选项。 OpenGL驱动程序或硬件加速的可能或可能不支持高级功能，例如alpha通道或立体视。如果您要求一些功能，驱动器/硬件不提供当你创建一个[QGLWidget](qglwidget.html)，你会得到一个渲染上下文的功能最接近的子集。有不同的方式来定义一个渲染上下文的显示特性。一个是创建一个QGLFormat并使其成为默认为整个应用程序： ``` QGLFormat fmt; fmt.setAlpha(true); fmt.setStereo(true); QGLFormat.setDefaultFormat(fmt); ``` 或者，您可以创建一个对象时指定所需的格式的[QGLWidget](qglwidget.html)子类： ``` QGLFormat fmt; fmt.setDoubleBuffer(false); // single buffer fmt.setDirectRendering(false); // software rendering MyGLWidget* myWidget = new MyGLWidget(fmt, ...); ``` 窗口小部件被创建之后，你可以找出其中所要求的功能的系统能够提供： ``` QGLFormat fmt; fmt.setOverlay(true); fmt.setStereo(true); MyGLWidget* myWidget = new MyGLWidget(fmt, ...); if (!myWidget->format().stereo()) { // ok, goggles off if (!myWidget->format().hasOverlay()) { qFatal("Cool hardware required"); } } ``` OpenGL是Silicon Graphics公司在美国和其他国家的商标。 * * * ## Type Documentation ``` QGLFormat.OpenGLContextProfile ``` 这个枚举变量描述了可以为上下文实现的OpenGL 3.2或更高版本中指定的OpenGL上下文配置文件。这些配置文件是从OpenGL ES的配置文件不同。 | Constant | Value | Description | | --- | --- | --- | | `QGLFormat.NoProfile` | `0` | OpenGL的版本比3.2更低。 | | `QGLFormat.CoreProfile` | `1` | 不推荐使用的功能在OpenGL 3.0版无法使用。 | | `QGLFormat.CompatibilityProfile` | `2` | 从早期的OpenGL版本功能可用。 | 这个枚举被引入或修改的Qt 4.7 。 ``` QGLFormat.OpenGLVersionFlag ``` 这个枚举变量描述了各种OpenGL版本是由Qt的认可。使用[QGLFormat.openGLVersionFlags](qglformat.html#openGLVersionFlags)（）函数来确定哪些版本的在运行时支持。 | Constant | Value | Description | | --- | --- | --- | | `QGLFormat.OpenGL_Version_None` | `0x00000000` | 如果没有OpenGL是或者没有OpenGL上下文是最新的。 | | `QGLFormat.OpenGL_Version_1_1` | `0x00000001` | OpenGL版本1.1或更高版本存在。 | | `QGLFormat.OpenGL_Version_1_2` | `0x00000002` | OpenGL版本1.2或更高版本存在。 | | `QGLFormat.OpenGL_Version_1_3` | `0x00000004` | OpenGL版本1.3或更高版本存在。 | | `QGLFormat.OpenGL_Version_1_4` | `0x00000008` | OpenGL版本1.4或更高版本存在。 | | `QGLFormat.OpenGL_Version_1_5` | `0x00000010` | OpenGL版本1.5或更高版本存在。 | | `QGLFormat.OpenGL_Version_2_0` | `0x00000020` | OpenGL版本2.0或更高版本存在。请注意， 2.0版支持1.5版的所有功能。 | | `QGLFormat.OpenGL_Version_2_1` | `0x00000040` | OpenGL的2.1或更高版本的存在。 | | `QGLFormat.OpenGL_Version_3_0` | `0x00001000` | OpenGL版本3.0或更高版本存在。 | | `QGLFormat.OpenGL_Version_3_1` | `0x00002000` | OpenGL的3.1或更高的版本存在。需要注意的是OpenGL的3.1或更高版本不一定支持3.0版和更低的所有功能。 | | `QGLFormat.OpenGL_Version_3_2` | `0x00004000` | OpenGL版本3.2或更高版本存在。 | | `QGLFormat.OpenGL_Version_3_3` | `0x00008000` | OpenGL版本3.3或更高版本存在。 | | `QGLFormat.OpenGL_Version_4_0` | `0x00010000` | OpenGL版本4.0或更高版本存在。 | | `QGLFormat.OpenGL_ES_CommonLite_Version_1_0` | `0x00000100` | 的OpenGL ES 1.0版通用精简版或更高版本存在。 | | `QGLFormat.OpenGL_ES_Common_Version_1_0` | `0x00000080` | OpenGL ES的1.0版本通用或更高版本存在。 Common文件支持常见的精简版的所有功能。 | | `QGLFormat.OpenGL_ES_CommonLite_Version_1_1` | `0x00000400` | 的OpenGL ES 1.1版通用精简版或更高版本存在。 | | `QGLFormat.OpenGL_ES_Common_Version_1_1` | `0x00000200` | OpenGL ES的1.1版本通用或更高版本存在。 Common文件支持常见的精简版的所有功能。 | | `QGLFormat.OpenGL_ES_Version_2_0` | `0x00000800` | 的OpenGL ES 2.0或更高版本存在。需要注意的是OpenGL ES的2.0版本不支持的OpenGL ES 1.x的所有功能所以，如果OpenGL_ES_Version_2_0返回，返回没有的ES 1.x的标志。 | 另请参阅[http://www.opengl.org](http://www.opengl.org/)关于OpenGL的不同版本的更多信息。这个枚举被引入或修改的Qt 4.2 。该OpenGLVersionFlags类型是一个typedef为[QFlags](index.htm)\u003cOpenGLVersionFlag\u003e 。它存储OpenGLVersionFlag值的或组合。 **See also** [openGLVersionFlags](qglformat.html#openGLVersionFlags)（）。 * * * ## Method Documentation ``` QGLFormat.__init__ (self) ``` 构造一个[QGLFormat](qglformat.html)用下面的默认设置对象： * [Double buffer:](qglformat.html#setDoubleBuffer) Enabled. * [Depth buffer:](qglformat.html#setDepth) Enabled. * [RGBA:](qglformat.html#setRgba) Enabled (i.e., color index disabled). * [Alpha channel:](qglformat.html#setAlpha) Disabled. * [Accumulator buffer:](qglformat.html#setAccum) Disabled. * [Stencil buffer:](qglformat.html#setStencil) Enabled. * [Stereo:](qglformat.html#setStereo) Disabled. * [Direct rendering:](qglformat.html#setDirectRendering) Enabled. * [Overlay:](qglformat.html#setOverlay) Disabled. * [Plane:](qglformat.html#setPlane) 0 (i.e., normal plane). * [Multisample buffers:](qglformat.html#setSampleBuffers) Disabled. ``` QGLFormat.__init__ (self, QGL.FormatOptions options, int plane = 0) ``` 创建[QGLFormat](qglformat.html)对象，它是当前的一个副本[defaultFormat](qglformat.html#defaultFormat)（）。 If _options_不为0 ，则默认格式是由特定的格式选项修改。该_options_参数应该是[QGL.FormatOption](qgl.html#FormatOption-enum)值OR'ed在一起。这个构造函数可以很容易地从指定的派生类一定想要的格式[QGLWidget](qglwidget.html)例如： ``` // The rendering in MyGLWidget depends on using // stencil buffer and alpha channel MyGLWidget.MyGLWidget([QWidget](qwidget.html)* parent) : [QGLWidget](qglwidget.html)([QGLFormat](qglformat.html)(QGL.StencilBuffer | QGL.AlphaChannel), parent) { if (!format().stencil()) qWarning("Could not get stencil buffer; results will be suboptimal"); if (!format().alpha()) qWarning("Could not get alpha channel; results will be suboptimal"); ... } ``` 请注意，有[QGL.FormatOption](qgl.html#FormatOption-enum)值开启和关闭都，如格式设置[QGL.DepthBuffer](qgl.html#FormatOption-enum)和[QGL.NoDepthBuffer](qgl.html#FormatOption-enum)，[QGL.DirectRendering](qgl.html#FormatOption-enum)和[QGL.IndirectRendering](qgl.html#FormatOption-enum)等。该_plane_参数默认为0 ，并且是这种格式应该与相关的平面。并非所有的OpenGL实现支持复盖/衬底渲染的飞机。 **See also** [defaultFormat](qglformat.html#defaultFormat)（）[setOption](qglformat.html#setOption)（）和[setPlane](qglformat.html#setPlane)（）。 ``` QGLFormat.__init__ (self, QGLFormat other) ``` 构造的副本_other_。 ``` bool QGLFormat.accum (self) ``` 返回True如果累积缓冲器被启用，否则返回False 。积累缓冲区默认是禁用的。 **See also** [setAccum](qglformat.html#setAccum)（）和[setAccumBufferSize](qglformat.html#setAccumBufferSize)（）。 ``` int QGLFormat.accumBufferSize (self) ``` 返回累积缓冲区的大小。 **See also** [setAccumBufferSize](qglformat.html#setAccumBufferSize)（）[accum](qglformat.html#accum)（）和[setAccum](qglformat.html#setAccum)（）。 ``` bool QGLFormat.alpha (self) ``` 返回True如果在framebuffer的阿尔法缓冲启用，否则返回False 。阿尔法缓冲默认情况下禁用。 **See also** [setAlpha](qglformat.html#setAlpha)（）和[setAlphaBufferSize](qglformat.html#setAlphaBufferSize)（）。 ``` int QGLFormat.alphaBufferSize (self) ``` 返回阿尔法缓冲区大小。 **See also** [alpha](qglformat.html#alpha)（）[setAlpha](qglformat.html#setAlpha)（）和[setAlphaBufferSize](qglformat.html#setAlphaBufferSize)（）。 ``` int QGLFormat.blueBufferSize (self) ``` 返回蓝色的缓冲区大小。这个函数中引入了Qt 4.2中。 **See also** [setBlueBufferSize](qglformat.html#setBlueBufferSize)（）。 ``` QGLFormat QGLFormat.defaultFormat () ``` [](qglformat.html) [返回默认](qglformat.html)[QGLFormat](qglformat.html)应用程序。所有[QGLWidget](qglwidget.html)除非指定了其他格式的创建使用这种格式的对象，如当它们被构造。如果没有特殊的默认格式已设定使用[setDefaultFormat](qglformat.html#setDefaultFormat)（），默认格式是相同的，与建立[QGLFormat](qglformat.html#QGLFormat)（）。 **See also** [setDefaultFormat](qglformat.html#setDefaultFormat)（）。 ``` QGLFormat QGLFormat.defaultOverlayFormat () ``` [](qglformat.html) [返回默认](qglformat.html)[QGLFormat](qglformat.html)对于叠加背景。默认叠加格式为： * [Double buffer:](qglformat.html#setDoubleBuffer) Disabled. * [Depth buffer:](qglformat.html#setDepth) Disabled. * [RGBA:](qglformat.html#setRgba) Disabled (i.e., color index enabled). * [Alpha channel:](qglformat.html#setAlpha) Disabled. * [Accumulator buffer:](qglformat.html#setAccum) Disabled. * [Stencil buffer:](qglformat.html#setStencil) Disabled. * [Stereo:](qglformat.html#setStereo) Disabled. * [Direct rendering:](qglformat.html#setDirectRendering) Enabled. * [Overlay:](qglformat.html#setOverlay) Disabled. * [Multisample buffers:](qglformat.html#setSampleBuffers) Disabled. * [Plane:](qglformat.html#setPlane) 1 (i.e., first overlay plane). **See also** [setDefaultOverlayFormat](qglformat.html#setDefaultOverlayFormat)（）和[setDefaultFormat](qglformat.html#setDefaultFormat)（）。 ``` bool QGLFormat.depth (self) ``` 返回True如果深度缓冲被启用，否则返回False 。深度缓存是默认启用的。 **See also** [setDepth](qglformat.html#setDepth)（）和[setDepthBufferSize](qglformat.html#setDepthBufferSize)（）。 ``` int QGLFormat.depthBufferSize (self) ``` 返回深度缓冲区的大小。 **See also** [depth](qglformat.html#depth)（）[setDepth](qglformat.html#setDepth)（）和[setDepthBufferSize](qglformat.html#setDepthBufferSize)（）。 ``` bool QGLFormat.directRendering (self) ``` 返回True如果直接渲染启用，否则返回False 。直接渲染是默认启用的。 **See also** [setDirectRendering](qglformat.html#setDirectRendering)（）。 ``` bool QGLFormat.doubleBuffer (self) ``` 返回True如果双缓冲使能，否则返回False 。双缓冲是默认启用的。 **See also** [setDoubleBuffer](qglformat.html#setDoubleBuffer)（）。 ``` int QGLFormat.greenBufferSize (self) ``` 返回绿化缓冲区大小。这个函数中引入了Qt 4.2中。 **See also** [setGreenBufferSize](qglformat.html#setGreenBufferSize)（）。 ``` bool QGLFormat.hasOpenGL () ``` 返回True如果窗口系统有任何的OpenGL支持，否则返回False 。 **Warning:**此函数不能被调用，直到[QApplication](qapplication.html)对象被创建。 ``` bool QGLFormat.hasOpenGLOverlays () ``` 返回True如果窗口系统支持OpenGL复盖，否则返回False 。 **Warning:**此函数不能被调用，直到[QApplication](qapplication.html)对象被创建。 ``` bool QGLFormat.hasOverlay (self) ``` 返回True如果复盖面已启用，否则返回False 。复盖默认是禁用的。 **See also** [setOverlay](qglformat.html#setOverlay)（）。 ``` int QGLFormat.majorVersion (self) ``` 返回OpenGL的主要版本。此功能被引入Qt的4.7 。 **See also** [setVersion](qglformat.html#setVersion)（）和[minorVersion](qglformat.html#minorVersion)（）。 ``` int QGLFormat.minorVersion (self) ``` 返回OpenGL的次要版本。此功能被引入Qt的4.7 。 **See also** [setVersion](qglformat.html#setVersion)（）和[majorVersion](qglformat.html#majorVersion)（）。 ``` OpenGLVersionFlags QGLFormat.openGLVersionFlags () ``` [ 标识，在运行时，它的OpenGL是由当前平台支持的版本。请注意，如果OpenGL版本1.5的支持，也支持它的前辈（即1.4版，下）。识别特定功能的支持，如多纹理，测试中首次引入的功能的版本（即版本在多纹理的情况下1.3），以适应运行时平台的最大可能的组。 ](index.htm) [此功能需要一个有效的当前的OpenGL上下文中工作，否则它会返回](index.htm)[OpenGL_Version_None](qglformat.html#OpenGLVersionFlag-enum)。这个函数中引入了Qt 4.2中。 **See also** [hasOpenGL](qglformat.html#hasOpenGL)（）和[hasOpenGLOverlays](qglformat.html#hasOpenGLOverlays)（）。 ``` int QGLFormat.plane (self) ``` 返回此格式的平面。默认为正常格式是0，这意味着在正常平面。默认为复盖格式是1 ，这是第一个复盖面。 **See also** [setPlane](qglformat.html#setPlane)（）和[defaultOverlayFormat](qglformat.html#defaultOverlayFormat)（）。 ``` OpenGLContextProfile QGLFormat.profile (self) ``` [ 返回OpenGL上下文配置文件。此功能被引入Qt的4.7 。 ](qglformat.html#OpenGLContextProfile-enum) [**See also**](qglformat.html#OpenGLContextProfile-enum) [setProfile](qglformat.html#setProfile)（）。 ``` int QGLFormat.redBufferSize (self) ``` 返回红色的缓冲区大小。这个函数中引入了Qt 4.2中。 **See also** [setRedBufferSize](qglformat.html#setRedBufferSize)（）。 ``` bool QGLFormat.rgba (self) ``` 返回True如果RGBA颜色模式设置。返回False，如果颜色索引模式设置。默认的色彩模式是RGBA 。 **See also** [setRgba](qglformat.html#setRgba)（）。 ``` bool QGLFormat.sampleBuffers (self) ``` 返回True如果多重采样缓冲支持允许，否则返回False 。多重采样缓冲区默认是禁用的。 **See also** [setSampleBuffers](qglformat.html#setSampleBuffers)（）。 ``` int QGLFormat.samples (self) ``` 返回每个像素的样本多重采样时启用的数量。默认情况下，最高的样本数是可被使用。 **See also** [setSampleBuffers](qglformat.html#setSampleBuffers)（）[sampleBuffers](qglformat.html#sampleBuffers)（）和[setSamples](qglformat.html#setSamples)（）。 ``` QGLFormat.setAccum (self, bool enable) ``` If _enable_是真正的使积累缓冲，否则将禁用积累缓冲区。积累缓冲区默认是禁用的。积累缓冲区用于创建模糊效果和多重曝光。 **See also** [accum](qglformat.html#accum)（）和[setAccumBufferSize](qglformat.html#setAccumBufferSize)（）。 ``` QGLFormat.setAccumBufferSize (self, int size) ``` 设置首选累加缓冲器的大小，其中_size_是比特深度的每个RGBA分量。 **See also** [accum](qglformat.html#accum)（）[setAccum](qglformat.html#setAccum)（）和[accumBufferSize](qglformat.html#accumBufferSize)（）。 ``` QGLFormat.setAlpha (self, bool enable) ``` If _enable_是真的让阿尔法缓冲，否则将禁用阿尔法缓冲区。阿尔法缓冲默认情况下禁用。阿尔法缓冲器通常用于实现透明性或半透明性。 RGBA中的A指定像素的透明度。 **See also** [alpha](qglformat.html#alpha)（）和[setAlphaBufferSize](qglformat.html#setAlphaBufferSize)（）。 ``` QGLFormat.setAlphaBufferSize (self, int size) ``` 设置优选的α缓冲区的大小为_size_。此功能允许隐式的alpha通道。 **See also** [setRedBufferSize](qglformat.html#setRedBufferSize)（）[setGreenBufferSize](qglformat.html#setGreenBufferSize)（）和[alphaBufferSize](qglformat.html#alphaBufferSize)（）。 ``` QGLFormat.setBlueBufferSize (self, int size) ``` 设置首选蓝色的缓冲区大小_size_。这个函数中引入了Qt 4.2中。 **See also** [blueBufferSize](qglformat.html#blueBufferSize)（）[setRedBufferSize](qglformat.html#setRedBufferSize)（）[setGreenBufferSize](qglformat.html#setGreenBufferSize)（）和[setAlphaBufferSize](qglformat.html#setAlphaBufferSize)（）。 ``` QGLFormat.setDefaultFormat (QGLFormat f) ``` 设置新的默认[QGLFormat](qglformat.html)为应用程序_f_。例如，要设置单缓冲为默认，而不是双缓冲，你的main（）中可能包含这样的代码： ``` [QApplication](qapplication.html) a(argc, argv); [QGLFormat](qglformat.html) f; f.setDoubleBuffer(false); [QGLFormat](qglformat.html).setDefaultFormat(f); ``` **See also** [defaultFormat](qglformat.html#defaultFormat)（）。 ``` QGLFormat.setDefaultOverlayFormat (QGLFormat f) ``` 设置新的默认[QGLFormat](qglformat.html)为复盖到上下文_f_。这个格式被用于每当一个[QGLWidget](qglwidget.html)与一个格式创建的[hasOverlay](qglformat.html#hasOverlay)（）启用。例如，要获得双重缓冲的复盖范围内（如果有的话），使用如下代码： ``` [QGLFormat](qglformat.html) f = [QGLFormat](qglformat.html).defaultOverlayFormat(); f.setDoubleBuffer(true); [QGLFormat](qglformat.html).setDefaultOverlayFormat(f); ``` 像往常一样，你可以创建小部件的底层OpenGL的系统是否能够提供所要求的规格后发现： ``` // ...continued from above MyGLWidget* myWidget = new MyGLWidget([QGLFormat](qglformat.html)(QGL.HasOverlay), ...); if (myWidget->format().hasOverlay()) { // Yes, we got an overlay, let's check _its_ format: [QGLContext](qglcontext.html)* olContext = myWidget->overlayContext(); if (olContext->format().doubleBuffer()) ; // yes, we got a double buffered overlay else ; // no, only single buffered overlays are available } ``` **See also** [defaultOverlayFormat](qglformat.html#defaultOverlayFormat)（）。 ``` QGLFormat.setDepth (self, bool enable) ``` If _enable_是真正的使深度缓冲区，否则禁用深度缓冲。深度缓存是默认启用的。深度缓冲（或Z缓冲）的目的是去除隐藏的表面。像素的基础上，以观众的距离分配的Z值。具有高Z值的像素更靠近观看者比具有低Z值的像素。此信息用于决定是否要绘制的像素或没有。 **See also** [depth](qglformat.html#depth)（）和[setDepthBufferSize](qglformat.html#setDepthBufferSize)（）。 ``` QGLFormat.setDepthBufferSize (self, int size) ``` 设置最小深度缓冲区的大小为_size_。 **See also** [depthBufferSize](qglformat.html#depthBufferSize)（）[setDepth](qglformat.html#setDepth)（）和[depth](qglformat.html#depth)（）。 ``` QGLFormat.setDirectRendering (self, bool enable) ``` If _enable_是真的，可直接渲染，否则禁止直接渲染。直接渲染是默认启用的。启用此选项将使绕过OpenGL的底层窗口系统，并直接从硬件渲染到屏幕上，如果这是支持的系统。 **See also** [directRendering](qglformat.html#directRendering)（）。 ``` QGLFormat.setDoubleBuffer (self, bool enable) ``` If _enable_是真正的集双缓冲，否则设置一个缓冲。双缓冲是默认启用的。双缓冲就是图形呈现在屏幕外的缓冲区，而不是直接到屏幕上的技术。当绘图完成时，程序调用一个swapBuffers （）函数来交换与缓冲器中的画面的内容。其结果是无闪烁画图，常常更好的性能。需要注意的是单缓冲环境目前不支持与EGL 。 **See also** [doubleBuffer](qglformat.html#doubleBuffer)（）[QGLContext.swapBuffers](qglcontext.html#swapBuffers)（）和[QGLWidget.swapBuffers](qglwidget.html#swapBuffers)（）。 ``` QGLFormat.setGreenBufferSize (self, int size) ``` 设置首选的绿色缓冲区大小_size_。这个函数中引入了Qt 4.2中。 **See also** [greenBufferSize](qglformat.html#greenBufferSize)（）[setRedBufferSize](qglformat.html#setRedBufferSize)（）[setBlueBufferSize](qglformat.html#setBlueBufferSize)（）和[setAlphaBufferSize](qglformat.html#setAlphaBufferSize)（）。 ``` QGLFormat.setOption (self, QGL.FormatOptions opt) ``` 设置格式选项_opt_。 **See also** [testOption](qglformat.html#testOption)（）。 ``` QGLFormat.setOverlay (self, bool enable) ``` If _enable_是真的让一个复盖面，否则禁止复盖面。启用复盖面会造成[QGLWidget](qglwidget.html)创建一个复盖面的附加上下文。请参阅[QGLWidget](qglwidget.html)文档了解更多信息。 **See also** [hasOverlay](qglformat.html#hasOverlay)（）。 ``` QGLFormat.setPlane (self, int plane) ``` 所要求的平面设置为_plane_。 0是正常的平面中， 1是第一复盖面， 2是第二复盖面等; -1，-2等是底层平面。请注意，相对于其他格式规范，飞机规格将完全匹配。这意味着，如果你指定一个平面底层OpenGL的系统不能提供，一个[invalid](qglwidget.html#isValid) [QGLWidget](qglwidget.html)将被创建。 **See also** [plane](qglformat.html#plane)（）。 ``` QGLFormat.setProfile (self, OpenGLContextProfile profile) ``` 设置OpenGL上下文配置文件_profile_。该_profile_如果所请求的OpenGL版本小于3.2被忽略。此功能被引入Qt的4.7 。 **See also** [profile](qglformat.html#profile)（）。 ``` QGLFormat.setRedBufferSize (self, int size) ``` 设置首选红色的缓冲区大小_size_。这个函数中引入了Qt 4.2中。 **See also** [redBufferSize](qglformat.html#redBufferSize)（）[setGreenBufferSize](qglformat.html#setGreenBufferSize)（）[setBlueBufferSize](qglformat.html#setBlueBufferSize)（）和[setAlphaBufferSize](qglformat.html#setAlphaBufferSize)（）。 ``` QGLFormat.setRgba (self, bool enable) ``` If _enable_是真正的集RGBA模式。如果_enable_是假套颜色索引模式。默认的色彩模式是RGBA 。 RGBA是大多数的OpenGL应用程序的首选模式。在RGBA颜色模式指定的颜色为红+绿+蓝+阿尔法四胞胎。在颜色索引模式中指定一个索引颜色查找表。 **See also** [rgba](qglformat.html#rgba)（）。 ``` QGLFormat.setSampleBuffers (self, bool enable) ``` If _enable_诚然，一个GL上下文与多重采样缓冲支持回升，否则忽略。 **See also** [sampleBuffers](qglformat.html#sampleBuffers)（）[setSamples](qglformat.html#setSamples)（）和[samples](qglformat.html#samples)（）。 ``` QGLFormat.setSamples (self, int numSamples) ``` 设置每个像素的样本的首选号码时，多重采样已启用_numSamples_。默认情况下，最多可用样本的使用。 **See also** [setSampleBuffers](qglformat.html#setSampleBuffers)（）[sampleBuffers](qglformat.html#sampleBuffers)（）和[samples](qglformat.html#samples)（）。 ``` QGLFormat.setStencil (self, bool enable) ``` If _enable_是真正的使模板缓冲，否则将禁用模板缓存。模板缓冲区是默认启用的。模板缓冲区口罩绘图区域的某些部分，这样蒙面零件不上绘制。 **See also** [stencil](qglformat.html#stencil)（）和[setStencilBufferSize](qglformat.html#setStencilBufferSize)（）。 ``` QGLFormat.setStencilBufferSize (self, int size) ``` 设置首选模板缓冲区大小_size_。 **See also** [stencilBufferSize](qglformat.html#stencilBufferSize)（）[setStencil](qglformat.html#setStencil)（）和[stencil](qglformat.html#stencil)（）。 ``` QGLFormat.setStereo (self, bool enable) ``` If _enable_是真的让立体声缓冲，否则将禁用立体声缓冲。立体声缓冲默认情况下禁用。立体声缓冲提供额外的颜色缓冲区生成左眼和右眼的图像。 **See also** [stereo](qglformat.html#stereo)（）。 ``` QGLFormat.setSwapInterval (self, int interval) ``` 设置首选的交换间隔。这可用于同步的GL绘图成一个系统的窗口，以在屏幕的垂直刷新。设置一个_interval_值为0将关闭垂直同步刷新关闭，大于0的任何值将变为垂直同步的。在Windows和X11下，其中`WGL_EXT_swap_control`和`GLX_SGI_video_sync`扩展的使用，_interval_参数可被用来设定显示之前将发生缓冲交换的视频帧的最小数目。实际上，在设置_interval_10 ，意味着将有每一个缓冲区交换之间的10个垂直回扫。在Windows下的`WGL_EXT_swap_control`扩展名必须存在，而且在X11下的`GLX_SGI_video_sync`扩展名必须存在。这个函数中引入了Qt 4.2中。 **See also** [swapInterval](qglformat.html#swapInterval)（）。 ``` QGLFormat.setVersion (self, int major, int minor) ``` 设置OpenGL版本到_major_和_minor_号码。如果所请求的OpenGL版本兼容的情况下不能创建，与1.x版本兼容的上下文被创建来代替。此功能被引入Qt的4.7 。 **See also** [majorVersion](qglformat.html#majorVersion)（）和[minorVersion](qglformat.html#minorVersion)（）。 ``` bool QGLFormat.stencil (self) ``` 返回True如果模板缓存被启用，否则返回False 。模板缓冲区是默认启用的。 **See also** [setStencil](qglformat.html#setStencil)（）和[setStencilBufferSize](qglformat.html#setStencilBufferSize)（）。 ``` int QGLFormat.stencilBufferSize (self) ``` 返回模板缓冲区大小。 **See also** [stencil](qglformat.html#stencil)（）[setStencil](qglformat.html#setStencil)（）和[setStencilBufferSize](qglformat.html#setStencilBufferSize)（）。 ``` bool QGLFormat.stereo (self) ``` 返回True如果立体声缓冲使能，否则返回False 。立体声缓冲默认情况下禁用。 **See also** [setStereo](qglformat.html#setStereo)（）。 ``` int QGLFormat.swapInterval (self) ``` 返回当前设置的交换间隔。如果设定的时间间隔交换不支持在系统总帐实现返回-1。这个函数中引入了Qt 4.2中。 **See also** [setSwapInterval](qglformat.html#setSwapInterval)（）。 ``` bool QGLFormat.testOption (self, QGL.FormatOptions opt) ``` 返回True如果格式选项_opt_被置位，否则返回False 。 **See also** [setOption](qglformat.html#setOption)（）。 ``` bool QGLFormat.__eq__ (self, QGLFormat) ``` ``` bool QGLFormat.__ne__ (self, QGLFormat) ```