upstream-man-pages/manglsl/memoryBarrierImage.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook MathML Module V1.1b1//EN"
   3               "http://www.oasis-open.org/docbook/xml/mathml/1.1CR1/dbmathml.dtd">
   4 <refentry id="memoryBarrierImage">
   5     <refmeta>
   6         <refmetainfo>
   7             <copyright>
   8                 <year>2012</year>
   9                 <holder>Khronos Group</holder>
  10             </copyright>
  11         </refmetainfo>
  12             <refentrytitle>memoryBarrierImage</refentrytitle>
  13         <manvolnum>3G</manvolnum>
  14     </refmeta>
  15     <refnamediv>
  16         <refname>memoryBarrierImage</refname>
  17         <refpurpose>controls the ordering of operations on image variables issued by a single shader invocation</refpurpose>
  18     </refnamediv>
  19     <refsynopsisdiv><title>Declaration</title>
  20         <funcsynopsis>
  21             <funcprototype>
  22                 <funcdef>void <function>memoryBarrierImage</function></funcdef>
  23                 <paramdef>void</paramdef>
  24             </funcprototype>
  25         </funcsynopsis>
  26     </refsynopsisdiv>
  27     <refsect1 id="description"><title>Description</title>
  28         <para>
  29             <function>memoryBarrierImage</function> waits on the completion of all memory accesses resulting
  30             from the use of image variables and then returns with no other effect.  When this function returns, the
  31             results of any modifications to the content of image variables will be visible
  32             to any access to the same buffer from other shader invocations.  In particular,
  33             any modifications made in one shader stage are guaranteed to be visible to accesses
  34             performed by shader invocations in subsequent stages when those invocations were triggered by the
  35             execution of the original shader invocation (e.g., fragment shader invocations for a primitive resulting
  36             from a particular geometry shader invocation).
  37         </para>
  38     </refsect1>
  39     <refsect1 id="versions"><title>Version Support</title>
  40         <informaltable frame="topbot">
  41             #VARTABLECOLS#
  42                 <thead>
  43                     #FUNCTABLEHEADER#
  44                     <row>
  45                         <entry>memoryBarrierImage</entry>#newin43#
  46                     </row>
  47                 </thead>
  48             </tgroup>
  49         </informaltable>
  50     </refsect1>
  51     <refsect1 id="seealso"><title>See Also</title>
  52         <para>
  53             <citerefentry><refentrytitle>memoryBarrier</refentrytitle></citerefentry>,
  54             <citerefentry><refentrytitle>memoryBarrierShared</refentrytitle></citerefentry>,
  55             <citerefentry><refentrytitle>memoryBarrierBuffer</refentrytitle></citerefentry>,
  56             <citerefentry><refentrytitle>groupMemoryBarrier</refentrytitle></citerefentry>
  57         </para>
  58     </refsect1>
  59     <refsect1 id="Copyright"><title>Copyright</title>
  60         <para>
  61             Copyright <trademark class="copyright"></trademark> 2011-2012 Khronos Group.
  62             This material may be distributed subject to the terms and conditions set forth in
  63             the Open Publication License, v 1.0, 8 June 1999.
  64             <ulink url="http://opencontent.org/openpub/">http://opencontent.org/openpub/</ulink>.
  65         </para>
  66     </refsect1>
  67 </refentry>