eglCreateContext - EGL Reference Pages

From a556b45abf18f1bd509daaf63b66b7d55e9fd291 Mon Sep 17 00:00:00 2001 From: jjesswan Date: Mon, 22 Apr 2024 21:56:26 -0400 Subject: add engine version --- .../sdk/docs/man/html/eglCreateContext.xhtml | 287 +++++++++++++++++++++ 1 file changed, 287 insertions(+) create mode 100644 engine-ocean/External/glew/auto/EGL-Registry/sdk/docs/man/html/eglCreateContext.xhtml (limited to 'engine-ocean/External/glew/auto/EGL-Registry/sdk/docs/man/html/eglCreateContext.xhtml') diff --git a/engine-ocean/External/glew/auto/EGL-Registry/sdk/docs/man/html/eglCreateContext.xhtml b/engine-ocean/External/glew/auto/EGL-Registry/sdk/docs/man/html/eglCreateContext.xhtml new file mode 100644 index 0000000..3b60280 --- /dev/null +++ b/engine-ocean/External/glew/auto/EGL-Registry/sdk/docs/man/html/eglCreateContext.xhtml @@ -0,0 +1,287 @@ + + + + eglCreateContext - EGL Reference Pages + + + + +

Name

eglCreateContext — + create a new EGL rendering context +

C Specification

+ + + + + + + + + + + + + + + + + +

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

Parameters

+ + + display + + +: +
+ Specifies the + EGL + display connection. +
+
+ + + config + + +: +
Specifies the EGL frame buffer configuration that + defines the frame buffer resource available to the rendering context. +
+
+ + + share_context + + +: +
+ Specifies another + EGL + rendering context with which to share data, as + defined by the client API corresponding to the + contexts. Data is also shared with all other + contexts with which + share_context shares data. + EGL_NO_CONTEXT indicates that + no sharing is to take place. +
+
+ + + attrib_list + + +: +
+ Specifies attributes and attribute values for the + context being created. Only the attribute + EGL_CONTEXT_CLIENT_VERSION may + be specified. +
+

Description

+ eglCreateContext creates an EGL + rendering context for the current rendering API (as set with + eglBindAPI) and returns a handle to the + context. The context can then be used to render into an EGL + drawing surface. If eglCreateContext + fails to create a rendering context, + EGL_NO_CONTEXT is returned. +

+ If share_context is not + EGL_NO_CONTEXT, then all shareable data + in the context (as defined by the client API specification + for the current rendering API) are shared by context + share_context, all other contexts + share_context already shares with, + and the newly created context. An arbitrary number of + rendering contexts can share data. However, all rendering + contexts that share data must themselves exist in the same + address space. Two rendering contexts share an address space + if both are owned by a single process. +

+ attrib_list specifies a list of + attributes for the context. The list has the same structure + as described for eglChooseConfig. The + attributes and attribute values which may be specified are + as follows: +

+ + EGL_CONTEXT_MAJOR_VERSION + +

+ Must be followed by an integer specifying the requested + major version of an OpenGL or OpenGL ES context. The + default value is 1. This attribute is an alias of the + older EGL_CONTEXT_CLIENT_VERSION, + and the tokens may be used interchangeably. +

+ + EGL_CONTEXT_MINOR_VERSION + +

+ Must be followed by an integer specifying the requested + minor version of an OpenGL or OpenGL ES context. The + default value is 0. +

+ + EGL_CONTEXT_OPENGL_PROFILE_MASK + +

+ Must be followed by an integer bitmask specifying the + profile of an OpenGL context. + Bits which may be set include + EGL_CONTEXT_OPENGL_CORE_PROFILE_BIT + for a core profile and + EGL_CONTEXT_OPENGL_COMPATIBILITY_PROFILE_BIT + for a compatibility profile. The default value is + EGL_CONTEXT_OPENGL_CORE_PROFILE_BIT. + All OpenGL 3.2 and later implementations are required to + implement the core profile, but implementation of the + compatibility profile is optional. +

+ + EGL_CONTEXT_OPENGL_DEBUG + +

+ Must be followed by EGL_TRUE, + specifying that an OpenGL or OpenGL ES debug + context should be created, or + EGL_FALSE, if a non-debug context + should be created. The default value is + EGL_FALSE. +

+ + EGL_CONTEXT_OPENGL_FORWARD_COMPATIBLE + +

+ Must be followed by EGL_TRUE, + specifying that a + forward-compatible OpenGL context + should be created, or EGL_FALSE, if + a non-forward-compatible context should be created. The + default value is EGL_FALSE. +

+ + EGL_CONTEXT_OPENGL_ROBUST_ACCESS + +

+ Must be followed by EGL_TRUE, + specifying that an OpenGL or OpenGL ES context + supporting robust buffer access + should be created, or EGL_FALSE, if + a non-robust context should be created. The default + value is EGL_FALSE. +

+ + EGL_CONTEXT_OPENGL_RESET_NOTIFICATION_STRATEGY + +

+ Must be followed by + EGL_LOSE_CONTEXT_ON_RESET, + specifying that an OpenGL or OpenGL ES context with + reset notification behavior + GL_LOSE_CONTEXT_ON_RESET_ARB should + be created, or + EGL_NO_RESET_NOTIFICATION, + specifying that an OpenGL or OpenGL ES context with + reset notification behavior + GL_NO_RESET_NOTIFICATION_ARB should + be created, as described by the + GL_ARB_robustness extension. +

+ If the + EGL_CONTEXT_OPENGL_ROBUST_ACCESS + attribute is not set to EGL_TRUE, + context creation will not fail, but the resulting + context may not support robust buffer access, and + therefore may not support the requested reset + notification strategy The default value for + EGL_CONTEXT_OPENGL_RESET_NOTIFICATION_STRATEGY + is EGL_NO_RESET_NOTIFICATION . +

+ There are many possible interactions between requested OpenGL + and OpenGL ES context creation attributes, depending on the API + versions and extensions supported by the implementation. These + interactions are described in detail in the EGL 1.5 + Specification, but are not listed here for compactness. The + requested attributes may not be able to be satisfied, but + context creation may still succeed. Applications should ensure + that the OpenGL or OpenGL ES contexts supports needed features + before using them, by determining the actual context version, + supported extensions, and supported context flags using runtime + queries. +