NAME

       imageAtomicCompSwap - atomically compares supplied data with that in memory and
       conditionally stores it to memory

DECLARATION

       uint imageAtomicCompSwap(gimage1D image, int P, uint compare, uint data);

       uint imageAtomicCompSwap(gimage2D image, ivec2 P, uint compare, uint data);

       uint imageAtomicCompSwap(gimage3D image, ivec3 P, uint compare, uint data);

       uint imageAtomicCompSwap(gimage2DRect image, ivec2 P, uint compare, uint data);

       uint imageAtomicCompSwap(gimageCube image, ivec3 P, uint compare, uint data);

       uint imageAtomicCompSwap(gbufferImage image, int P, uint compare, uint data);

       uint imageAtomicCompSwap(gimage1DArray image, ivec2 P, uint compare, uint data);

       uint imageAtomicCompSwap(gimage2DArray image, ivec3 P, uint compare, uint data);

       uint imageAtomicCompSwap(gimageCubeArray image, ivec3 P, uint compare, uint data);

       uint imageAtomicCompSwap(gimage2DMS image, ivec2 P, int sample, uint compare, uint data);

       uint imageAtomicCompSwap(gimage2DMSArray image, ivec3 P, int sample, uint compare,
                                uint data);

       int imageAtomicCompSwap(gimage1D image, int P, int compare, int data);

       int imageAtomicCompSwap(gimage2D image, ivec2 P, int compare, int data);

       int imageAtomicCompSwap(gimage3D image, ivec3 P, int compare, int data);

       int imageAtomicCompSwap(gimage2DRect image, ivec2 P, int compare, int data);

       int imageAtomicCompSwap(gimageCube image, ivec3 P, int compare, int data);

       int imageAtomicCompSwap(gbufferImage image, int P, int compare, int data);

       int imageAtomicCompSwap(gimage1DArray image, ivec2 P, int compare, int data);

       int imageAtomicCompSwap(gimage2DArray image, ivec3 P, int compare, int data);

       int imageAtomicCompSwap(gimageCubeArray image, ivec3 P, int compare, int data);

       int imageAtomicCompSwap(gimage2DMS image, ivec2 P, int sample, int compare, int data);

       int imageAtomicCompSwap(gimage2DMSArray image, ivec3 P, int sample, int compare,
                               int data);

PARAMETERS

       image
           Specify the image unit into which to compare and conditionally store data.

       P
           Specify the coordinate at which to compare and conditionally store the data.

       sample
           When present, specifies the sample within the image to compare and conditionally store
           into.

       compare
           Specifies the value to compare with the content of the image.

       data
           Specifies the value to store in the image if compare is equal to the existing image
           content.

DESCRIPTION

       imageAtomicCompSwap atomically compares the value of compare with that of the texel at
       coordinate P and sample (for multisampled forms) in the image bound to uint image. If the
       values are equal, data is stored into the texel, otherwise it is discarded. It returns the
       original value of the texel regardless of the result of the comparison operation.

VERSION SUPPORT

       ┌────────────────────┬───────────────────────────────────────────────────────────────────────────────────┐
       │                    │        OpenGL Shading Language Version                                            │
       ├────────────────────┼──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┤
       │Function            │ 1.10 │ 1.20 │ 1.30 │ 1.40 │ 1.50 │ 3.30 │ 4.00 │ 4.10 │ 4.20 │ 4.30 │ 4.40 │ 4.50 │
       │Name                │      │      │      │      │      │      │      │      │      │      │      │      │
       ├────────────────────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┤
       │imageAtomicCompSwap │  -   │  -   │  -   │  -   │  -   │  -   │  -   │  -   │  ✔   │  ✔   │  ✔   │  ✔   │
       └────────────────────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┘

SEE ALSO

       imageLoad(), imageStore(), imageAtomicAdd(), imageAtomicMin(), imageAtomicMax(),
       imageAtomicXor(), imageAtomicOr(), imageAtomicAnd(), imageAtomicCompSwap()

COPYRIGHT

       Copyright © 2011-2014 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.
       http://opencontent.org/openpub/.

COPYRIGHT

       Copyright © 2011-2014 Khronos Group

[FIXME: source]                             07/22/2015                    IMAGEATOMICCOMPSWAP(3G)