abuuwais21 / aparapi-jni

A framework for executing native Java code on the GPU.

Licensed under the Apache Software License v2

This project simply loads the Aparapi Native library at runtime. This prevents the need for the user to install it manually.

There is usually no need for a user to call this library directly as it is called internally by Aparapi. However it may be useful if creating your own custom agent.

Currently packaged native libraries support Windows 64bit, Windows 32bit, Mac OSX 64bit, Linux 64bit, and Linux 32bit.

Support and Documentation

Aparapi JNI Javadocs: latest - 1.2.0 - 1.1.2 - 1.1.1 - 1.1.0 - 1.0.1 - 1.0.0

For detailed documentation see Aparapi.com or check out the latest Javadocs.

For support please use Gitter or the official Aparapi mailing list.

Please file bugs and feature requests on Github.

Related Projects

This particular repository only represents the core Java library. There are several other related repositories worth taking a look at.

• Aparapi - Core Aparapi java library.
• Aparapi Examples - A collection of Java examples to showcase the Aparapi library and help developers get started.
• Aparapi Native - The native library component. Without this the Java library can't talk to the graphics card. This is not a java project but rather a C/C++ project.
• Aparapi Archlinux AUR - An Archlinux AUR for installing the Aparapi JNI.
• Aparapi Archlinux Repository - A Archlinux binary repository containing all versions of the Aparapi JNI for easy installation.

Java Dependency

To include Aparapi in your project of choice include the following Maven dependency into your build.

<dependency>
    <groupId>com.aparapi</groupId>
    <artifactId>aparapi-jni</artifactId>
    <version>1.2.0</version>
</dependency>

Obtaining the Source

The official source repository for Aparapi is located in the Syncleus Github repository and can be cloned using the following command.

git clone https://github.com/Syncleus/aparapi-jni.git

Getting Started

Simply add the dependency above then call the load method, thats all there is to it.

try {
   NativeLoader.load();
   System.out.println("Aparapi JNI loaded successfully.");
}
catch (final IOException e) {
   System.out.println("Check your environment. Failed to load aparapi native library "
         + " or possibly failed to locate opencl native library (opencl.dll/opencl.so)."
         + " Ensure that OpenCL is in your PATH (windows) or in LD_LIBRARY_PATH (linux).");
}