OpenCL: Difference between revisions
Line 246: | Line 246: | ||
==Usage== | ==Usage== | ||
===Types=== | ===Scalar Types=== | ||
[https://www.khronos.org/registry/OpenCL/sdk/1. | [https://www.khronos.org/registry/OpenCL/sdk/1.2/docs/man/xhtml/scalarDataTypes.html OpenCL 1.2 Scalar Data Types]<br> | ||
While all OpenCL devices support single-precision floats, not all support double-precision doubles.<br> | While all OpenCL devices support single-precision floats, not all support double-precision doubles.<br> | ||
===Vector Types=== | |||
[https://www.khronos.org/registry/OpenCL/sdk/1.2/docs/man/xhtml/dataTypes.html OpenCL Data Types]<br> | |||
[https://www.khronos.org/registry/OpenCL/sdk/1.2/docs/man/xhtml/vectorDataTypes.html OpenCL 1.2 Vector Data Types]<br> | |||
Just like glsl, OpenCL supports vector types such | Just like glsl, OpenCL supports vector types such | ||
<syntaxhighlight lang="c">float3 my_vec = (float3)(1.0);</syntaxhighlight> | <syntaxhighlight lang="c">float3 my_vec = (float3)(1.0);</syntaxhighlight> | ||
where its elements are accessed using x,y,z as <code>my_vec.x</code>.<br> | where its elements are accessed using x,y,z as <code>my_vec.x</code>.<br> | ||
To convert between vector types, use <code>convert_T()</code><br> | To convert between vector types, use <code>convert_T()</code><br> | ||
;Notes | |||
* 3-component data types are aligned to 4 components. I.e. an array of <code>uchar3</code> with 4 elements will be equivalent to an array of <code>uchar4</code> with 4 elements. | |||
==Advanced Topics== | ==Advanced Topics== | ||
====Local Memory v. Global Memory==== | ====Local Memory v. Global Memory==== |
Revision as of 13:13, 30 March 2020
Installation
Windows
If you're using an NVIDIA GPU, install the CUDA Toolkit.
Linux
https://gist.github.com/Brainiarc7/dc80b023af5b4e0d02b33923de7ba1ed
Getting Started
Compiling
OpenCL kernels are compiled at runtime. All you have to do is link OpenCL when compiling your program and include your kernels in your program. For gcc
just add flag -lOpenCL
C
See https://www.eriksmistad.no/getting-started-with-opencl-and-gpu-computing/
C++
C++ Bindings
While you can use the C bindings in your C++ application, Khronos also provides a set of C++ bindings in CL/cl.hpp
(or CL/cl2.hpp
) which are much easier to use alongside std containers such as std::vector
. When using C++ bindings, you also do not need to worry about releasing buffers since these are reference-counted.
Julia
See OpenCL.jl.
Usage
Scalar Types
OpenCL 1.2 Scalar Data Types
While all OpenCL devices support single-precision floats, not all support double-precision doubles.
Vector Types
OpenCL Data Types
OpenCL 1.2 Vector Data Types
Just like glsl, OpenCL supports vector types such
float3 my_vec = (float3)(1.0);
where its elements are accessed using x,y,z as my_vec.x
.
To convert between vector types, use convert_T()
- Notes
- 3-component data types are aligned to 4 components. I.e. an array of
uchar3
with 4 elements will be equivalent to an array ofuchar4
with 4 elements.