Android support

BoofCV will work without modification on Android systems, however to call image processing routines you will need to convert Bitmap into BoofCV image types. Converting image using pixel RGB values is extremely slow, instead use the optimized conversion routines. These routines are provided as an optional add-on in the integration directory. These routines have been tested on Android 2.3.3 API and will most likely work on even earlier versions.

• ConvertBitmap JavaDoc
• Android support provided in BoofCVAndroid.jar
  • Use the pre-compiled jars or see below for compiling it yourself.

Example:

    	// Easiest way to convert a Bitmap into a BoofCV type
    	ImageUInt8 image = ConvertBitmap.bitmapToGray(bitmap, (ImageUInt8)null, null);
	
    	// If you are converting a sequence of images it is faster reuse a
    	// previously declare image and buffer
    	byte[] workBuffer = ConvertBitmap.declareStorage(bitmap, null);
    	ConvertBitmap.bitmapToGray(bitmap, image, workBuffer);
    	
    	// Convert back into a Bitmap
    	ConvertBitmap.grayToBitmap(image, bitmap, workBuffer);

    	// another less efficient way
    	bitmap = ConvertBitmap.grayToBitmap(image, Bitmap.Config.ARGB_8888);
    	
    	// Functions are also provided for multi-spectral images
    	MultiSpectral<ImageFloat32> color = ConvertBitmap.bitmapToMS(bitmap, null, ImageFloat32.class, null);

Diagnostic App

A free diagnostic Android app is available in the Google Play store. The app will run a series of benchmarks and can be used to visually inspect the correctness of conversion routines. To help BoofCV development please submit the results. See the wiki link for more information on the benchmark app.

• Benchmark App Wiki
• Benchmark in Play Store

Compiling

Source code for Android integration can be found in the 'boofcv/integration/android' directory. An ant script is provided for compiling the jar file, but needs to be modified so that it points towards your Android API installation. A pre-compiled jar is provided at the usual download location.

Problems?

• If you try to compile BoofCV in an Android you will get errors due to the swing code. The solution to this problem is to not compile it inside the Android app and instead just link to its jars.
• Compiler can't find ConvertBitmap? Make sure BoofCVAndroid.jar is included in your project.