<!DOCTYPE refentry [ <!ENTITY % mathent SYSTEM "math.ent"> %mathent; ]>

<!-- Converted by db4-upgrade version 1.1 -->

<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="imageStore">
    <info>
        <copyright>
            <year>2011-2015</year>
            <holder>Khronos Group</holder>
        </copyright>
    </info>
    <refmeta>
        <refentrytitle>imageStore</refentrytitle>
        <manvolnum>3G</manvolnum>
    </refmeta>
    <refnamediv>
        <refname>imageStore</refname>
        <refpurpose>write a single texel into an image</refpurpose>
    </refnamediv>
    <refsynopsisdiv>
        <title>Declaration</title>
        <funcsynopsis>
            <funcprototype>
                <funcdef>void <function>imageStore</function></funcdef>
                <paramdef>gimage2D <parameter>image</parameter></paramdef>
                <paramdef>ivec2 <parameter>P</parameter></paramdef>
                <paramdef>gvec4 <parameter>data</parameter></paramdef>
            </funcprototype>
            <funcprototype>
                <funcdef>void <function>imageStore</function></funcdef>
                <paramdef>gimage3D <parameter>image</parameter></paramdef>
                <paramdef>ivec3 <parameter>P</parameter></paramdef>
                <paramdef>gvec4 <parameter>data</parameter></paramdef>
            </funcprototype>
            <funcprototype>
                <funcdef>void <function>imageStore</function></funcdef>
                <paramdef>gimageCube <parameter>image</parameter></paramdef>
                <paramdef>ivec3 <parameter>P</parameter></paramdef>
                <paramdef>gvec4 <parameter>data</parameter></paramdef>
            </funcprototype>
            <funcprototype>
                <funcdef>void <function>imageStore</function></funcdef>
                <paramdef>gimage2DArray <parameter>image</parameter></paramdef>
                <paramdef>ivec3 <parameter>P</parameter></paramdef>
                <paramdef>gvec4 <parameter>data</parameter></paramdef>
            </funcprototype>
        </funcsynopsis>
    </refsynopsisdiv>
    <refsect1 xml:id="parameters"><title>Parameters</title>
        <variablelist>
        <varlistentry>
            <term><parameter>image</parameter></term>
            <listitem>
                <para>
                    Specify the image unit into which to store a texel.
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><parameter>P</parameter></term>
            <listitem>
                <para>
                    Specify the coordinate at which to store the texel.
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><parameter>data</parameter></term>
            <listitem>
                <para>
                    Specifies the data to store into the image.
                </para>
            </listitem>
        </varlistentry>
        </variablelist>
    </refsect1>
    <refsect1 xml:id="description"><title>Description</title>
        <para>
            <function>imageStore</function> stores <parameter>data</parameter> into the texel at the coordinate <parameter>P</parameter> from 
            the image specified by <parameter>image</parameter>.   When 
            <parameter>image</parameter> and <parameter>P</parameter> identify a valid texel, the bits 
            used to represent data are converted to the format of the image unit in the manner described in of the OpenGL Specification and stored to 
            the specified texel.
        </para>
    </refsect1>
    <refsect1 xml:id="versions">
        <title>Version Support</title>
        <informaltable>
            <tgroup cols="4" align="left">
                <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="funchead.xml" xpointer="xpointer(/*/*)"/>
                <tbody>
                    <row>
                        <entry><function>imageStore</function></entry>
                        <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="version.xml" xpointer="xpointer(/*/*[@role='es31']/*)"/>
                    </row>
                </tbody>
            </tgroup>
        </informaltable>
    </refsect1>
    <refsect1 xml:id="seealso"><title>See Also</title>
        <para>
            <citerefentry><refentrytitle>imageLoad</refentrytitle></citerefentry>
        </para>
    </refsect1>
    <refsect1 xml:id="Copyright"><title>Copyright</title>
        <para>
            Copyright <trademark class="copyright"/> 2011-2015 Khronos Group. 
            This material may be distributed subject to the terms and conditions set forth in 
            the Open Publication License, v 1.0, 8 June 1999.
            <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://opencontent.org/openpub/">http://opencontent.org/openpub/</link>.
        </para>
    </refsect1>
</refentry>
