eglGetConfigAttrib函数用法

http://www.khronos.org/opengles/documentation/opengles1_0/html/eglGetConfigAttrib.html

Name

eglGetConfigAttrib - return information about an EGL frame buffer configuration
返回一个EGL帧缓存配置的信息.

C Specification

EGLBoolean eglGetConfigAttrib(EGLDisplay display,

    EGLConfig config,

    EGLint attribute,

    EGLint * value)

Parameters

display

Specifies the EGL display connection.

指定EGL显示连接.

config

Specifies the EGL frame buffer configuration to be queried.

指定要查询的EGL帧缓存配置.

attribute

Specifies the EGL rendering context attribute to be returned.

指定要查询的EGL渲染上下文属性.

value

Returns the requested value.

返回查询得到的值.

Description

eglGetConfigAttrib returns in value the value of attribute for config. attribute can be one of the following:
函数返回配置config的属性attribute的值value.属性attribute的值可以是:

EGL_BUFFER_SIZE

Returns the depth of the color buffer. It is the sum of EGL_RED_SIZE, EGL_GREEN_SIZE,EGL_BLUE_SIZE, and EGL_ALPHA_SIZE.

返回颜色缓冲区的深度,其值是 EGL_RED_SIZE, EGL_GREEN_SIZE,EGL_BLUE_SIZE, 和 EGL_ALPHA_SIZE四个值的和.

EGL_RED_SIZE

Returns the number of bits of red stored in the color buffer.

返回颜色缓冲区中红色的位数.

EGL_GREEN_SIZE

Returns the number of bits of green stored in the color buffer.

返回颜色缓冲区中绿色的位数.

EGL_BLUE_SIZE

Returns the number of bits of blue stored in the color buffer.

返回颜色缓冲区中蓝色的位数.

EGL_ALPHA_SIZE

Returns the number of bits of alpha stored in the color buffer.

返回颜色缓冲区中alpha的位数.

EGL_CONFIG_CAVEAT

Returns the caveats for the frame buffer configuration. Possible caveat values are EGL_NONE,EGL_SLOW_CONFIG, and EGL_NON_CONFORMANT.

返回帧缓存配置的警告,可能的警告值为: EGL_NONE,EGL_SLOW_CONFIG, 和 EGL_NON_CONFORMANT

EGL_CONFIG_ID

Returns the ID of the frame buffer configuration.

返回帧缓存配置的ID.

EGL_DEPTH_SIZE

Returns the number of bits in the depth buffer.

返回深度缓存的位数.

EGL_LEVEL

Returns the frame buffer level. Level zero is the default frame buffer. Positive levels correspond to frame buffers that overlay the default buffer and negative levels correspond to frame buffers that underlay the default buffer.

返回帧缓存层次.层次0是默认的帧缓存.正数的层次对应默认缓存之上的帧缓存,负数的层次对应默认缓存之下的帧缓存.

EGL_MAX_PBUFFER_WIDTH

Returns the maximum width of a pixel buffer surface in pixels.

返回像素缓冲区的最大宽度,以像素为单位.

EGL_MAX_PBUFFER_HEIGHT

Returns the maximum height of a pixel buffer surface in pixels.

返回像素缓冲区的最大高度,以像素为单位.

EGL_MAX_PBUFFER_PIXELS

Returns the maximum size of a pixel buffer surface in pixels.

返回像素缓冲区surface的最大size,以像素为单位.

EGL_NATIVE_RENDERABLE

Returns EGL_TRUE if native rendering APIs can render into the surface, EGL_FALSE otherwise.

如果native的渲染API能够渲染到surface,则返回EGL_TRUE;否则返回EGL_FALSE.

EGL_NATIVE_VISUAL_ID

Returns the ID of the associated native visual.

返回关联的native visual的ID.

EGL_NATIVE_VISUAL_TYPE

Returns the type of the associated native visual.

返回关联的native visual的类型.

EGL_PRESERVED_RESOURCES

Returns EGL_TRUE if resources are preserved across power management events, EGL_FALSE otherwise.

如果在电源管理过程中,资源被保留,返回EGL_TRUE,否则返回EGL_FALSE.

EGL_SAMPLE_BUFFERS

Returns the number of multisample buffers.

返回多采样缓存的个数.

EGL_SAMPLES

Returns the number of samples per pixel.

返回每个像素的采样个数.

EGL_STENCIL_BITS

Returns the number of bits in the stencil buffer.

返回模板缓冲区的位数.

EGL_SURFACE_TYPE

Returns the types of supported EGL surfaces.

返回支持的EGL surface类型.

EGL_TRANSPARENT_TYPE

Returns the type of supported transparency. Possible transparency values are: EGL_NONE, andEGL_TRANSPARENT_RGB.

返回支持的透明类型.可能的值为EGL_NONE或EGL_TRANSPARENT_RGB.

EGL_TRANSPARENT_RED

Returns the transparent red value.

返回透明的红色的值。

EGL_TRANSPARENT_GREEN

Returns the transparent green value.

返回透明的绿色的值。

EGL_TRANSPARENT_BLUE

Returns the transparent blue value.

返回透明的蓝色的值。

Errors

EGL_FALSE is returned on failure, EGL_TRUE otherwise. value is not modified when EGL_FALSE is returned.
如果失败则返回EGL_FALSE，否则返回EGL_TRUE。如果返回EGL_FALSE,那么值value将不会被改变。


EGL_BAD_DISPLAY is generated if display is not an EGL display connection.
如果display不是EGL显示连接，将生成EGL_BAD_DISPLAY错误.


EGL_NOT_INITIALIZED is generated if display has not been initialized.
如果显示display没有被初始化，将生成EGL_NOT_INITIALIZED错误。


EGL_BAD_CONFIG is generated if config is not an EGL frame buffer configuration.
如果配置config不是一个EGL帧缓存配置，生成EGL_BAD_CONFIG错误。


EGL_BAD_ATTRIBUTE is generated if attribute is not a valid frame buffer configuration attribute.
如果属性attribute不是合法的帧缓存配置属性，将会生成EGL_BAD_ATTRIBUTE错误。

Copyright

Copyright © 2003 Silicon Graphics, Inc.
This document is licensed under the SGI Free Software B License. For details, seehttp://oss.sgi.com/projects/FreeB/.

See Also

eglChooseConfig, eglGetConfigs