Difference between revisions of "Download"

From BoofCV
Jump to navigationJump to search
m
Line 39: Line 39:
= Bleeding Edge =  
= Bleeding Edge =  


BoofCV is being developed in parallel with several other librariesIf you plan on using the latest source code you will need to check out all of their repositories too.
The absolutely latest code is available on GithubThis code should be considered developmental, but effort is made to have it always compileTo check it out do the following.
 
* [https://github.com/lessthanoptimal/GeoRegression GeoRegression]
* [http://ddogleg.org/ DDogleg]
* [http://code.google.com/p/efficient-java-matrix-library/ EJML]
 
Below is a commandline sequence for checking all of those libraries and BoofCV.  It also shows you how to place everything in the correct location relative to each otherThis is helpful if you plan on using the provided IntelliJ files.


<pre>
<pre>
git clone git://github.com/lessthanoptimal/BoofCV.git boofcv
https://github.com/lessthanoptimal/BoofCV.git boofcv
cd boofcv
cd boofcv
git submodule init
https://github.com/lessthanoptimal/BoofCV-Data.git data
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
</pre>
</pre>


Just after BoofCV is checked out it sets up a submodule for the data.  The submodule contains data files used in the example code.
Then Gradle can be used to build the project as is usual.
 
The easiest way to build everything is with an IDE.  Configuration files are provided for IntelliJ.  If you wish to build using ant then you will need to build each library individually in a specific order and copy the jars around.  Since this is a pain, using an IDE is recommended or writing a script.
<pre>
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
</pre>


= Past Releases =
= Past Releases =

Revision as of 07:54, 11 June 2014

BoofCV is available from its central repository at Github or through periodic releases. Below are links to the latest stable release hosted on SourceForge.

Latest Stable Release:

If you encounter any problems getting BoofCV up and running, please let us know! A bug might have slipped through testing or if the instructions are not clear we would like to know.

Android users, if these jars give you trouble it's probably because they were compiled with JDK 7. See the Android support page for a work around.

Maven

BoofCV is on Maven central repository. A dependency is needed for each module that you used. The modules available are calibration, feature, geo, io, ip, recognition, sfm, visualize, and xuggler. To do anything useful you will need at a minimum io, ip. See below for an example dependency list:

<dependency>
  <groupId>org.boofcv</groupId>
  <artifactId>io</artifactId>
  <version>0.16</version>
</dependency>

<dependency>
  <groupId>org.boofcv</groupId>
  <artifactId>ip</artifactId>
  <version>0.16</version>
</dependency>

<dependency>
  <groupId>org.boofcv</groupId>
  <artifactId>visualize</artifactId>
  <version>0.16</version>
</dependency>

Where MODULE is one of the modules listed.

Bleeding Edge

The absolutely latest code is available on Github. This code should be considered developmental, but effort is made to have it always compile. To check it out do the following.

https://github.com/lessthanoptimal/BoofCV.git boofcv
cd boofcv
https://github.com/lessthanoptimal/BoofCV-Data.git data

Then Gradle can be used to build the project as is usual.

Past Releases

Version Link Description
Alpha v0.16 Link Object tracking, FFT, color SURF
Alpha v0.15 Link Kinect, visual odometry, ground plane, bugs
Alpha v0.14 Link Improved 2D image processing
Alpha v0.13 Link Feature API changes, VO, many changes
Alpha v0.12 Link SIFT, combined tracker, API changes
Alpha v0.11 Link Stereo Visual Odometry, trifocal tensor
Alpha v0.10 Link 5-pt Essential, Template, Improved performance/API.
Alpha v0.9 Link Android and Xuggler support, Refactorings
Alpha v0.8 Link Stereo disparity, tweaked calibration
Alpha v0.7 Link Stereo calibration, rectification, improved API
Alpha v0.6 Link Camera calibration, 3D Vision, Performance, and more
Alpha v0.5 Link Improvements to SURF and non-linear optimization
Alpha v0.4 Link Fixed bugs in SURF and MultiSpectral images
Alpha v0.3 Link More color and camera calibration support
Alpha v0.2 Link API improvements and geometric vision
Alpha v0.1 Link First formal publish release