Applications

Installing

All the desktop applications below are Java applications. Once you have Java installed its easy launch them from the command line. Launching them like a regular desktop application will come in a future and requires wrapping the Java application. Let us know if you want to help with that!

The easiest way to get the applications is to download them, but you can also build them from source code.

Downloading Jars (Easiest Way):

• Examples and Demonstrations
• Applications

Building from BoofCV's Source Code:

cd boofcv
./gradlew examples
java -jar examples/examples.jar
./gradlew demonstrations
java -jar demonstrations/demonstrations.jar

Java

If you don't have Java installed on your system you will need to do that. The code has been tested on Java 8 and 11. We recommend that you install Java 11 because of a Mac OS X bug that exists in some versions of Java 8 that causes the 3D point cloud viewer to glitch.

• Download JRE 8 from Oracle
• Download JRE 11 from Azul

Windows

Because the application hasn't been blessed by Microsoft you will need to go through additional steps

1. Double click on the BoofDemonstrations.zip you just downloaded
2. Drag the BoofDemonstrations folder to your Desktop
3. Open BoofDemonstrations
4. Double click on BoofDemonstrations/demonstrations.bat
5. If a dialog open complaining about the the application being untrusted
   • Click "More Info"
   • Tell it to run

Mac OS X

There's currently no easy way to launch a jar in Mac OS X any more that I'm away of so you will need to use the command line to launch it. In older versions of OS X you could just double click the jar.

1. Double click BoofDemonstrations.zip and it should automatically decompress
2. Open Terminal.app

cd Downloads/BoofDemonstrations
java -jar demonstrations.jar

Linux

1. Unzip the BoofDemonstrations.zip
2. Open a terminal
3. Launch the Jar

cd BoofDemonstrations
java -jar demonstrations.jar

Utilities and Applications

Download Applications

BoofCV comes with several utilities and general applications for assisting with computer vision. For example, you can print a calibration target, create a custom AR marker, undistort a large number of images, create QR Codes, and calibrate your camera.

Everyone one of these application can be run from the command line. They were originally command line applications and the command line interface has a few features which haven't been integrated into the GUI yet.

Create QR Code

Let's you create a QR code and control every setting. These QR Codes are also fully standards compliant. A surprising number of QR Code generates found online generate invalid QR Codes that can't be read by every scanner.

Create Calibration Fiducials

Used to create many different types of calibration patterns. See calibration tutorial for more details.

Create Square Binary

Print out one or more square binary fiducials on a page.

Create Square Image

Print out one or more square image fiducials on a page.

Camera Calibration

Calibrate live from a webcam or already collected images. Provides several useful tools to inspects the results.

Batch Downsize

Down samples images in batch mode. The down sampling technique used here is better than most other applications which use bilinear interpolation. This application averages the entire local region, resulting in less aliasing and other artifacts.

Batch Undistort

Remove lens distortion from a calibrated camera in match mode.

Examples and Demonstrations

Download Examples and Demonstrations

This application allows you to run every example and demonstration, view its source code in the application, or open it up on Github. A jar is provided which will launch a GUI. You can select examples or demonstrations. Examples is easy to understand code while Demonstrations focuses more on visualization. YouTube Video of an earlier version

After that selection has been made another window opens. You can select the specific example you wish to run on the left by expanding the category and double clicking on the example's name. If you right click on a name a sub-menu appears which lets you copy the example's name, path, or open it up on Github. After launching an example a tab will open on the right. A menu is shown which lets you view the standard output from the application or view its source code.