chameleon-vision

OTHER License

Stars
37
Committers
7

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

  1. Import the project as a Maven project
  1. Under JDK for importer choose the JDK 12 you downloaded earlier
  2. Maven will automatically download the necessary dependencies
  3. 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

License

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