Applications

From BoofCV
Revision as of 17:13, 10 November 2018 by Peter (talk | contribs)
Jump to navigationJump to search


To run any of these examples you will need to have Java Runtime Environment (JRE) 1.8 or more recent installed. Java 11 is recommended.


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!

Rest of this section goes over OS specific instructions.

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.

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

Application Launcher
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.

Create QR Code

Create Calibration Fiducials

Create Square Binary

Create Square Image

Camera Calibration

Batch Downsize

Batch Undistort

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.

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.

Demonstration Launcher


YouTube Video of an earlier version