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/