The OpenCL Extension Specification Version: 2.0 Document Revision: 26 Khronos OpenCL Working Group Editor: Aaftab Munshi Last Revision Date: 11/1/14 Page 1 9. OPTIONAL EXTENSIONS ................................................................................................. 7 9.1 Compiler Directives for Optional Extensions .................................................................................. 8 9.2 Getting OpenCL API Extension Function Pointers ........................................................................ 9 9.3 64-bit Atomics ................................................................................................................................... 12 9.4 Half Precision Floating-Point .......................................................................................................... 14 9.4.1 Conversions ................................................................................................................................................. 14 9.4.2 Math Functions ........................................................................................................................................... 15 9.4.3 Common Functions ..................................................................................................................................... 19 9.4.4 Geometric Functions ................................................................................................................................... 21 9.4.5 Relational Functions ................................................................................................................................... 21 9.4.6 Vector Data Load and Store Functions ....................................................................................................... 23 9.4.7 Async Copies from Global to Local Memory, Local to Global Memory, and Prefetch ............................ 23 9.4.8 Image Read and Write Functions ................................................................................................................ 25 9.4.9 IEEE754 Compliance .................................................................................................................................. 34 9.4.10 Relative Error as ULPs ............................................................................................................................. 35 9.5 Creating CL context from a GL context or share group .............................................................. 38 9.5.1 Overview ..................................................................................................................................................... 38 9.5.2 New Procedures and Functions ................................................................................................................... 38 9.5.3 New Tokens ................................................................................................................................................ 38 9.5.4 Additions to Chapter 4 of the OpenCL 2.0 Specification ........................................................................... 39 9.5.5 Additions to section 9.7 of the OpenCL 2.0 Extension Specification ........................................................ 41 9.5.6 Issues ........................................................................................................................................................... 44 9.6 Sharing Memory Objects with OpenGL / OpenGL ES Buffer, Texture and Renderbuffer Objects ........................................................................................................................................................ 47 9.6.1 Lifetime of Shared Objects ......................................................................................................................... 47 9.6.2 CL Buffer Objects ! GL Buffer Objects ................................................................................................... 48 9.6.3 CL Image Objects ! GL Textures ............................................................................................................. 49 9.6.3.1 List of OpenGL and corresponding OpenCL Image Formats ............................................................................... 51 9.6.4 CL Image Objects ! GL Renderbuffers .................................................................................................... 52 9.6.5 Querying GL object information from a CL memory object ...................................................................... 54 9.6.6 Sharing memory objects that map to GL objects between GL and CL contexts ........................................ 56 9.6.6.1 Synchronizing OpenCL and OpenGL Access to Shared Objects .......................................................................... 58 9.7 Creating CL event objects from GL sync objects ......................................................................... 60 9.7.1 Overview ..................................................................................................................................................... 60 9.7.2 New Procedures and Functions ................................................................................................................... 60 9.7.3 New Tokens ................................................................................................................................................ 60 9.7.4 Additions to Chapter 5 of the OpenCL 2.0 Specification ........................................................................... 60 9.7.5 Additions to Chapter 9 of the OpenCL 2.0 Specification ........................................................................... 62 9.7.6 Issues ........................................................................................................................................................... 63 9.8 Sharing Memory Objects with Direct3D 10 .................................................................................. 65 9.8.1 Overview ..................................................................................................................................................... 65 9.8.2 Header File .................................................................................................................................................. 65 9.8.3 New Procedures and Functions ................................................................................................................... 65 9.8.4 New Tokens ................................................................................................................................................ 66 Last Revision Date: 11/1/14 Page 2 9.8.5 Additions to Chapter 4 of the OpenCL 2.0 Specification ........................................................................... 67 9.8.6 Additions to Chapter 5 of the OpenCL 2.0 Specification ........................................................................... 68 9.8.7 Sharing Memory Objects with Direct3D 10 Resources .............................................................................. 69 9.8.7.1 Querying OpenCL Devices Corresponding to Direct3D 10 Devices .................................................................... 70 9.8.7.2 Lifetime of Shared Objects .................................................................................................................................... 71 9.8.7.3 Sharing Direct3D 10 Buffer Resources as OpenCL Buffer Objects ...................................................................... 72 9.8.7.4 Sharing Direct3D 10 Texture and Resources as OpenCL Image Objects ............................................................. 73 9.8.7.5 Querying Direct3D properties of memory objects created from Direct3D 10 resources ...................................... 76 9.8.7.6 Sharing memory objects created from Direct3D 10 resources between Direct3D 10 and OpenCL contexts ....... 76 9.8.8 Issues ........................................................................................................................................................... 80 9.9 DX9 Media Surface Sharing ........................................................................................................... 82 9.9.1 Overview ..................................................................................................................................................... 82 9.9.2 Header File .................................................................................................................................................. 82 9.9.3 New Procedures and Functions ................................................................................................................... 82 9.9.4 New Tokens ................................................................................................................................................ 83 9.9.5 Additions to Chapter 4 of the OpenCL 2.0 Specification ........................................................................... 84 9.9.6 Additions to Chapter 5 of the OpenCL 2.0 Specification ........................................................................... 85 9.9.7 Sharing Media Surfaces with OpenCL ....................................................................................................... 86 9.9.7.1 Querying OpenCL Devices corresponding to Media Adapters ............................................................................. 86 9.9.7.2 Creating Media Resources as OpenCL Image Objects .........................................................................................