102f4aeb0Sopenharmony_ci<?xml version="1.0" encoding="UTF-8" standalone="no"?> 202f4aeb0Sopenharmony_ci<!DOCTYPE html><html xmlns="http://www.w3.org/1999/xhtml"> 302f4aeb0Sopenharmony_ci <head> 402f4aeb0Sopenharmony_ci <title xmlns:xlink="http://www.w3.org/1999/xlink">eglGetPlatformDisplay - EGL Reference Pages</title> 502f4aeb0Sopenharmony_ci <link rel="stylesheet" type="text/css" href="khronos-man.css"/> 602f4aeb0Sopenharmony_ci <meta name="generator" content="DocBook XSL Stylesheets V1.79.1"/> 702f4aeb0Sopenharmony_ci </head> 802f4aeb0Sopenharmony_ci <body> 902f4aeb0Sopenharmony_ci <header/> 1002f4aeb0Sopenharmony_ci <div class="refentry" id="eglGetPlatformDisplay"> 1102f4aeb0Sopenharmony_ci <div class="titlepage"/> 1202f4aeb0Sopenharmony_ci <div class="refnamediv"> 1302f4aeb0Sopenharmony_ci <h2>Name</h2> 1402f4aeb0Sopenharmony_ci <p>eglGetPlatformDisplay — 1502f4aeb0Sopenharmony_ci return an <abbr class="acronym">EGL</abbr> display connection 1602f4aeb0Sopenharmony_ci </p> 1702f4aeb0Sopenharmony_ci </div> 1802f4aeb0Sopenharmony_ci <div class="refsynopsisdiv"> 1902f4aeb0Sopenharmony_ci <h2>C Specification</h2> 2002f4aeb0Sopenharmony_ci <div class="funcsynopsis"> 2102f4aeb0Sopenharmony_ci <table style="border: 0; cellspacing: 0; cellpadding: 0;" class="funcprototype-table"> 2202f4aeb0Sopenharmony_ci <tr> 2302f4aeb0Sopenharmony_ci <td> 2402f4aeb0Sopenharmony_ci <code class="funcdef">EGLDisplay <strong class="fsfunc">eglGetPlatformDisplay</strong>(</code> 2502f4aeb0Sopenharmony_ci </td> 2602f4aeb0Sopenharmony_ci <td>EGLenum <var class="pdparam">platform</var>, </td> 2702f4aeb0Sopenharmony_ci </tr> 2802f4aeb0Sopenharmony_ci <tr> 2902f4aeb0Sopenharmony_ci <td> </td> 3002f4aeb0Sopenharmony_ci <td>void * <var class="pdparam">native_display</var>, </td> 3102f4aeb0Sopenharmony_ci </tr> 3202f4aeb0Sopenharmony_ci <tr> 3302f4aeb0Sopenharmony_ci <td> </td> 3402f4aeb0Sopenharmony_ci <td>const EGLAttrib * <var class="pdparam">attrib_list</var><code>)</code>;</td> 3502f4aeb0Sopenharmony_ci </tr> 3602f4aeb0Sopenharmony_ci </table> 3702f4aeb0Sopenharmony_ci <div class="funcprototype-spacer"> </div> 3802f4aeb0Sopenharmony_ci </div> 3902f4aeb0Sopenharmony_ci </div> 4002f4aeb0Sopenharmony_ci <div class="refsect1" id="parameters"> 4102f4aeb0Sopenharmony_ci <h2>Parameters</h2> 4202f4aeb0Sopenharmony_ci <div class="variablelist"> 4302f4aeb0Sopenharmony_ci <dl class="variablelist"> 4402f4aeb0Sopenharmony_ci <dt> 4502f4aeb0Sopenharmony_ci <span class="term"> 4602f4aeb0Sopenharmony_ci <em class="parameter"> 4702f4aeb0Sopenharmony_ci <code>platform</code> 4802f4aeb0Sopenharmony_ci </em> 4902f4aeb0Sopenharmony_ci </span> 5002f4aeb0Sopenharmony_ci </dt> 5102f4aeb0Sopenharmony_ci <dd> 5202f4aeb0Sopenharmony_ci <p> 5302f4aeb0Sopenharmony_ci Specifies the native platform to obtain a display for. 5402f4aeb0Sopenharmony_ci </p> 5502f4aeb0Sopenharmony_ci </dd> 5602f4aeb0Sopenharmony_ci <dt> 5702f4aeb0Sopenharmony_ci <span class="term"> 5802f4aeb0Sopenharmony_ci <em class="parameter"> 5902f4aeb0Sopenharmony_ci <code>native_display</code> 6002f4aeb0Sopenharmony_ci </em> 6102f4aeb0Sopenharmony_ci </span> 6202f4aeb0Sopenharmony_ci </dt> 6302f4aeb0Sopenharmony_ci <dd> 6402f4aeb0Sopenharmony_ci <p> 6502f4aeb0Sopenharmony_ci Specifies the native display to connect to. 6602f4aeb0Sopenharmony_ci </p> 6702f4aeb0Sopenharmony_ci </dd> 6802f4aeb0Sopenharmony_ci <dt> 6902f4aeb0Sopenharmony_ci <span class="term"> 7002f4aeb0Sopenharmony_ci <em class="parameter"> 7102f4aeb0Sopenharmony_ci <code>attrib_list</code> 7202f4aeb0Sopenharmony_ci </em> 7302f4aeb0Sopenharmony_ci </span> 7402f4aeb0Sopenharmony_ci </dt> 7502f4aeb0Sopenharmony_ci <dd> 7602f4aeb0Sopenharmony_ci <p> 7702f4aeb0Sopenharmony_ci Specifies attributes of the display being obtained. 7802f4aeb0Sopenharmony_ci </p> 7902f4aeb0Sopenharmony_ci </dd> 8002f4aeb0Sopenharmony_ci </dl> 8102f4aeb0Sopenharmony_ci </div> 8202f4aeb0Sopenharmony_ci </div> 8302f4aeb0Sopenharmony_ci <div class="refsect1" id="description"> 8402f4aeb0Sopenharmony_ci <h2>Description</h2> 8502f4aeb0Sopenharmony_ci <p> 8602f4aeb0Sopenharmony_ci <code class="function">eglGetPlatformDisplay</code> obtains an 8702f4aeb0Sopenharmony_ci <abbr class="acronym">EGL</abbr> display connection for the specified 8802f4aeb0Sopenharmony_ci <em class="parameter"><code>platform</code></em> and 8902f4aeb0Sopenharmony_ci <em class="parameter"><code>native_display</code></em>. 9002f4aeb0Sopenharmony_ci </p> 9102f4aeb0Sopenharmony_ci <p> 9202f4aeb0Sopenharmony_ci Valid values for <em class="parameter"><code>platform</code></em> are defined by 9302f4aeb0Sopenharmony_ci EGL extensions, as are requirements for 9402f4aeb0Sopenharmony_ci <em class="parameter"><code>native_display</code></em>. 9502f4aeb0Sopenharmony_ci For example, an extension specification that defines support for 9602f4aeb0Sopenharmony_ci the X11 platform may require that 9702f4aeb0Sopenharmony_ci <em class="parameter"><code>native_display</code></em> be a pointer to an X11 9802f4aeb0Sopenharmony_ci Display, and an extension specification that defines support for 9902f4aeb0Sopenharmony_ci the Microsoft Windows platform may require that 10002f4aeb0Sopenharmony_ci <em class="parameter"><code>native_display</code></em> be a pointer to a Windows 10102f4aeb0Sopenharmony_ci Device Context. 10202f4aeb0Sopenharmony_ci </p> 10302f4aeb0Sopenharmony_ci <p> 10402f4aeb0Sopenharmony_ci Valid attributes are defined by EGL extensions. 10502f4aeb0Sopenharmony_ci All attributes in <em class="parameter"><code>attrib_list</code></em>, 10602f4aeb0Sopenharmony_ci including boolean attributes, are immediately followed by 10702f4aeb0Sopenharmony_ci the corresponding desired value. 10802f4aeb0Sopenharmony_ci The list is terminated with <code class="constant">EGL_NONE</code>. 10902f4aeb0Sopenharmony_ci If an attribute is not specified in 11002f4aeb0Sopenharmony_ci <em class="parameter"><code>attrib_list</code></em> but is required for the 11102f4aeb0Sopenharmony_ci specified <em class="parameter"><code>platform</code></em>, then a default value 11202f4aeb0Sopenharmony_ci is used (and the attribute is said to be specified implicitly). 11302f4aeb0Sopenharmony_ci </p> 11402f4aeb0Sopenharmony_ci <p> 11502f4aeb0Sopenharmony_ci Multiple calls made to 11602f4aeb0Sopenharmony_ci <code class="function">eglGetPlatformDisplay</code> with the same 11702f4aeb0Sopenharmony_ci parameters will return the same <span class="type">EGLDisplay</span> handle. 11802f4aeb0Sopenharmony_ci </p> 11902f4aeb0Sopenharmony_ci <p> 12002f4aeb0Sopenharmony_ci If <em class="parameter"><code>platform</code></em> is valid but no display 12102f4aeb0Sopenharmony_ci matching <em class="parameter"><code>native_display</code></em> is available, 12202f4aeb0Sopenharmony_ci then <code class="constant">EGL_NO_DISPLAY</code> is returned; no error 12302f4aeb0Sopenharmony_ci condition is raised in this case. 12402f4aeb0Sopenharmony_ci </p> 12502f4aeb0Sopenharmony_ci </div> 12602f4aeb0Sopenharmony_ci <div class="refsect1" id="notes"> 12702f4aeb0Sopenharmony_ci <h2>Notes</h2> 12802f4aeb0Sopenharmony_ci <p> 12902f4aeb0Sopenharmony_ci <code class="function">eglGetPlatformDisplay</code> is supported only if 13002f4aeb0Sopenharmony_ci the EGL version is 1.5 or greater. 13102f4aeb0Sopenharmony_ci </p> 13202f4aeb0Sopenharmony_ci </div> 13302f4aeb0Sopenharmony_ci <div class="refsect1" id="errors"> 13402f4aeb0Sopenharmony_ci <h2>Errors</h2> 13502f4aeb0Sopenharmony_ci <p> 13602f4aeb0Sopenharmony_ci <code class="function">eglGetPlatformDisplay</code> returns 13702f4aeb0Sopenharmony_ci <code class="constant">EGL_NO_DISPLAY</code> on failure. 13802f4aeb0Sopenharmony_ci </p> 13902f4aeb0Sopenharmony_ci <p> 14002f4aeb0Sopenharmony_ci An <code class="constant">EGL_BAD_PARAMETER</code> error is generated if 14102f4aeb0Sopenharmony_ci <em class="parameter"><code>platform</code></em> has an invalid value. 14202f4aeb0Sopenharmony_ci </p> 14302f4aeb0Sopenharmony_ci </div> 14402f4aeb0Sopenharmony_ci <div class="refsect1" id="seealso"> 14502f4aeb0Sopenharmony_ci <h2>See Also</h2> 14602f4aeb0Sopenharmony_ci <p> 14702f4aeb0Sopenharmony_ci <a class="citerefentry" href="eglInitialize.xhtml"><span class="citerefentry"><span class="refentrytitle">eglInitialize</span></span></a>, 14802f4aeb0Sopenharmony_ci <a class="citerefentry" href="eglGetDisplay.xhtml"><span class="citerefentry"><span class="refentrytitle">eglGetDisplay</span></span></a> 14902f4aeb0Sopenharmony_ci </p> 15002f4aeb0Sopenharmony_ci </div> 15102f4aeb0Sopenharmony_ci <p> 15202f4aeb0Sopenharmony_ci </p> 15302f4aeb0Sopenharmony_ci <div class="refsect3" id="copyright"> 15402f4aeb0Sopenharmony_ci <img src="KhronosLogo.jpg"/> 15502f4aeb0Sopenharmony_ci <p> 15602f4aeb0Sopenharmony_ci Copyright © 2003-2014 The Khronos Group Inc. 15702f4aeb0Sopenharmony_ci Permission is hereby granted, free of charge, to any person obtaining a 15802f4aeb0Sopenharmony_ci copy of this software and/or associated documentation files (the 15902f4aeb0Sopenharmony_ci "Materials"), to deal in the Materials without restriction, including 16002f4aeb0Sopenharmony_ci without limitation the rights to use, copy, modify, merge, publish, 16102f4aeb0Sopenharmony_ci distribute, sublicense, and/or sell copies of the Materials, and to 16202f4aeb0Sopenharmony_ci permit persons to whom the Materials are furnished to do so, subject to 16302f4aeb0Sopenharmony_ci the condition that this copyright notice and permission notice shall be included 16402f4aeb0Sopenharmony_ci in all copies or substantial portions of the Materials. 16502f4aeb0Sopenharmony_ci </p> 16602f4aeb0Sopenharmony_ci </div> 16702f4aeb0Sopenharmony_ci <p> 16802f4aeb0Sopenharmony_ci</p> 16902f4aeb0Sopenharmony_ci </div> 17002f4aeb0Sopenharmony_ci <footer/> 17102f4aeb0Sopenharmony_ci </body> 17202f4aeb0Sopenharmony_ci</html> 173
