jportaudio.dox 2.2 KB
Newer Older
1 2 3 4 5 6 7 8
/** 
@page java_binding JPortAudio Java Binding
@ingroup jportaudio

<i>Note: this page has not been reviewed, and may contain errors.</i>

@section java_draft DRAFT - IN PROGRESS

9
9/4/12 JPortAudio is very new and should be considered an "alpha" release.
10 11
The building of JPortAudio will eventually be integrated into the Makefile as an optional build.

12 13 14 15 16
Currently JPortAudio is only supported for Windows and Macintosh. Please contact us if you want to help with porting Linux.

For reference documentation of the JPortAudio API see: com.portaudio.PortAudio

For an example see: PlaySine.java
17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40

@section java_comp_windows Building JPortAudio on Windows

Build the Java code using the Eclipse project in "jportaudio". Export as "jportaudio.jar".

If you modify the JNI API then you will need to regenerate the JNI .h files using:

@code
cd bindings/java/scripts
make_header.bat
@endcode

Build the JNI DLL using the Visual Studio 2010 solution in "java/c/build/vs2010/PortAudioJNI".

@section java_use_windows Using JPortAudio on Windows

Put the "jportaudio.jar" in the classpath for your application.
Place the following libraries where they can be found, typically in the same folder as your application.

- portaudio_x86.dll
- portaudio_x64.dll
- jportaudio_x86.dll
- jportaudio_x64.dll

41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65
@section java_comp_max Building JPortAudio on Mac

These are notes from building JPortAudio on a Mac with 10.6.8 and XCode 4.

I created a target of type 'C' library.

I added the regular PortAudio frameworks plus the JavaVM framework.

I modified com_portaudio_PortAudio.h and com_portaudio_BlockingStream.h so that jni.h could found.

@code
#if defined(__APPLE__)
#include <JavaVM/jni.h>
#else
#include <jni.h>
#endif
@endcode

This is bad because those header files are autogenerated and will be overwritten.
We need a better solution for this.

I had trouble finding the "libjportaudio.jnilib". So I added a Build Phase that copied the library to "/Users/phil/Library/Java/Extensions".

On the Mac we can create a universal library for both 32 and 64-bit JVMs. So in the JAR file I will open "jportaudio" on Apple. ON WIndows I will continue to open "jportaudio_x64" and "jportaudio_x86".
*/