Difference between revisions of "Manual"

From BoofCV
Jump to navigationJump to search
m
(Re-organized this page for clarity)
Line 1: Line 1:
Welcome to BoofCV!  The following manual provides an introduction to development with BoofCV.  It is assumed that the reader is familiar with development in the Java programming language and the basics of computer vision. This manual primarily takes the form of example code and tutorials.
Welcome to BoofCV! BoofCV is an open source Java computer vision library intended for developers by developers. The following manual provides an introduction to development with BoofCV.  It is assumed that the reader is familiar with development in the Java programming language and the basics of computer vision. This manual primarily takes the form of example code and tutorials.


= Support =
= Getting Started =


Support is provided in the form of the documentation on this website and through its message board.  See the left navigation board for a link to the message board.  Please read through the documentation and FAQ (see below) first before posting a question there.  You are much more likely to get a good responce if you demonstrate due dilligence.
Before you can do anything with BoofCV you will need to download it.  The [[Download:BoofCV|download]] page provides instructions on how to download pre-compiled jars, source code, add a Maven dependency, and checkout the latest source code. After you obtain the jar files browse through the examples below to get ideas on how you can use BoofCV.
 
== Build ==
 
If you are compiling BoofCV from source code Ant and Maven scripts are provided.  You can also build it inside your favorite IDE, but will need to configure it yourself.
 
Ant and Maven build instructions:
 
# Download or checkout source code.
# To run either script from the command-line, switch to the boofcv/main directory.
# Then type "ant" or "mvn package"
# Copy the compiled jar file to an appropriate location
#* Location Ant: boofcv/lib/BoofCV.jar.
#* Location Maven: boofcv/main/target/boofcv-XX.jar
 
Ant build scripts are also provided in boofcv/integration and boofcv/examples.
 
== Support ==
 
Support is provided in the form of the documentation on this website and through its message board.  See the left navigation board for a link to the message board.  Please read through the documentation and FAQ (see below) first before posting a question there.  You are much more likely to get a good response if you demonstrate due diligence.


http://boofcv.org/index.php?title=FAQ
http://boofcv.org/index.php?title=FAQ
Line 9: Line 28:
If you find any mistakes in the documentation or library itself please submit a bug report or post a message about it!  If you don't let us know about it we can't fix it.
If you find any mistakes in the documentation or library itself please submit a bug report or post a message about it!  If you don't let us know about it we can't fix it.


= Propaganda =
== Propaganda ==


Did you find BoofCV useful and use it on your project/work/research/thesis?  Well let others know about it through your blog, twitter, or status message!  Academics, please cite BoofCV in your papers and checkout the papers page to see if the specific algorithm you are using is mentioned there.
Did you find BoofCV useful and use it on your project/work/research/thesis?  Well let others know about it through your blog, twitter, or status message!  Academics, please cite BoofCV in your papers and checkout the papers page to see if the specific algorithm you are using is mentioned there.
Line 63: Line 82:


* [[List of Applets]]
* [[List of Applets]]
= Building BoofCV =
The easiest way to build the library from source is using the provided Ant or Maven scripts.
# Download source code. See the [[Main Page]] for where to download it from.
# To run either script from the command-line, switch to the boofcv/main directory.
# Then type "ant" or "mvn package"
# Copy the compiled jar file to an appropriate location
#* Location Ant: boofcv/lib/BoofCV.jar.
#* Location Maven: boofcv/main/target/boofcv-XX.jar
In Linux building with Ant looks something like this:
<pre>
$ cd boofcv/main/
$ ant
---- lots of text -----
    [javac] Note: Some input files use unchecked or unsafe operations.
    [javac] Note: Recompile with -Xlint:unchecked for details.
    [javac] 15 warnings
jar:
      [jar] Building jar: /home/pja/projects/boofcv/main/jar/BoofCV_IO.jar
main:
      [jar] Building jar: /home/pja/projects/boofcv/lib/BoofCV.jar
main:
BUILD SUCCESSFUL
Total time: 7 seconds
</pre>

Revision as of 06:00, 28 December 2012

Welcome to BoofCV! BoofCV is an open source Java computer vision library intended for developers by developers. The following manual provides an introduction to development with BoofCV. It is assumed that the reader is familiar with development in the Java programming language and the basics of computer vision. This manual primarily takes the form of example code and tutorials.

Getting Started

Before you can do anything with BoofCV you will need to download it. The download page provides instructions on how to download pre-compiled jars, source code, add a Maven dependency, and checkout the latest source code. After you obtain the jar files browse through the examples below to get ideas on how you can use BoofCV.

Build

If you are compiling BoofCV from source code Ant and Maven scripts are provided. You can also build it inside your favorite IDE, but will need to configure it yourself.

Ant and Maven build instructions:

  1. Download or checkout source code.
  2. To run either script from the command-line, switch to the boofcv/main directory.
  3. Then type "ant" or "mvn package"
  4. Copy the compiled jar file to an appropriate location
    • Location Ant: boofcv/lib/BoofCV.jar.
    • Location Maven: boofcv/main/target/boofcv-XX.jar

Ant build scripts are also provided in boofcv/integration and boofcv/examples.

Support

Support is provided in the form of the documentation on this website and through its message board. See the left navigation board for a link to the message board. Please read through the documentation and FAQ (see below) first before posting a question there. You are much more likely to get a good response if you demonstrate due diligence.

http://boofcv.org/index.php?title=FAQ

If you find any mistakes in the documentation or library itself please submit a bug report or post a message about it! If you don't let us know about it we can't fix it.

Propaganda

Did you find BoofCV useful and use it on your project/work/research/thesis? Well let others know about it through your blog, twitter, or status message! Academics, please cite BoofCV in your papers and checkout the papers page to see if the specific algorithm you are using is mentioned there.

BoofCV Papers and Tech Report

Examples and Tutorial

A few tutorials and examples are provided to provide the basic concepts of development with BoofCV. Data files used in these examples are stored in a separate GIT repository from the main code. See boofcv/examples/readme.txt or https://github.com/lessthanoptimal/BoofCV-Data

Tutorials:

  1. Quick Start
  2. Images in BoofCV
  3. Videos and Webcams
  4. Android Support
  5. Camera Calibration
  6. 3D Computer Vision

Example Code:


Other resources: