If you have robotpy-installer on your computer, then installing robotpy-cscore is very simple:
# While connected to the internet
robotpy-installer download-opkg python37-robotpy-cscore
# While connected to the network with a RoboRIO on it
robotpy-installer install-opkg python37-robotpy-cscoreFor additional details about running robotpy-installer on your computer, see the robotpy-installer documentation <install_packages>.
If you're not installing on a RoboRIO, then installation of cscore has a few additional steps that you need to do:
Install a newer C++ compiler that supports C++14
Note
robotpy-cscore has not been tested on Windows
- Install Python 3 (cscore is not supported on Python 2) and development headers
- Ensure that you have a recent version of pip3/setuptools installed (either via pip3 or using a Linux package manager)
- It has been reported that build failures may occur with certain combinations of pip/setuptools installed
- Install Numpy (either via pip3 or using a Linux package manager)
- Install OpenCV (either via a Linux package manager or compile from source)
- If you compile from source, you must enable shared library support, cscore cannot use a statically compiled OpenCV python module at this time
- Install robotpy-cscore via pip3. It should be as easy as running
pip3 install --no-build-isolation robotpy-cscore-- though be warned, it takes several minutes to compile!
In the future we may provide binaries that can be installed on commonly used platforms, but there are a number of technical challenges that need to be solved and so that won't be until at least 2018 if not later.
Warning
Currently, robotpy-cscore does not support using the OpenCV module that comes with the opencv-python package distributed on Pypi. Long term, I'd like to get that to work, but it's going to take a bit of work. To track this issue, see opencv/opencv-python#22
See our cscore documentation <vision> for examples and deployment thoughts.