This repository intentionally does not have any .gitignore files in order to include all project files, immediate files and binary files.
Get started by rooting your Android device and copying the APK of the NIStreamer (/Android/NIViewer). Using a development environment is recommended to launch testjni (/Windows/testjni). Detailed information about the architecture can be found in the paper:
Eberhardt, B. (2015). Distributed streaming and compression architecture for point clouds from mobile devices.
NiStreamer is the Android port of testjni.
The project NiStreamer is saved in the folder NiViewer. It can be compiled using Android Studio 1.3 RC3, JDK 1.7.0_79 and the Android API 22 Platform. The NDK header version is 1.6, but 1.4 and 1.6 is both supported, unlike NiViewer.Android, where only NDK 1.4 is supported.
The OpenNI2 libraries are contained and work on any armeabi-v7a compatible architecture. They are automatically bundled with the APK file and loaded when the first OpenNI2 device is used during execution. It will then also use root to fix permissions on the USB devices and automatically load the necessary device. All compression codecs are integrated into the source tree and compiled during the build process. The Hadoop package and the snappy codec is stripped by a couple of classes to ensure compatibility with the Android SDK.
A compiled APK file can be found in /Android/NiViewer/app/build/outputs/apk.
NIViewer is an application that provides all the streams of an attached sensor and lets the user inspect the raw, unprocessed depth images or different types of color maps. The user may choose between different streams and add or remove them as desired.
Additionally, sessions can be recorded in ONI files, resolutions and sensor types can be changed and distance can be measured. It is already an inherent part of the OpenNI2 framework and intended for testing purposes, shows depth images of a connected sensor and allows for simple measurements.
This is the Android port of the NiViewer. It uses root to fix permissions on the USB devices and automatically loads the necessary device on startup. It can not install the OpenNI2 drivers on the /system/lib/ folder, although System.LoadLibrary requires them to be there. It has a built-in server that allows other clients to connect and receive uncompressed frames. The NiStreamer is not compatible with the trasmission headers, and will not understand the incoming data. NiViewer is not multithreaded, but it supports viewing at multiple streams at the same time. The build script targets Android 4.4.4 and NDK Version 1.4, but this app should run on devices running Android 2.3 up to 5.1. Chances are, that the OpenNI2 libraries will not run on Android 5.0 or higher due to code changes in the clib in later Android versions.
A compiled APK file can be found in /Android/NiViewer.Android/out/production/NiViewer.Android.
Use this folder to recompile the OpenNI2 native libraries. Compiling has been tested on a Windows system, but it might also work on Linux. The initial code has been cloned from Occipital's Github develop branch on July 25th 2015.
- The build target was changed to Android-22
- The supported JNI versions now include 1.4 and 1.6
- clib patches in various files
- patches to the compile scripts and interfaces.
For an overview of all changes, using a "diff" tool is recommended.
testjni is the Windows port of NIStreamer. An older development version using 32-bit Windows libraries is found in the folder /Windows/testjni32, and supports a few older compression codecs, but lacks a few important features such as performance measurements.
The project testjni is saved in the folder testjni. It can be compiled using IntelliJ IDEA 14.1.4, JDK 1.8.0 (x64) and a few libraries listed below.
It contains two classes with a static Main method, the Loader and the Launcher. Loader uses a configuration file whereas Launcher opens a configuration window. The external libraries are to be found in the libs folder.
A compiled JAR file can be found in /Windows/testjni/out/artifacts/testjni_jar, but the Java executable requires many parameters to correctly load the JNI dependencies, so the use of a development environment to launch the application is preferred.
CharLS is a library that compresses images using Jpeg-LS lossless compression format. It supports up to 16 bit per color channel and also grayscale images. In comparison to JPEG 2000 it is claimed to be about 3 times faster.
This library uses a modified interface (interface.cpp and interface.h) that is used to connect to the Java Native Interface. It can be compiled using CodeBlocks and XMing_64, while care must be taken due to bugs regarding the JNI support and different versions of XMing.
This is the JBZip2 library.
This is the DLL file required to load CharLS on Windows x64 systems.
This is the hadoop common package.
This is a hardly obtainable package of the Java ImageIO extensions.
This is a copy of the redist folder from the OpenNI2 Windows x64 release.
This is a library required to load the dialogs from the Launcher and WindowSink.
TCPClient is a tool that displays raw frame transmissions from the modified NIViewer. It connects to the IP address and port and counts the incoming packets. It is not compatible to the NiStreamer.
Any assistance required? Ask me for help!