Skip to content

Home

Jump to bottom
biorobaw edited this page May 25, 2019 · 3 revisions

Welcome to the SSLVisionJavaClient wiki!

About

This software implements a java client for SSL-vision software (https://github.com/RoboCup-SSL/ssl-vision/wiki). The purpose of the project is to track robots in experiments, not to play in the ssl league. The current software only tracks robots, all other messages are ignored.

Installation instructions using maven:

   Add the following repository to your pom file:
         <repository>
	    <id>jitpack.io</id>
	    <url>https://jitpack.io</url>
	</repository>
  Add the following dependencies to your pom file (replace adequate version number):
        <dependency>
	    <groupId>com.github.biorobaw</groupId>
	    <artifactId>SSLVisionJavaClient</artifactId>
	    <version>v0.2.0</version>
        </dependency>

Usage

 The following functions must be called in the respective order:
   1. setOffset（）
         Optional function, synchronizes the clock with the ssl-vision server.
         Must be called before initListener()
         It assumes 
   2. initListener（）
         Creates a listener thread that listens to incoming ssl-packages and stores the result.
   3. Pair<SSL_DetectionRobot,Double> getDetection(String robotId)
         Returns the last SSL_DetectionRobot package received for the given robot id.
         Sample ids:  "r1", "r7" , "b2"
   4. closeListener()
         Closes the listener thread.
         Must be called at the end of the program.

TODO

Currently, getDetection returns unprocessed packages. Future editions may add filtering to the positions received by the camera and may combine measurements from multiple cameras. Currently this features are not provided.

Clone this wiki locally