To check out this repository please hg clone the following URL, or open the URL using EasyMercurial or your preferred Mercurial client.
The primary repository for this project is hosted at https://github.com/sonic-visualiser/sv-dependency-builds .
This repository is a read-only copy which is updated automatically every hour.
root / src / portaudio_20161030_catalina_patch / bindings / java / jportaudio.dox @ 164:9fa11135915a
History | View | Annotate | Download (2.13 KB)
| 1 |
/** |
|---|---|
| 2 |
@page java_binding JPortAudio Java Binding |
| 3 |
@ingroup jportaudio |
| 4 |
|
| 5 |
<i>Note: this page has not been reviewed, and may contain errors.</i> |
| 6 |
|
| 7 |
@section java_draft DRAFT - IN PROGRESS |
| 8 |
|
| 9 |
9/4/12 JPortAudio is very new and should be considered an "alpha" release. |
| 10 |
The building of JPortAudio will eventually be integrated into the Makefile as an optional build. |
| 11 |
|
| 12 |
Currently JPortAudio is only supported for Windows and Macintosh. Please contact us if you want to help with porting Linux. |
| 13 |
|
| 14 |
For reference documentation of the JPortAudio API see: com.portaudio.PortAudio |
| 15 |
|
| 16 |
For an example see: PlaySine.java |
| 17 |
|
| 18 |
@section java_comp_windows Building JPortAudio on Windows |
| 19 |
|
| 20 |
Build the Java code using the Eclipse project in "jportaudio". Export as "jportaudio.jar". |
| 21 |
|
| 22 |
If you modify the JNI API then you will need to regenerate the JNI .h files using: |
| 23 |
|
| 24 |
@code |
| 25 |
cd bindings/java/scripts |
| 26 |
make_header.bat |
| 27 |
@endcode |
| 28 |
|
| 29 |
Build the JNI DLL using the Visual Studio 2010 solution in "java/c/build/vs2010/PortAudioJNI". |
| 30 |
|
| 31 |
@section java_use_windows Using JPortAudio on Windows |
| 32 |
|
| 33 |
Put the "jportaudio.jar" in the classpath for your application. |
| 34 |
Place the following libraries where they can be found, typically in the same folder as your application. |
| 35 |
|
| 36 |
- portaudio_x86.dll |
| 37 |
- portaudio_x64.dll |
| 38 |
- jportaudio_x86.dll |
| 39 |
- jportaudio_x64.dll |
| 40 |
|
| 41 |
@section java_comp_max Building JPortAudio on Mac |
| 42 |
|
| 43 |
These are notes from building JPortAudio on a Mac with 10.6.8 and XCode 4. |
| 44 |
|
| 45 |
I created a target of type 'C' library. |
| 46 |
|
| 47 |
I added the regular PortAudio frameworks plus the JavaVM framework. |
| 48 |
|
| 49 |
I modified com_portaudio_PortAudio.h and com_portaudio_BlockingStream.h so that jni.h could found. |
| 50 |
|
| 51 |
@code |
| 52 |
#if defined(__APPLE__) |
| 53 |
#include <JavaVM/jni.h> |
| 54 |
#else |
| 55 |
#include <jni.h> |
| 56 |
#endif |
| 57 |
@endcode |
| 58 |
|
| 59 |
This is bad because those header files are autogenerated and will be overwritten. |
| 60 |
We need a better solution for this. |
| 61 |
|
| 62 |
I had trouble finding the "libjportaudio.jnilib". So I added a Build Phase that copied the library to "/Users/phil/Library/Java/Extensions". |
| 63 |
|
| 64 |
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". |
| 65 |
*/ |