FreeD4j is a Java library for parsing and receiving Free-D camera tracking data. It is currently work in progress.
Free-D is an old, but widely-used protocol for exchanging live camera tracking data. You can find more information here, but please let me know if you find any more resources! They seem to be few and far between.
- Java 17
- Add the following Maven repository to your project:
https://mvn.spnr.dev/releases - Add the dependency:
implementation("dev.spnr:freed4j:VERSION")(where "VERSION" is the latest version, you'll find that inbuild.gradle.ktshere)
For now, it is up to you to create a UDP server. This is planned to change very soon.
When you have a payload to parse, simply use the FreeD4j#readMessage method like so:
byte[] payload;
// ...
Message message = FreeD4j.readMessage(payload); // Parse the data
switch (message) { // If you're using Java 21, you can use the new pattern switching!
case PositionMessage positionMessage -> {
int camera = positionMessage.camera();
int x = positionMessage.metricPosition().x();
int y = positionMessage.metricPosition().y();
int z = positionMessage.metricPosition().z();
}
}
// ...- By default,
PositionMessagekeeps the raw values sent. Use.metricPosition()to convert the values into metric.
- https://github.com/stvmyr/freeD - A simple freeD tracking protocol implementation written in golang
- https://github.com/ssav7912/rust-FreeD - Library of types for use with the free-d Protocol