Last Revision Date: April 13, 2016 Page 3
6.12.1 Declaring and Using a Block .............................................................................................................. 64
6.12.2 Declaring a Block Reference .............................................................................................................. 65
6.12.3 Block Literal Expressions ................................................................................................................... 65
6.12.4 Control Flow ............................................................................................................................................. 67
6.12.5 Restrictions ............................................................................................................................................... 67
6.13 Built-in Functions ............................................................................................................................. 71
6.13.1 Work-Item Functions ........................................................................................................................... 71
6.13.2 Math Functions ....................................................................................................................................... 74
6.13.2.1 Floating-point macros and pragmas ........................................................................................................... 81
6.13.3 Integer Functions ................................................................................................................................... 84
6.13.4 Common Functions ............................................................................................................................... 88
6.13.5 Geometric Functions ............................................................................................................................. 90
6.13.6 Relational Functions ............................................................................................................................. 92
6.13.7 Vector Data Load and Store Functions .......................................................................................... 95
6.13.8 Synchronization Functions ................................................................................................................ 99
6.13.9 Address Space Qualifier Functions .............................................................................................. 101
6.13.10 Async Copies from Global to Local Memory, Local to Global Memory, and Prefetch
102
6.13.11 Atomic Functions ................................................................................................................................ 105
6.13.11.1 The ATOMIC_VAR_INIT macro .............................................................................................................. 106
6.13.11.2 The atomic_init function........................................................................................................................... 106
6.13.11.3 Order and Consistency .............................................................................................................................. 107
6.13.11.4 Memory Scope .............................................................................................................................................. 107
6.13.11.5 Fences ............................................................................................................................................................... 107
6.13.11.6 Atomic integer and floating-point types ........................................................................................... 108
6.13.11.7 Operations on atomic types .................................................................................................................... 109
6.13.11.8 Restrictions .................................................................................................................................................... 114
6.13.12 Miscellaneous Vector Functions ................................................................................................... 115
6.13.13 printf ......................................................................................................................................................... 117
6.13.13.1 printf output synchronization ............................................................................................................... 117
6.13.13.2 printf format string ..................................................................................................................................... 117
6.13.13.3 Differences between OpenCL C and C99 printf .............................................................................. 123
6.13.14 Image Read and Write Functions ................................................................................................. 125
6.13.14.1 Samplers .......................................................................................................................................................... 125
6.13.14.2 Built-in Image Read Functions .............................................................................................................. 129
6.13.14.3 Built-in Image Sampler-less Read Functions .................................................................................. 138
6.13.14.4 Built-in Image Write Functions ............................................................................................................. 145
6.13.14.5 Built-in Image Query Functions ............................................................................................................ 151
6.13.14.6 Reading and writing to the same image in a kernel ..................................................................... 153
6.13.14.7 Mapping image channels to color values returned by read_image and color values
passed to write_image to image channels...................................................................................................................... 154
6.13.15 Work-group Functions ...................................................................................................................... 156
6.13.16 Pipe Functions ...................................................................................................................................... 159
6.13.16.1 Restrictions .................................................................................................................................................... 159
6.13.16.2 Built-in Pipe Read and Write Functions ............................................................................................ 160
6.13.16.3 Built-in Work-group Pipe Read and Write Functions ................................................................. 161
6.13.16.4 Built-in Pipe Query Functions................................................................................................................ 162
6.13.16.5 Restrictions .................................................................................................................................................... 163
6.13.17 Enqueuing Kernels ............................................................................................................................. 164
6.13.17.1 Built-in Functions – Enqueuing a kernel ........................................................................................... 164
6.13.17.2 Arguments that are a pointer type to local address space ........................................................ 167
6.13.17.3 A Complete Example .................................................................................................................................. 169
