EGL函数翻译--eglCreateContext

EGL函数翻译–eglCreateContext

函数名

 EGLContext eglCreateContext(EGLDisplay display,
 							EGLConfig config,
 							EGLContext share_context,
 							EGLint const * attrib_list); 

参数描述

display
指定 EGL 显示连接。

config
指定 EGL 帧缓冲配置，该配置定义了渲染上下文可用的帧缓冲资源。

share_context
指定另一个 EGL 渲染上下文，与之共享数据，数据共享由与上下文对应的客户端 API 定义。数据还与所有与 share_context 共享数据的其他上下文共享。如果指定为 EGL_NO_CONTEXT，则不进行数据共享。

attrib_list
指定为正在创建的上下文的属性和属性值。

详细描述

eglCreateContext 为当前渲染 API（通过 eglBindAPI 设置）创建一个 EGL 渲染上下文，并返回该上下文的句柄。然后可以使用该上下文在 EGL 绘图表面上进行渲染。如果 eglCreateContext 无法创建渲染上下文，则返回 EGL_NO_CONTEXT。

如果 share_context 不是 EGL_NO_CONTEXT，那么上下文中所有可共享的数据（由当前渲染 API 的客户端 API 规范定义）将由 share_context、share_context 已经共享数据的所有其他上下文以及新创建的上下文共享。可以共享数据的渲染上下文数量没有限制。然而，所有共享数据的渲染上下文必须在同一地址空间中存在。如果两个渲染上下文都属于一个进程，则它们共享同一地址空间。

attrib_list 指定上下文的属性列表。该列表的结构与 eglChooseConfig 中描述的相同。可以指定的属性及其属性值如下：

属性：EGL_CONTEXT_MAJOR_VERSION
后面必须跟一个整数，指定请求的 OpenGL 或 OpenGL ES 上下文的主版本号。默认值为 1。此属性是较旧的 EGL_CONTEXT_CLIENT_VERSION 的别名，可以互换使用这两个标记。

属性：EGL_CONTEXT_MINOR_VERSION
后面必须跟一个整数，指定请求的 OpenGL 或 OpenGL ES 上下文的次版本号。默认值为 0。

属性：EGL_CONTEXT_OPENGL_PROFILE_MASK
后面必须跟一个整数位掩码，指定 OpenGL 上下文的配置文件。可以设置的位包括 EGL_CONTEXT_OPENGL_CORE_PROFILE_BIT（用于核心配置文件）和 EGL_CONTEXT_OPENGL_COMPATIBILITY_PROFILE_BIT（用于兼容性配置文件）。默认值为 EGL_CONTEXT_OPENGL_CORE_PROFILE_BIT。所有 OpenGL 3.2 及更高版本的实现都必须实现核心配置文件，但兼容性配置文件的实现是可选的。

属性：EGL_CONTEXT_OPENGL_DEBUG
后面必须跟 EGL_TRUE，指定应创建一个 OpenGL 或 OpenGL ES 调试上下文，或者跟 EGL_FALSE，指定应创建一个非调试上下文。默认值为 EGL_FALSE。

属性：EGL_CONTEXT_OPENGL_FORWARD_COMPATIBLE
后面必须跟 EGL_TRUE，指定应创建一个前向兼容的 OpenGL 上下文，或者跟 EGL_FALSE，指定应创建一个非前向兼容的上下文。默认值为 EGL_FALSE。

属性：EGL_CONTEXT_OPENGL_ROBUST_ACCESS
后面必须跟 EGL_TRUE，指定应创建一个支持健壮缓冲区访问的 OpenGL 或 OpenGL ES 上下文，或者跟 EGL_FALSE，指定应创建一个非健壮的上下文。默认值为 EGL_FALSE。

属性：EGL_CONTEXT_OPENGL_RESET_NOTIFICATION_STRATEGY
后面必须跟 EGL_LOSE_CONTEXT_ON_RESET，指定应创建一个具有重置通知行为 GL_LOSE_CONTEXT_ON_RESET_ARB 的 OpenGL 或 OpenGL ES 上下文，或者跟 EGL_NO_RESET_NOTIFICATION，指定应创建一个具有重置通知行为 GL_NO_RESET_NOTIFICATION_ARB 的 OpenGL 或 OpenGL ES 上下文，详见 GL_ARB_robustness 扩展。

如果 EGL_CONTEXT_OPENGL_ROBUST_ACCESS 属性未设置为 EGL_TRUE，上下文创建不会失败，但生成的上下文可能不支持健壮缓冲区访问，因此可能不支持请求的重置通知策略。EGL_CONTEXT_OPENGL_RESET_NOTIFICATION_STRATEGY 的默认值为 EGL_NO_RESET_NOTIFICATION。

根据实现支持的 API 版本和扩展，请求的 OpenGL 和 OpenGL ES 上下文创建属性之间可能存在许多可能的交互。详细描述请参阅 EGL 1.5 规范，这里未列出以保持紧凑性。请求的属性可能无法满足，但上下文创建可能仍然成功。应用程序应确保 OpenGL 或 OpenGL ES 上下文支持所需的功能，在使用之前通过运行时查询确定实际的上下文版本、支持的扩展和支持的上下文标志。

英文连接

链接: https://registry.khronos.org/EGL/sdk/docs/man/