<?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>cl_khr_gl_event</title>
    <meta name="generator" content="DocBook XSL Stylesheets V1.79.1" />
    <meta name="keywords" content="cl_khr_gl_event" />
  </head>
  <body>
    <div class="refentry">
      <a id="id-1"></a>
      <div class="titlepage"></div>
      <div xmlns="" class="refnamediv">
        <a xmlns="http://www.w3.org/1999/xhtml" id="cl_khr_gl_event"></a>
        <h1>cl_khr_gl_event</h1>
        <p>
            Create an OpenCL event object from a GL sync object.
        </p>
      </div>
      <div class="refsect2">
        <a id="synopsis"></a>
        <h3>
        </h3>
        <div class="informaltable">
          <table class="informaltable" border="0">
            <colgroup>
              <col align="left" class="col1" />
            </colgroup>
            <tbody>
              <tr>
                <td align="left">
cl_khr_gl_event
                        </td>
              </tr>
            </tbody>
          </table>
        </div>
      </div>
      <div class="refsect1">
        <a id="description"></a>
        <h2>Description</h2>
        <p>
            This extension enables the function 
            <a class="citerefentry" href="clCreateEventFromGLsyncKHR.html"><span class="citerefentry"><span class="refentrytitle">clCreateEventFromGLsyncKHR</span></span></a>.
        </p>
        <p>
            This extension allows creating OpenCL event objects linked to OpenGL fence sync objects,
            potentially improving efficiency of sharing images and buffers between the two APIs. The
            companion <code class="function">GL_ARB_cl_event</code> OpenGL extension provides the
            complementary functionality of creating an OpenGL sync object from an OpenCL event object.
        </p>
        <p>
            In addition, this extension modifies the behavior of 
            <a class="citerefentry" href="clEnqueueAcquireGLObjects.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueAcquireGLObjects</span></span></a>
            and <a class="citerefentry" href="clEnqueueReleaseGLObjects.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueReleaseGLObjects</span></span></a>
            to implicitly guarantee synchronization with an OpenGL context bound 
            in the same thread as the OpenCL context.
        </p>
        <p>
            If this extension is supported by an implementation, the 
            string <code class="function">cl_khr_gl_event</code>
            will be present in the <code class="constant">CL_PLATFORM_EXTENSIONS</code> 
            (see <a class="citerefentry" href="clGetPlatformInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetPlatformInfo</span></span></a>) 
            or <code class="constant">CL_DEVICE_EXTENSIONS</code> string 
            (see <a class="citerefentry" href="clGetDeviceInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetDeviceInfo</span></span></a>).
        </p>
      </div>
      <div class="refsect1">
        <a id="notes"></a>
        <h2>Notes</h2>
        <p>
        Event objects can also be used to reflect the 
        status of an OpenGL sync object. The sync object
        in turn refers to a fence command executing 
        in an OpenGL command stream. This provides
        another method of coordinating sharing of 
        buffers and images between OpenGL and OpenCL
        (see section 9.7.6.1).
        </p>
        <p>
            If the <code class="function">cl_khr_gl_event</code> extension is supported, 
            then the OpenCL implementation will ensure that
            any such pending OpenGL operations are complete 
            for an OpenGL context bound to the same
            thread as the OpenCL context. This is referred 
            to as implicit synchronization.
        </p>
        <p>
            If the <code class="function">cl_khr_gl_event</code> extension is 
            supported and the OpenGL context in question supports
            fence sync objects, completion of OpenGL commands may also 
            be determined by placing a GL fence command after
            those commands using <code class="function">glFenceSync</code>, 
            creating an event from the resulting GL sync object using 
            <a class="citerefentry" href="clCreateEventFromGLsyncKHR.html"><span class="citerefentry"><span class="refentrytitle">clCreateEventFromGLsyncKHR</span></span></a>, 
            and determining completion of that event object via 
            <a class="citerefentry" href="clEnqueueAcquireGLObjects.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueAcquireGLObjects</span></span></a>. 
            This method may be considerably more efficient than calling 
            <code class="function">glFinish</code>, and is referred to as
            <code class="varname">explicit synchronization</code>. Explicit 
            synchronization is most useful when an OpenGL context
            bound to another thread is accessing the memory objects.
        </p>
        <p>
            If the <code class="function">cl_khr_gl_event</code> extension 
            is not supported, completion of OpenGL commands may be
            determined by issuing and waiting for completion of a 
            <code class="function">glFinish</code> command on all OpenGL
            contexts with pending references to these objects. Some 
            implementations may offer other efficient synchronization
            methods. If such methods exist they will be described 
            in platform-specific documentation.
        </p>
        <p>
            Note that no synchronization method other than 
            <code class="function">glFinish</code> is portable between all OpenGL
            implementations and all OpenCL implementations. 
            While this is the only way to ensure completion that is portable
            to all platforms, <code class="function">glFinish</code> is 
            an expensive operation and its use should be avoided if the
            <code class="function">cl_khr_gl_event</code> extension is supported on a platform.
        </p>
      </div>
      <div class="refsect1">
        <a id="specification"></a>
        <h2>Specification</h2>
        <p>
            <img src="pdficon_small1.gif" />

            <a href="https://www.khronos.org/registry/cl/specs/opencl-2.1-extensions.pdf#namedest=cl_khr_gl_event" target="OpenCL Spec">OpenCL Specification</a>
        </p>
      </div>
      <div class="refsect1">
        <a id="seealso"></a>
        <h2>Also see</h2>
        <p>
            <a class="citerefentry" href="EXTENSION.html"><span class="citerefentry"><span class="refentrytitle">EXTENSION</span></span></a>,
            <a class="citerefentry" href="clCreateEventFromGLsyncKHR.html"><span class="citerefentry"><span class="refentrytitle">clCreateEventFromGLsyncKHR</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 © 2007-2015 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>