Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Fast computer vision library written entirely in Java.

branch: master
README.TXT
========== Introduction =====================

BoofCV is an open source computer vision library written entirely in Java by Peter Abeles.  It is released under the Apache License 2.0.  Source code, examples, and other utilties are included in this package.  This document contains only a brief summary of the directory structure and how to build the source code.  For more detailed and update information please visible the webpage below.

Project Webpage: http://boofcv.org
Message Board:   https://groups.google.com/group/boofcv
Bug Reports:     https://github.com/lessthanoptimal/BoofCV/issues
Repository:      https://github.com/lessthanoptimal/BoofCV

========== New to Java? =====================

If you are new to Java, then using BoofCV will be a challenge.  With just a little bit of knowledge it is possible to build and run examples using the instructions below.  Integrating BoofCV into your own project is another issue.  If you don't know what a jar file is or how to import classes, it is highly recommend that you learn the basics first before attempting to use BoofCV.

========== Directories ======================

applet/        Contains source code for Java applets which demonstrate BoofCV's capabilities.
data/          Directory containing optional data used by applets and examples.
evaluation/    Code that is used to debug and evaluate BoofCV's performance.
examples/      Set of example code designed to be easy to read and understand.
integration/   Contains code which allows BoofCV to be easily integrated with 3rd party libraries.  Primary for video input/output.
lib/           Set of 3rd party libraries that BoofCV is dependent on.
main/          Contains the source code for BoofCV

========== Building =========================

BoofCV is a java library and can be compiled on any platform with Java installed.  OutFor your convinience Ant and Maven build scripts have been provided.  These ant scripts can be used to build and run example code.

BEFORE trying to compile BoofCV make sure you have the following installed and that the paths are setup correctly:

- Java Developers Kit (JDK) version 1.6 or later
      http://www.oracle.com/technetwork/java/index.html
- Ant  (Optional)
      http://ant.apache.org/
- Maven (Optional)
      http://maven.apache.org/

BoofCV is in general very easy to build on just about any system.  Because it is Java you don't have any of the annoying system dependent or compiler issues that are the source of endless headaches.


== STABLE BUILD ANT:

If you are using a stable build the latest jars of its dependencies are provided for you and can be easily
compiled using Ant:

---- BEGIN TEXT-----
cd main
ant
----- END TEXT -----

After the last command has finished you can find BoofCV.jar in the lib/ directory.  It is also possible to create JavaDoc by typing "ant javadoc".  Next if you wish to compile and run the example code, move into the example/ directory and following the readme.txt instructions you find there.  Code inside integration directory can be easily compiled using the same command.

== STABLE BUILD MAVEN:

---- BEGIN TEXT-----
cd main
mvn package
----- END TEXT -----

== DEVELOPMENTAL BUILD ANT:

So you checked out the latest Git code for BoofCV.  Chances are ant won't work because the jars it depends on are out of date.  You will need check out the source code of all its dependencies and then build them.

------ BEGIN TEXT -----
git clone git://github.com/lessthanoptimal/BoofCV.git boofcv
cd boofcv
git submodule init
git submodule update
cd ..
git clone git://github.com/lessthanoptimal/GeoRegression.git georegression
git clone git://github.com/lessthanoptimal/ddogleg.git ddogleg
mkdir -p ejml/trunk
svn checkout https://efficient-java-matrix-library.googlecode.com/svn/trunk/ ejml/trunk
------ END TEXT -------

Next you must build and copy jars.

------ BEGIN TEXT -----
cd ejml/trunk/
ant
cp build/jar/EJML.jar ../../ddogleg/lib/
cp build/jar/EJML.jar ../../georegression/lib/
cp build/jar/EJML.jar ../../boofcv/lib/
cd ../../ddogleg/
ant
cp build/jar/DDogleg.jar ../georegression/lib/
cp build/jar/DDogleg.jar ../boofcv/lib/
cd ../georegression/
ant
cp build/jar/GeoRegression.jar ../boofcv/lib/
cd ../boofcv/main/
ant
------ END TEXT -------

========= Dependencies =======================

BoofCV depends on a few other packages and if you are getting lot of errors when compiling your source code you probably forgot to include them.  All libraries that BoofCV depends can be found in the lib/ directory.

EJML.jar             http://code.google.com/p/efficient-java-matrix-library
GeoRegression.jar    http://georegression.org
DDogleg.jar          http://ddogleg.org

The following are required for running unit tests and micro-benchmarks:

JUnit                http://junit.sourceforge.net/
Caliper              http://code.google.com/p/caliper/

========= Developing With BoofCV =============

BoofCV has been written to be used with an integrated development evironment (IDE) and access to the source code.  IntelliJ and Eclipse are two excellent IDEs for Java.  With IntelliJ being my personally preference.  After you learn the basics of BoofCV it is possible to highly customize the code and discard abstractions that make programming easier, but less efficient.  The best way to write highly optimized code is to start by looking at the factory containing the code you wish to use, then tracing through the algorithms it invokes.  The code is designed to be readable and documentation actually improves inside of low level algorithms. 

========= Contact ===========================

For questions or comments about BoofCV please use the message board.  Only post a bug report after doing some due diligence to make sure it is really a bug and that it has not already been reported.

Message Board        http://groups.google.com/group/boofcv
Something went wrong with that request. Please try again.