mirror of
https://github.com/PhotonVision/photonvision
synced 2026-06-20 00:51:41 +00:00
bb63af601d
We now need platform specific jars -- reworks actions to support that. Currently only generates 32 bit pi images.
79 lines
5.0 KiB
Markdown
79 lines
5.0 KiB
Markdown
# Photon Vision
|
|
|
|
[](https://github.com/PhotonVision/photonvision/actions?query=workflow%3ACI) [](https://codecov.io/gh/PhotonVision/photonvision) [](https://discord.gg/wYxTwym)
|
|
|
|
PhotonVision is the free, fast, and easy-to-use computer vision solution for the *FIRST* Robotics Competition. You can read an overview of our features [on our website](https://photonvision.org). You can find our comprehensive documentation [here](https://docs.photonvision.org).
|
|
|
|
A copy of the latest Raspberry Pi image is available [here](https://github.com/PhotonVision/photon-pi-gen/releases). A copy of the latest standalone JAR is available [here](https://github.com/PhotonVision/photonvision/releases). If you are a Gloworm user you can find the latest Gloworm image [here](https://github.com/gloworm-vision/pi-gen/releases).
|
|
|
|
If you are interested in contributing code or documentation to the project, please [read our getting started page for contributors](https://docs.photonvision.org/en/latest/docs/contributing/index.html) and **[join the Discord](https://discord.gg/wYxTwym) to introduce yourself!** We hope to provide a welcoming community to anyone who is interested in helping.
|
|
|
|
## Authors
|
|
|
|
<a href="https://github.com/PhotonVision/photonvision/graphs/contributors">
|
|
<img src="https://contrib.rocks/image?repo=PhotonVision/photonvision" />
|
|
</a>
|
|
|
|
## Gradle Arguments
|
|
|
|
Note that these are case sensitive!
|
|
|
|
* `-PArchOverride=foobar`: builds for a target system other than your current architecture. Valid overrides are winx32, winx64,
|
|
macx64, macarm64, linuxx64, linuxarm64, linuxarm32, and linuxathena.
|
|
- `-PtgtIp`: deploys (builds and copies the JAR) to the coprocessor at the specified IP
|
|
- `-Pprofile`: enables JVM profiling
|
|
|
|
## Building
|
|
|
|
Gradle is used for all C++ and Java code, and NPM is used for the web UI. Instructions to compile PhotonVision yourself can be found [in our docs](https://docs.photonvision.org/en/latest/docs/contributing/photonvision/build-instructions.html?highlight=npm%20install#compiling-instructions).
|
|
|
|
You can run one of the many built in examples straight from the command line, too! They contain a fully featured robot project, and some include simulation support. The projects can be found inside the `photonlib-java-examples` and `photonlib-cpp-examples` subdirectories, respectively. The projects currently available include:
|
|
|
|
- photonlib-java-examples:
|
|
- aimandrange:simulateJava
|
|
- aimattarget:simulateJava
|
|
- getinrange:simulateJava
|
|
- simaimandrange:simulateJava
|
|
- simposeest:simulateJava
|
|
- photonlib-cpp-examples:
|
|
- aimandrange:simulateNative
|
|
- getinrange:simulateNative
|
|
|
|
To run them, use the commands listed below. Photonlib must first be published to your local maven repository, then the `copyPhotonlib` task will copy the generated vendordep json file into each example. After that, the simulateJava/simulateNative task can be used like a normal robot project. Robot simulation with attached debugger is technically possible by using simulateExternalJava and modifying the launch script it exports, though unsupported.
|
|
|
|
```
|
|
~/photonvision$ ./gradlew publishToMavenLocal
|
|
|
|
~/photonvision$ cd photonlib-java-examples
|
|
~/photonvision/photonlib-java-examples$ ./gradlew copyPhotonlib
|
|
~/photonvision/photonlib-java-examples$ ./gradlew <example-name>:simulateJava
|
|
|
|
~/photonvision$ cd photonlib-cpp-examples
|
|
~/photonvision/photonlib-cpp-examples$ ./gradlew copyPhotonlib
|
|
~/photonvision/photonlib-cpp-examples$ ./gradlew <example-name>:simulateNative
|
|
```
|
|
|
|
|
|
## Acknowledgments
|
|
PhotonVision was forked from [Chameleon Vision](https://github.com/Chameleon-Vision/chameleon-vision/). Thank you to everyone who worked on the original project.
|
|
|
|
|
|
* [WPILib](https://github.com/wpilibsuite) - Specifically [cscore](https://github.com/wpilibsuite/allwpilib/tree/master/cscore), [CameraServer](https://github.com/wpilibsuite/allwpilib/tree/master/cameraserver), [NTCore](https://github.com/wpilibsuite/allwpilib/tree/master/ntcore), and [OpenCV](https://github.com/wpilibsuite/thirdparty-opencv).
|
|
|
|
* [Apache Commons](https://commons.apache.org/) - Specifically [Commons Math](https://commons.apache.org/proper/commons-math/), and [Commons Lang](https://commons.apache.org/proper/commons-lang/)
|
|
|
|
* [Javalin](https://javalin.io/)
|
|
|
|
* [JSON](https://json.org)
|
|
|
|
* [FasterXML](https://github.com/FasterXML) - Specifically [jackson](https://github.com/FasterXML/jackson)
|
|
|
|
## License
|
|
PhotonVision is licensed under the [GNU General Public License](https://www.gnu.org/licenses/gpl-3.0.html)
|
|
|
|
## Meeting Notes
|
|
Our meeting notes can be found in the wiki section of this repository.
|
|
|
|
* [2020 Meeting Notes](https://github.com/PhotonVision/photonvision/wiki/2020-Meeting-Notes)
|
|
* [2021 Meeting Notes](https://github.com/PhotonVision/photonvision/wiki/2021-Meeting-Notes)
|