mirror of
https://github.com/boostorg/compute.git
synced 2026-01-28 07:02:15 +00:00
83 lines
2.0 KiB
Plaintext
83 lines
2.0 KiB
Plaintext
[section:getting_started Getting Started]
|
|
|
|
[section Downloading]
|
|
|
|
Boost.Compute is not yet an offical Boost library and therefore is not
|
|
packaged with the standard Boost distribution. To download the library use the
|
|
following command:
|
|
|
|
[endsect]
|
|
|
|
``
|
|
git clone git://github.com/kylelutz/compute.git
|
|
``
|
|
|
|
[section Compilation and Usage]
|
|
|
|
Boost.Compute is a header-only library, so no linking is required. To use the
|
|
library just add the include directory to the compilation flags and link with
|
|
the system's OpenCL library. For example, with GCC:
|
|
|
|
``
|
|
g++ -I/path/to/compute/include main.cpp -lOpenCL
|
|
``
|
|
|
|
All of the Boost.Compute headers can be included with the following directive:
|
|
|
|
``
|
|
#include <boost/compute.hpp>
|
|
``
|
|
|
|
If you only want to include the core OpenCL wrapper headers (which have minimal
|
|
dependencies on the rest of Boost), use the following directive:
|
|
|
|
``
|
|
#include <boost/compute/core.hpp>
|
|
``
|
|
|
|
All of the classes and functions in Boost.Compute live in the `boost::compute`
|
|
namespace and can be brought into global scope with:
|
|
|
|
``
|
|
using namespace boost::compute;
|
|
``
|
|
|
|
[endsect]
|
|
|
|
[section Installation]
|
|
|
|
Boost.Compute can also be installed system-wide. After compiling, run the
|
|
following command to install the Boost.Compute headers. By default, they will
|
|
be installed under `/usr/local/include`.
|
|
|
|
[pre
|
|
make install
|
|
]
|
|
|
|
After installing, Boost.Compute can be used through cmake by adding the following
|
|
to your `CMakeLists.txt`:
|
|
|
|
[pre
|
|
find_package(BoostCompute REQUIRED)
|
|
include_directories(${BoostCompute_INCLUDE_DIRS})
|
|
]
|
|
|
|
Ensure you also find and setup the OpenCL libraries for your system.
|
|
|
|
[endsect] [/ installation]
|
|
|
|
[section Support]
|
|
|
|
Bugs and issues can be reported to the
|
|
[@https://github.com/kylelutz/compute/issues?state=open issue tracker].
|
|
|
|
There is also a mailing list for users and developers at
|
|
[@https://groups.google.com/forum/#!forum/boost-compute].
|
|
|
|
Look through the [link boost_compute.faq FAQ] to see if you're encountering a
|
|
known or common issue.
|
|
|
|
[endsect] [/ support]
|
|
|
|
[endsect]
|