Chameleon-Vision

Chameleon Vision is free open-source software for FRC teams to use for vision proccesing on their robots.

There instructions are for compiling (contributing) and running the source-code of the project. This is NOT intended for the co-processor setup or your testing PC. To run the program normally (from a build .jar file), take a look at our ReadTheDocs documentation for installation here

These instruction are for the Chameleon Vision's backend/server in Java

To run the UI's sourcecode (optional) see the UI's readme

Hardware

Currently any 64-Bit devices (Windows, Linux and Mac OS) are supported.
32 Bit devices are not supported.

At least one USB camera (supported one is recommended)

Development setup

Prerequisites

• Java Development Kit 12: Follow the correct instructions for your platform from BellSoft
• Chameleon-vision source code Clone via a git client or download as zip and extract the source code into a empty folder

For the co-processor(Linux system)

• Avahi Daemon: sudo apt-get install avahi-daemon avahi-discover avahi-utils libnss-mdns mdns-scan

For the driver station

• Bonjour Download and install Bonjour from here
• VC++ Redistributable (Windows only) Download and install this

Importing to IDEA

We recommend the use of Intellij Idea for running the source-code

1. Import Project

2. Choose the path to chameleon-server inside the copy of Chameleon-Vision that you cloned or downloaded

3. Import the project as a Maven project

4. Under JDK for importer choose the JDK 12 you downloaded earlier
5. Maven will automatically download the necessary dependencies
6. Run Main under src/main/java/com/chameleonvision/

Authors

• Sagi Frimer - initial work - websocket, settings manager, UI

• Ori Agranat - main coder - project manager, vision loop, UI, websocket, networktables

• Omer Zipory - developer - vision loop, websocket, networking, documentation, UI

• Banks Troutman - developer - vision loop, websocket, networking, project structue

• Matt Morley - developer - vision loop, project structue, documentation, solvePNP

Acknowledgments

• WPILib - Specifically cscore, CameraServer, NTCore, and OpenCV.

• Apache Commons - Specifically Commons Math, and Commons Lang

• Javalin

• JSON

• Google - Specifically Gson

License

Usage of Chameleon Vision must fall under all terms of Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International