FAQ

If you do not find answers to your questions in the list below, please do not hesitate to send a message to the appropriate mailing list:

Are you really trying to parse C++? That sounds insane.

Unlike other tools such as SWIG or BridJ, we are not attempting to support C++ per se, but merely the subset required to access the API of libraries from the header files, and only what is actually used in the wild by actual C++ libraries. However, until now, no attempt has been made to try and understand what that subset might be, or how it could be mapped to Java. Our approach consists in developing JavaCPP as prototype, adapting it as appropriate for as many C++ libraries as possible, finding new tricks to map most naturally the required features of C++ to Java along the way, and hopefully end up one day with a clearer understanding of what we need to map and how. Our approach has not failed (yet). This is what differentiates us from past (failed, in our opinion) attempts. So, technically the answer to the question is “no”: We are trying to support the parts of C++ as used in existing header files that are useful to access native libraries, not the whole of C++.

How does it differ from wrappers in OpenCV, etc.?

JavaCPP was designed for maximum performance and flexibility. It strives to map as much of C++ as the Java language can reasonably handle, offering a level of usability to native functionality unmatched by any other solutions that we are aware of. It also provides a common foundation, a set of basic classes, to increase the interoperability between different native libraries on the Java platform. Plus, its integration with standard tools such as Maven facilitates development and deployment.

Is the license business friendly?

Yes, the core of the software is licensed under the Apache License, Version 2.0, or the GPLv2 with Classpath exception: you are free to choose. The latter is similar in spirit to the LGPL, but with less restrictions, so either way you can use it within your own commercial products without having to pay any royalties. The reason behind this choice was due to their better affinity with Android and the industry in general when compared to LGPL, and because Sun Microsystems provided a precedent by licensing software such as the OpenJDK and NetBeans in the same way leaving the final choice with the user. Still, we expect people to contribute back changes when they are related directly to the original code, such as bug fixes, but nothing more. Enjoy!

What is available in the Maven Central Repository?

Take a look at the JavaCPP Presets 1.0 for OpenCV 3.0: Browse Central For org.bytedeco.javacpp-presets : opencv : 3.0.0-1.0. The gist of it is all there - Linux, Mac OS X, Windows, Android. x86, x86_64, and ARM permutations too. Naturally, the artifacts are quite big, but we hope they are ready to go for many. We uploaded that for the benefit of all, but it is also possible that you have a version of, say, Linux that’s more specialized than we’ve targeted here - in which case you might want to build the presets yourself for your own Maven repo.

What is on your to-do list?

What about thread safety and reentrant aspects of the presets?

At this stage, we are not able to guarantee that presets will function as you would hope in a multithreaded way. We’re also unable to state that presets are perfectly reentrant. It would be great to set up test harnesses, to somehow indicate (if not prove) that usage characteristics are what we expect, but we’re somewhat overstretched as it is.

Do you offer commercial support?

Not officially yet, but if you have a need, please do not hesitate to contact us.