Putting - springbok/MLM2PRO-GSPro-Connector GitHub Wiki
There are two putting option's available, you can use the connector without any putting as it is optional:
- Webcam putting system.
- ExPutt putting simulator.
To select the putting option you would like to use and configure the settings you select the toolbar button.
Webcam Putting System
For a video on how to setup Webcam putting with the connector you can go here
Please Note: The 'ball-tracking' application is included when you download and install the files for this connector.
Camera ID: The index of the video camera, set to 0 by default. If you are unsure you can use the 'Find Video Sources' button, this is slow and a little klunky but it might help you identify the index number.
Ball Color: Select the ball color you will be using from the list of colors.
Auto Start Ball Tracking App: When set to 'Yes' the connector will try and start the ball tracking app automatically when the putting service is started.
Ball Tracking App Params: The ball tracking app accepts a number of parameters when it starts, add any params here that you would like to send to the ball tracking app.
Ball Tracking App Window Title: You can leave this value as is, if the ball tracking app window title is ever changed then this value can be updated.
If you have used the ball tracking app with another connector you can copy/paste the config.ini file to enable you to use the same settings with this connector
ExPutt Putting
For more details on the ExPutt putting simulator you can go here
For a video on how to setup the Exputt with the connector you can go here
Exputt needs to be configured to use Yards or Feet, i.e. Imperial, not metric.
Auto start Camera App: When set to 'Yes' the connector will try and start the Camera app automatically when the putting service is started.
Camera App Window Title: You can leave this value as is, if you are using a different language the app may have a different title, enter the correct name here.
ROI's
The connector uses screenshots of the Camera app to extract, process and send putting metrics to GSPro, so you need to specify the region of interest for each metric.
All the ROI's will be located in the top left corner, there is one for each metric, each ROI has a label with the metric name.
Specify ROI's
Select and drag the ROI with the mouse to the appropriate metric and resize as desired. For improved accuracy it's important to take care to specify the correct region for each metric.
For best results make the rectangle as big as you can without including any of the labels
Verify ROI's
You can press the 'Verify' button to verify that your selections produce a good result.
Save ROI's
Once you are happy with your selections make sure to press the 'Save' button to save your settings.
Errors
If you do get errors when taking a putt the system will highlight the metric with the issue in red, you can also check the 'Log' tab to see the error messages.
Usually errors are caused by bordeline ROI's, so try and adjust the ROI for the metric that has the error and this will usually resolve the error.
Start Putting Service
Once you have selected the putting service and updated any settings you can start the putting service by pressing the 'Start' button.