Getting Started

cbdmaul edited this page Jan 6, 2018 · 16 revisions

Installation

Windows

Please see our installation video: ShootOFF Standalone Install Instructions

Note: You must have Java 8 installed with JavaFX. The easiest way to get all of the dependencies is to install Oracle's version of the JRE.

After downloading the Oracle JRE, download the zip file at our homepage, extract the zip to a convenient location, and run it locally by double clicking ShootOFF.jar.

OSX

Note: You must have Java 8 installed with JavaFX. The easiest way to get all of the dependencies is to install Oracle's version of the JRE.

After downloading the Oracle JRE, download the zip file at our homepage, extract the zip to a convenient location, and run it locally by double clicking ShootOFF.jar.

Linux (Automatic Ubuntu)

We thank dklickman for the following automation script for ShootOFF installation.

NOTE: Requires root. Inspect the script before running if you are uncomfortable with this.

wget https://raw.githubusercontent.com/dklickman/ShootOFF/57542125f74fc7e5865d3a0f38f36208bd7ba835/ShootOFFv4.sh ; chmod +x ShootOFFv4.sh ; sudo ./ShootOFFv4.sh

Linux (Other / Manual on Ubuntu)

The download is a zip file. In Ubuntu, right click the zip file and click "extract here". A ShootOFF directory will be created in the same directory. Enter it and double click "ShootOFF.jar".

You might have the wrong version of Java. If ShootOFF doesn't work after using the steps above, you need to follow this guide: https://www.digitalocean.com/community/tutorials/how-to-install-java-with-apt-get-on-ubuntu-16-04

There is also a missing preload on some installations of Ubuntu. Starting a terminal in the ShootOFF directory and typing this command will start ShootOFF:

export LD_PRELOAD=`find /usr/lib -name "v4l1compat.so"`; java -jar ShootOFF.jar

Preparing For Your First Training Session

To print your first target, enter the folder called "targets" in your ShootOFF directory. Select SimpleBullseye_score.png, open it, and print it using your printer.

Tape the printed target to your wall. Ensure the target is secured flat and level against the chosen wall. Point your webcam squarely at the target you taped to the wall. If the camera is not square with the paper target, shapes on the target may be distorted which can decrease the precision of shot detection on targets. You should also ensure that there are no bright sources of light in the path of the camera, as that can cause false readings.

Ensure your webcam is connected to your computer and functioning, then run ShootOFF, as described in the Installation instructions above. When you start ShootOFF for the first time you will get a popup asking you to ensure your gun is unloaded and allowing you to opt-out of automatic error reporting. This popup will only show once. When ShootOFF starts, you will see a feed from your webcam on ShootOFF's main window. Now is a good time to make additional adjustments to your webcam if necessary. For example, if shots are being detected even though you are not shooting, you may want to decrease the brightness settings on your camera, remove light sources from in front of the camera, or darken the room slightly. See Camera Setup Tips.

Adding Targets

See Adding-A-Virtual-Target for more information

On ShootOFF's menu bar, select "Targets" then "Add" and click "SimpleBullseye_score". This will add a virtual target to your webcam feed that matches the Simple Bullseye target you printed and attached to the wall. Click the virtual target and either use your mouse by clicking and dragging or the arrow keys on your keyboard to move the virtual target over the paper target on your webcam feed. You can resize the virtual target by moving your mouse to the edge of the target until the resize cursor appears and click and drag in the direction you wish to resize. Alternately, you may hold shift while hitting the arrow keys to resize targets. See Adding a Virtual Target for additional information.

Shooting

Turn on a training exercise appropriate for this target by selecting "Training" on the menu bar then "Shoot for Score". Now, shots that land on a region of the paper target that have a score will be precisely detected and the point value assigned the region will be added to your overall score. Your score will be displayed on the top left the webcam feed. You can clear all shot markers and reset the current training exercise by clicking the "Reset" button near the bottom of the ShootOFF window. This will reset your score to 0 when using Shoot for Score.

You are not obligated to use a paper target or even to turn on a training exercise. As soon as ShootOFF starts running, it will immediately start detecting shots and mark any shot that it detects on the webcam feed.

View a brief video ere

Click the preview above for a brief video tutorial on exercise settings