Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Clone this wiki locally
Using the River Trail interactive shell
If you would like to get a feel for the programming model and experiment with the API without installing anything, take a look at our interactive River Trail shell. The shell runs in any current version of Firefox, Chrome, and Safari. However, the code you write in the shell will be executed sequentially using a library implementation and you won't see any speedup.
However if you are running Firefox and you have installed the River Trail browser extension for Firefox (see below on how), your code will run in parallel.
Getting River Trail
You need to install our Firefox extension to use our prototype compiler that enables execution of River Trail on parallel hardware. You can download a pre-built version compatible with Firefox 33+ for Windows, Mac OS X and Linux. (An archive of all versions of the extension can be found here.)
If you would like to build the extension yourself, we have written a README that explains the process.
It is possible to use River Trail with various OpenCL platforms and devices. In particular, it's possiblet to run River Trail applications on a supported GPU. Not all device kinds on all platforms are supported; once you have the extension and OpenCL installed, take a look at the extension's device selection settings to check whether your configuration is supported.
Once you have the extension installed and working, take a look at our demos:
- The aforementioned interactive shell.
- The sample applications in the examples directory. There are also live, hosted versions of these demos:
- A particle simulation demo, shown at the Intel Developer Forum in 2011.
- A Mandelbrot set visualization demo.
- A liquid image resizing demo first shown at Research@Intel Day 2011.
- Another particle simulation demo.
- A procedural map rendering demo.
- A game that uses River Trail for real-time video processing.
- A game that uses River Trail for collision detection.
For a first impression, you can watch this video, as well, or head over to InfoQ for an introductory talk recorded at Strange Loop 2012. For a interesting discussion of various problems we are trying to solve, you can view this interview, which discusses our approach and objectives.
A word of caution: River Trail is a prototype and the extension is not yet meant for use on the public web. Please uninstall or disable the extension when surfing the web and use it only for web pages you trust.
The API described in the wiki reflects what the River Trail prototype implements. Some design choices, such as, for instance, the use of extra arguments, are dictated by limitations of what our implementation approach (i.e., as a browser extension) allows.