diff options
Diffstat (limited to 'glew/auto/EGL-Registry/sdk/docs/man/xhtml/eglCreateContext.html')
| -rw-r--r-- | glew/auto/EGL-Registry/sdk/docs/man/xhtml/eglCreateContext.html | 488 |
1 files changed, 488 insertions, 0 deletions
diff --git a/glew/auto/EGL-Registry/sdk/docs/man/xhtml/eglCreateContext.html b/glew/auto/EGL-Registry/sdk/docs/man/xhtml/eglCreateContext.html new file mode 100644 index 0000000..55c317c --- /dev/null +++ b/glew/auto/EGL-Registry/sdk/docs/man/xhtml/eglCreateContext.html @@ -0,0 +1,488 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd"> +<!-- saved from url=(0013)about:internet --> +<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" xmlns:xlink="http://www.w3.org/1999/xlink" pref:renderer="mathplayer-dl"> + <head> + <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> + <style xmlns="" type="text/css"> + /* This style sets a margin around the entire page */ + html, body { + margin: 10px; + } + + p { + font: normal 16px verdana, sans-serif; + margin: 0; + padding-bottom:12px; + } + + h1 { + font: bold 25px verdana, sans-serif; + margin-top: 0; + margin-bottom: 3px; + padding-top: 0; + padding-bottom: 0; + } + + h2 { + font: bold 19px verdana, sans-serif; + margin-top: 28px; + margin-bottom: 3px; + padding-top: 0; + padding-bottom: 0; + } + + h3 { + font: bold 19px verdana, sans-serif !important; + margin-top: 28px; + margin-bottom: 3px; + padding-top: 0; + padding-bottom: 0; + } + + li { + font: normal 16px verdana, sans-serif; + margin-top: 0; + margin-bottom: 18px; + padding-top: 0; + padding-bottom: 0; + } + + .pdparam { + font: italic 16px verdana, sans-serif; + } + + .term { + font: italic 16px verdana, sans-serif; + font-weight: normal; + } + + .type { + font: normal 16px verdana, sans-serif !important; + } + + .parameter { + font-style: italic; + } + + a:link, a:visited { + color: blue; + text-decoration: none; + font: normal 16px; + } + + a:hover { + background-color: #FFFF99; + font: normal 16px; + } + + div.funcsynopsis { + text-align: left; + background-color: #e6e6e6; + font: normal 16px verdana, sans-serif; + padding-top: 10px; + padding-bottom: 10px; + } + + div.funcsynopsis table { + border-collapse: separate; + font: normal 16px verdana, sans-serif; + } + + div.funcsynopsis td { + background-color: #e6e6e6; + border: 0 solid #000; + padding: 1px; + font: normal 16px verdana, sans-serif; + } + + div.refsect1 { + font-family: verdana, sans-serif; + font-size: 16px; + } + + code.constant { + font: normal 16px courier new, monospace !important; + } + + span.errorname { + font: normal 16px verdana, sans-serif !important; + } + + code.function { + font: bold 16px verdana, sans-serif !important; + } + + b.fsfunc { + font: bold 16px verdana, sans-serif !important; + } + + code.varname { + font: italic 16px verdana, sans-serif; + } + + code.replaceable { + font: italic 16px courier new, monospace; + } + + code.funcdef { + font: normal 16px verdana, sans-serif !important; + } + + .citerefentry { + font: normal 16px verdana, sans-serif !important; + } + + .parameter { + font-style: italic; + } + + code.fsfunc { + font: normal 16px verdana, sans-serif !important; + } + + /* PARAMETER: This style controls spacing between the terms in Parameter section */ + dt { + margin-top: 15px; + } + + /* TABLES: These styles apply to all tables OTHER than the Synopsis and Example tables */ + div.refsect1 table { + width: 100%; + margin-top: 10px; + background-color: #FFF; + border-collapse: collapse; + border-color: #000; + border-width: 1px; + font: normal 16px verdana, sans-serif; + } + + div.refsect1 th { + border-collapse: collapse; + border-color: #000; + border-width: 1px; + font: bold 16px verdana, sans-serif; + } + + div.refsect1 td { + background-color: #FFF; + padding: 5px; + vertical-align: text-top; + border-collapse: collapse; + border-color: #000; + border-width: 1px; + font: normal 16px verdana, sans-serif; + } + + div.refsect1 p{ + font: normal 16px verdana, sans-serif; + margin-top: 8px; + margin-bottom: 8px; + padding-top: 0; + padding-bottom: 0; + } + + + /* EXAMPLE: These styles apply only to the Example section */ + div.refsect2 { + font: normal 16px courier new, monospace !important; + } + + div.refsect2 table { + margin-top: 0; + background-color: #e6e6e6; + width: 100%; + border: 0 solid #000; + padding: 2px; + font: normal 16px courier new, monospace !important; + } + + div.refsect2 td { + background-color: #e6e6e6; + font: normal 16px courier new, monospace !important; + white-space:pre; + } + + /* COPYRIGHT: This style formats the text of the copyright statement at the bottom of the page */ + div.refsect3 { + font: normal 11px verdana, sans-serif; + margin-top: 50px; + margin-bottom: 20px; + padding-top: 0; + padding-bottom: 0; + } + +</style> + <title>eglCreateContext</title> + <meta name="generator" content="DocBook XSL Stylesheets V1.78.1" /> + </head> + <body> + <div class="refentry"> + <a id="eglCreateContext"></a> + <div class="titlepage"></div> + <div xmlns="" class="refnamediv"> + <h1>eglCreateContext</h1> + <p> + create a new <acronym xmlns="http://www.w3.org/1999/xhtml" class="acronym">EGL</acronym> rendering context + </p> + </div> + <div class="refsynopsisdiv"> + <h2>C Specification</h2> + <div class="funcsynopsis"> + <table xmlns="" border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"> + <tr valign="bottom"> + <td> + <code xmlns="http://www.w3.org/1999/xhtml" class="funcdef">EGLContext <strong class="fsfunc">eglCreateContext</strong>(</code> + <td>EGLDisplay <var xmlns="http://www.w3.org/1999/xhtml" class="pdparam">display</var>, </td> + </td> + </tr> + <tr valign="top"> + <td> </td> + <td>EGLConfig <var xmlns="http://www.w3.org/1999/xhtml" class="pdparam">config</var>, </td> + </tr> + <tr valign="top"> + <td> </td> + <td>EGLContext <var xmlns="http://www.w3.org/1999/xhtml" class="pdparam">share_context</var>, </td> + </tr> + <tr valign="top"> + <td> </td> + <td>EGLint const * <var xmlns="http://www.w3.org/1999/xhtml" class="pdparam">attrib_list</var><code>)</code></td> + </tr> + </table> + </div> + </div> + <div class="refsect1"> + <a id="parameters"></a> + <h2>Parameters</h2> + <div class="variablelist"> + <dl class="variablelist"> + <dt> + <span class="term"> + <em class="parameter"> + <code>display</code> + </em> + </span> + </dt> + <dd> + <p> + Specifies the + <acronym class="acronym">EGL</acronym> + display connection. + </p> + </dd> + <dt> + <span class="term"> + <em class="parameter"> + <code>config</code> + </em> + </span> + </dt> + <dd> + <p>Specifies the EGL frame buffer configuration that + defines the frame buffer resource available to the rendering context. + </p> + </dd> + <dt> + <span class="term"> + <em class="parameter"> + <code>share_context</code> + </em> + </span> + </dt> + <dd> + <p> + Specifies another + <acronym class="acronym">EGL</acronym> + 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 + <em class="parameter"><code>share_context</code></em> shares data. + <code class="constant">EGL_NO_CONTEXT</code> indicates that + no sharing is to take place. + </p> + </dd> + <dt> + <span class="term"> + <em class="parameter"> + <code>attrib_list</code> + </em> + </span> + </dt> + <dd> + <p> + Specifies attributes and attribute values for the + context being created. Only the attribute + <code class="constant">EGL_CONTEXT_CLIENT_VERSION</code> may + be specified. + </p> + </dd> + </dl> + </div> + </div> + <div class="refsect1"> + <a id="description"></a> + <h2>Description</h2> + <p> + <code class="function">eglCreateContext</code> creates an EGL + rendering context for the current rendering API (as set with + <code class="function">eglBindAPI</code>) and returns a handle to the + context. The context can then be used to render into an EGL + drawing surface. If <code class="function">eglCreateContext</code> + fails to create a rendering context, + <code class="constant">EGL_NO_CONTEXT</code> is returned. + </p> + <p> + If <em class="parameter"><code>share_context</code></em> is not + <code class="constant">EGL_NO_CONTEXT</code>, then all shareable data + in the context (as defined by the client API specification + for the current rendering API) are shared by context + <em class="parameter"><code>share_context</code></em>, all other contexts + <em class="parameter"><code>share_context</code></em> 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. + </p> + <p> + <em class="parameter"><code>attrib_list</code></em> specifies a list of + attributes for the context. The list has the same structure + as described for <code class="function">eglChooseConfig</code>. The + attributes and attribute values which may be specified are + as follows: + </p> + <div class="variablelist"> + <dl class="variablelist"> + <dt> + <span class="term"> + <code class="constant">EGL_CONTEXT_CLIENT_VERSION</code> + </span> + </dt> + <dd> + <p> + Must be followed by an integer that determines which + version of an OpenGL ES context to create. A value + of 1 specifies creation of an OpenGL ES 1.x context. + An attribute value of 2 specifies creation of an + OpenGL ES 2.x context. The default value is 1. This + attribute can only be specified when creating a + OpenGL ES context (e.g. when the current rendering + API is <code class="constant">EGL_OPENGL_ES_API</code>). + </p> + </dd> + </dl> + </div> + </div> + <div class="refsect1"> + <a id="notes"></a> + <h2>Notes</h2> + <p> + The current rendering API is only respected if the EGL + version is 1.2 or greater. Otherwise, an OpenGL ES context + will always be created. + </p> + <p> + The <code class="constant">EGL_CONTEXT_CLIENT_VERSION</code> + attribute is only supported if the EGL version is 1.3 or + greater. + </p> + <p> + A <em class="firstterm">process</em> is a single execution environment, + implemented in a single address space, consisting of one or more threads. + </p> + <p> + A <em class="firstterm">thread</em> is one of a set of subprocesses that + share a single address space, but maintain separate program counters, + stack spaces, and other related global data. + A thread is the only member of its subprocess group is equivalent to a + process. + </p> + </div> + <div class="refsect1"> + <a id="errors"></a> + <h2>Errors</h2> + <p> + <code class="constant">EGL_NO_CONTEXT</code> is returned if creation of + the context fails. + </p> + <p> + <code class="constant">EGL_BAD_MATCH</code> is generated if the + current rendering API is <code class="constant">EGL_NONE</code> (this + can only arise in an EGL implementation which does not + support OpenGL ES, prior to the first call to + <code class="function">eglBindAPI</code>). + </p> + <p> + <code class="constant">EGL_BAD_MATCH</code> is generated if the + server context state for + <em class="parameter"><code>share_context</code></em> exists in an address + space which cannot be shared with the newly created context, + if <em class="parameter"><code>share_context</code></em> was created on a + different display than the one referenced by + <em class="parameter"><code>config</code></em>, or if the contexts are + otherwise incompatible. + </p> + <p> + <code class="constant">EGL_BAD_DISPLAY</code> is generated if + <em class="parameter"><code>display</code></em> is not an EGL display connection. + </p> + <p> + <code class="constant">EGL_NOT_INITIALIZED</code> is generated if + <em class="parameter"><code>display</code></em> has not been initialized. + </p> + <p> + <code class="constant">EGL_BAD_CONFIG</code> is generated if + <em class="parameter"><code>config</code></em> is not an EGL frame buffer + configuration, or does not support the current rendering + API. This includes requesting creation of an OpenGL ES 1.x + context when the <code class="constant">EGL_RENDERABLE_TYPE</code> + attribute of <em class="parameter"><code>config</code></em> does not contain + <code class="constant">EGL_OPENGL_ES_BIT</code>, or creation of an + OpenGL ES 2.x context when the attribute does not contain + <code class="constant">EGL_OPENGL_ES2_BIT</code>. + </p> + <p> + <code class="constant">EGL_BAD_CONTEXT</code> is generated if + <em class="parameter"><code>share_context</code></em> is not an EGL rendering + context of the same client API type as the newly created + context and is not <code class="constant">EGL_NO_CONTEXT</code>. + </p> + <p> + <code class="constant">EGL_BAD_ATTRIBUTE</code> is generated if + <em class="parameter"><code>attrib_list</code></em> contains an invalid + context attribute or if an attribute is not recognized or + out of range. Note that attribute + <code class="constant">EGL_CONTEXT_CLIENT_VERSION</code> is + only valid when the current rendering API is + <code class="constant">EGL_OPENGL_ES_API</code>. + </p> + <p> + <code class="constant">EGL_BAD_ALLOC</code> is generated if there are not + enough resources to allocate the new context. + </p> + </div> + <div class="refsect1"> + <a id="seealso"></a> + <h2>See Also</h2> + <p> + <a class="citerefentry" href="eglDestroyContext.html"><span class="citerefentry"><span class="refentrytitle">eglDestroyContext</span></span></a>, + <a class="citerefentry" href="eglChooseConfig.html"><span class="citerefentry"><span class="refentrytitle">eglChooseConfig</span></span></a>, + <a class="citerefentry" href="eglGetConfigs.html"><span class="citerefentry"><span class="refentrytitle">eglGetConfigs</span></span></a>, + <a class="citerefentry" href="eglMakeCurrent.html"><span class="citerefentry"><span class="refentrytitle">eglMakeCurrent</span></span></a> + </p> + </div> + <div xmlns="" class="refsect3" lang="en" xml:lang="en"><a xmlns="http://www.w3.org/1999/xhtml" id="Copyright"></a><h4 xmlns="http://www.w3.org/1999/xhtml"></h4><img xmlns="http://www.w3.org/1999/xhtml" src="KhronosLogo.jpg" /><p xmlns="http://www.w3.org/1999/xhtml"></p> +Copyright © 2003-2014 The Khronos Group Inc. +Permission is hereby granted, free of charge, to any person obtaining a +copy of this software and/or associated documentation files (the +"Materials"), to deal in the Materials without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Materials, and to +permit persons to whom the Materials are furnished to do so, subject to +the condition that this copyright notice and permission notice shall be included +in all copies or substantial portions of the Materials. +</div> + </div> + </body> +</html> |